夜雨聆风先看结论（快速开始）：如果你已经有 Node.js ≥ 22 和 DeepSeek API Key，4 条命令就能跑起来—— npm i -g reasonix→reasonix setup→reasonix。想每步都确认没走错，往下看完整教程。
什么是 Reasonix
Reasonix 是专为 DeepSeek 深度优化的开源终端 AI 编程 Agent。
它和普通 AI 编程工具的一个核心区别，是运行循环围绕 DeepSeek 的 prefix-cache（前缀缓存）机制从零设计：
重复发送的上下文可以在服务端缓存； 缓存命中后，每次对话的 token 成本下降； 因此它特别适合长时间挂机处理批量编程任务。
Reasonix 的设计哲学只有一句话：
"A coding agent that stays cheap enough to leave on."（官方口号，大意：便宜到可以一直挂着跑）
简单说：它是一个跑在终端里的 AI 编程助手，围绕缓存机制减少重复上下文的开销，适合长时间挂机处理批量任务。
适合谁：用 DeepSeek 跑 AI 编程、需要低成本长时间跑批量任务的开发者。
不适合谁：只想偶尔问一句话的轻度用户——这类场景用更轻量的方式即可。
前置条件
开始之前，确认你已经准备好：
- 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 装好了。
准备 DeepSeek API Key
访问 DeepSeek 开放平台 并注册登录 直接打开 API keys 页面：https://platform.deepseek.com/api_keys，点击「创建新 API Key」 - 重要提示
：生成的 Key 只在创建时完整显示一次，请务必当场复制并妥善保存
安装 Reasonix（CLI）
Reasonix 提供 CLI 和 桌面版 两种安装方式，本教程以 CLI 为例。桌面版请到官网下载：https://reasonix.io/
在命令行中执行全局安装命令：
npm i -g reasonix验证点：执行 reasonix --version，能输出版本号即安装成功。若提示command not found，先重开一个终端窗口再试（PATH 未生效）。
初始化配置
安装成功后，运行以下命令，通过交互式向导完成初始化配置：设置 API Key、选择语言和主题。
reasonix setup选择语言：
选择供应商：
输入 DeepSeek API Key：
回车保存：
验证点：保存后界面不再提示配置缺失即可。Key 填错了也不用担心——随时重新运行 reasonix setup覆盖。
开始使用
进入项目目录，输入以下命令启动 Reasonix：
reasonix启动后，顶部会显示当前配置的模型，左下角还能看到 API 余额，方便随时掌握消费情况：
输入一个简单的问题做验证，比如：
简单介绍一下 你和 Claude Code 的区别只要它能正常返回回答，就说明安装配置全部完成。底部会实时显示本次对话消耗的 token 数量和费用：
验证点：能收到回答，且底部出现 token 消耗数字，即代表端到端跑通。
退出：按Ctrl + C即可退出 Reasonix。
Reasonix 和 Claude Code 有什么不同
对比项 | Reasonix | Claude Code |
定位 | 专为 DeepSeek 深度优化的终端 AI 编程 Agent | Anthropic 官方终端编程 Agent |
开源 | 开源 | 闭源 |
成本优化 | 围绕 DeepSeek prefix-cache 设计，重复上下文可缓存，适合长时间挂机运行 | 以官方定价为准 |
推荐场景 | 批量任务、长时间挂机运行 | 常规交互式编程 |
模型支持 | 可在 setup 中切换供应商，默认 DeepSeek | 以官方支持为准 |
具体功能、定价差异请以 Reasonix 官方文档 和各工具官方说明为准。也可以在 Reasonix 里直接提问，让它自己介绍。
常见问题（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：有。官网 https://reasonix.io/ 提供桌面版，按官网指引安装即可。
常见报错速查
现象 | 原因 | 解决办法 |
command not found | 安装失败或 PATH 未生效 | 确认 npm i -g reasonix 无报错，重开终端再试 |
提示 Node 版本不兼容 | Node 低于 22 | 升级到 Node 22+ 的 LTS 版本 |
一直提示需要 API Key | 未配置或 Key 无效 | 重新运行 reasonix setup，粘贴完整 Key |
对话无响应或网络超时 | 网络无法访问服务 | 检查网络连接与代理设置 |
更新与卸载
# 更新到最新版
npm update -g reasonix
# 卸载
npm uninstall -g reasonix下一步
官方文档与下载地址：https://reasonix.io/ DeepSeek 开放平台：https://platform.deepseek.com/ 想深入了解与 Claude Code 等同类工具的区别，可以直接在 Reasonix 里提问，或查看官方说明