Reasonix 入门教程：DeepSeek 编程 Agent 安装与配置 ​

适合人群：想用 DeepSeek 跑 AI 编程 Agent 的开发者 耗时：约 10 分钟 · 难度：初级

1. 什么是 Reasonix ​

Reasonix 是一个专为 DeepSeek 深度优化的开源终端 AI 编程 Agent。它的运行循环围绕 DeepSeek 的 prefix-cache 机制从零设计——重复发送的上下文可以在服务端缓存，从而大幅降低每次对话的成本。它的设计哲学只有一句话："A coding agent that stays cheap enough to leave on."（足够便宜，可以一直挂着跑的编程 Agent）。

简单说：它是一个跑在终端里的 AI 编程助手，特别适合长时间挂机处理批量编程任务，省心也省钱。

2. 前置条件 ​

• Node.js ≥ 22：Reasonix 基于 Node.js 运行，这是最核心的准备项。推荐从 Node.js 官网 下载并安装最新的 LTS（长期支持）版本。注意：Reasonix 的 npm 包要求 Node.js ≥ 22；DeepSeek 官方文档虽标注最低版本为 20.10，但建议以 ≥22 为准，兼容性最好。
• 系统支持：macOS、Linux、Windows（PowerShell、Git Bash、Windows Terminal）。
• 一个 DeepSeek API Key：按下一节步骤获取。

验证 Node 是否装好：在终端执行 node -v，能输出版本号（≥ 22）即可。

3. 准备 DeepSeek API Key ​

1. 访问 DeepSeek 开放平台 并注册登录
2. 导航至「API keys」页面，点击「创建新 API Key」
3. 重要提示：生成的 Key 只在创建时完整显示一次，请务必当场复制并妥善保存

4. 安装 Reasonix（CLI） ​

Reasonix 提供 CLI 和桌面版两种安装方式，本教程以 CLI 为例。桌面版请到官网下载：https://reasonix.io/

在命令行中执行全局安装命令：

npm i -g reasonix

5. 初始化配置 ​

安装成功后，运行以下命令，通过交互式向导完成初始化配置：设置 API Key、选择语言和主题。

reasonix setup

选择语言：

选择供应商：

输入 DeepSeek API Key：

回车保存：

6. 开始使用 ​

进入项目目录，输入以下命令启动 Reasonix：

reasonix

启动后，顶部会显示当前配置的模型，左下角还能看到 API 余额，方便随时掌握消费情况：

输入一个简单的问题做验证，比如：

简单介绍一下 你和 Claude Code 的区别

只要它能正常返回回答，就说明安装配置全部完成。底部会实时显示本次对话消耗的 token 数量和费用：

7. 常见问题（FAQ） ​

Q：执行 reasonix 提示「不是内部或外部命令 / command not found」？ A：说明全局安装失败或 PATH 未生效。先确认 npm i -g reasonix 无报错，然后重开一个终端窗口再试。

Q：API Key 填错了，怎么修改？ A：重新运行 reasonix setup，按向导重新输入即可覆盖旧配置。

Q：想换 DeepSeek 之外的模型供应商？ A：reasonix setup 的供应商选择步骤可以在初始化时切换。

Q：本地 Node 版本低于 22 能用吗？ A：不保证兼容。建议先升级到 Node ≥ 22 的 LTS 版本再安装。

Q：有没有桌面版？ A：有。官网 https://reasonix.io/ 提供桌面版，按官网指引安装即可。

8. 更新与卸载 ​

# 更新到最新版
npm update -g reasonix

# 卸载
npm uninstall -g reasonix

9. 下一步 ​

• 官方文档与下载地址：https://reasonix.io/
• DeepSeek 开放平台：https://platform.deepseek.com/
• 想深入了解与 Claude Code 等同类工具的区别，可以直接在 Reasonix 里提问，或查看官方说明