Reasonix 安装配置教程：DeepSeek 编程 Agent 入门指南

先看结论（快速开始） ：如果你已经有 Node.js ≥ 22 和 DeepSeek API Key，4 条命令就能跑起来------npm i -g reasonix → reasonix setup → reasonix。想每步都确认没走错，往下看完整教程。

1. 什么是 Reasonix

Reasonix 是专为 DeepSeek 深度优化的开源终端 AI 编程 Agent。

它和普通 AI 编程工具的一个核心区别，是运行循环围绕 DeepSeek 的 prefix-cache（前缀缓存）机制从零设计：

重复发送的上下文可以在服务端缓存；
缓存命中后，每次对话的 token 成本下降；
因此它特别适合长时间挂机处理批量编程任务。

Reasonix 的设计哲学只有一句话：

"A coding agent that stays cheap enough to leave on."（官方口号，大意：便宜到可以一直挂着跑）

简单说：它是一个跑在终端里的 AI 编程助手，围绕缓存机制减少重复上下文的开销，适合长时间挂机处理批量任务。

适合谁 ：用 DeepSeek 跑 AI 编程、需要低成本长时间跑批量任务的开发者。 不适合谁：只想偶尔问一句话的轻度用户------这类场景用更轻量的方式即可。

2. 前置条件

开始之前，确认你已经准备好：

Node.js ≥ 22 ：Reasonix 基于 Node.js 运行，npm 包要求 Node.js ≥ 22 。推荐从 Node.js 官网下载最新 LTS（长期支持）版本。
系统支持：macOS、Linux、Windows（PowerShell、Git Bash、Windows Terminal）。
一个 DeepSeek API Key：按下一节步骤获取。

验证点 ：在终端执行 node -v，能输出版本号（≥ 22）即说明 Node 装好了。

3. 准备 DeepSeek API Key

访问 DeepSeek 开放平台并注册登录
直接打开 API keys 页面：platform.deepseek.com/api_keys，点击「创建新 API Key」
重要提示：生成的 Key 只在创建时完整显示一次，请务必当场复制并妥善保存

4. 安装 Reasonix（CLI）

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

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

bash 复制代码

npm i -g reasonix

验证点 ：执行 reasonix --version，能输出版本号即安装成功。若提示 command not found，先重开一个终端窗口再试（PATH 未生效）。

5. 初始化配置

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

bash 复制代码

reasonix setup

选择语言：

选择供应商：

输入 DeepSeek API Key：

回车保存：

验证点 ：保存后界面不再提示配置缺失即可。Key 填错了也不用担心------随时重新运行 reasonix setup 覆盖。

6. 开始使用

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

bash 复制代码

reasonix

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

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

text 复制代码

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

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

验证点 ：能收到回答，且底部出现 token 消耗数字，即代表端到端跑通。退出：按 Ctrl + C 即可退出 Reasonix。

7. Reasonix 和 Claude Code 有什么不同

对比项	Reasonix	Claude Code
定位	专为 DeepSeek 深度优化的终端 AI 编程 Agent	Anthropic 官方终端编程 Agent
开源	开源	闭源
成本优化	围绕 DeepSeek prefix-cache 设计，重复上下文可缓存，适合长时间挂机运行	以官方定价为准
推荐场景	批量任务、长时间挂机运行	常规交互式编程
模型支持	可在 setup 中切换供应商，默认 DeepSeek	以官方支持为准

具体功能、定价差异请以 Reasonix 官方文档和各工具官方说明为准。也可以在 Reasonix 里直接提问，让它自己介绍。

8. 常见问题（FAQ）

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

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

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

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

Q：Reasonix 免费吗？ A：Reasonix 本身是开源工具，不收费。你需要自己提供 DeepSeek API Key，模型调用产生的费用由 DeepSeek 按量收取。

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

常见报错速查

现象	原因	解决办法
command not found	安装失败或 PATH 未生效	确认 npm i -g reasonix 无报错，重开终端再试
提示 Node 版本不兼容	Node 低于 22	升级到 Node 22+ 的 LTS 版本
一直提示需要 API Key	未配置或 Key 无效	重新运行 reasonix setup，粘贴完整 Key
对话无响应或网络超时	网络无法访问服务	检查网络连接与代理设置

9. 更新与卸载

bash 复制代码

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

# 卸载
npm uninstall -g reasonix

10. 下一步

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