先看结论快速开始如果你已经有 Node.js ≥ 22 和 DeepSeek API Key4 条命令就能跑起来——npm i -g reasonix→reasonix setup→reasonix。想每步都确认没走错往下看完整教程。1. 什么是 ReasonixReasonix 是专为 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 ≥ 22Reasonix 基于 Node.js 运行npm 包要求Node.js ≥ 22。推荐从 Node.js 官网 下载最新 LTS长期支持版本。系统支持macOS、Linux、WindowsPowerShell、Git Bash、Windows Terminal。一个 DeepSeek API Key按下一节步骤获取。验证点在终端执行node -v能输出版本号≥ 22即说明 Node 装好了。3. 准备 DeepSeek API Key访问 DeepSeek 开放平台 并注册登录直接打开API keys页面https://platform.deepseek.com/api_keys点击「创建新 API Key」重要提示生成的 Key 只在创建时完整显示一次请务必当场复制并妥善保存4. 安装 ReasonixCLIReasonix 提供CLI和桌面版两种安装方式本教程以 CLI 为例。桌面版请到官网下载https://reasonix.io/在命令行中执行全局安装命令npmi-greasonix验证点执行reasonix --version能输出版本号即安装成功。若提示command not found先重开一个终端窗口再试PATH 未生效。5. 初始化配置安装成功后运行以下命令通过交互式向导完成初始化配置设置 API Key、选择语言和主题。reasonix setup选择语言选择供应商输入 DeepSeek API Key回车保存验证点保存后界面不再提示配置缺失即可。Key 填错了也不用担心——随时重新运行reasonix setup覆盖。6. 开始使用进入项目目录输入以下命令启动 Reasonixreasonix启动后顶部会显示当前配置的模型左下角还能看到 API 余额方便随时掌握消费情况输入一个简单的问题做验证比如简单介绍一下 你和 Claude Code 的区别只要它能正常返回回答就说明安装配置全部完成。底部会实时显示本次对话消耗的 token 数量和费用验证点能收到回答且底部出现 token 消耗数字即代表端到端跑通。退出按Ctrl C即可退出 Reasonix。7. Reasonix 和 Claude Code 有什么不同对比项ReasonixClaude Code定位专为 DeepSeek 深度优化的终端 AI 编程 AgentAnthropic 官方终端编程 Agent开源开源闭源成本优化围绕 DeepSeek prefix-cache 设计重复上下文可缓存适合长时间挂机运行以官方定价为准推荐场景批量任务、长时间挂机运行常规交互式编程模型支持可在 setup 中切换供应商默认 DeepSeek以官方支持为准具体功能、定价差异请以 Reasonix 官方文档 和各工具官方说明为准。也可以在 Reasonix 里直接提问让它自己介绍。8. 常见问题FAQQ执行reasonix提示「不是内部或外部命令 / command not found」A说明全局安装失败或 PATH 未生效。先确认npm i -g reasonix无报错然后重开一个终端窗口再试。QAPI Key 填错了怎么修改A重新运行reasonix setup按向导重新输入即可覆盖旧配置。Q想换 DeepSeek 之外的模型供应商Areasonix setup的供应商选择步骤可以在初始化时切换随时可以重跑 setup 更换。Q本地 Node 版本低于 22 能用吗A不保证兼容。建议先升级到 Node ≥ 22 的 LTS 版本再安装。QReasonix 免费吗AReasonix 本身是开源工具不收费。你需要自己提供 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对话无响应或网络超时网络无法访问服务检查网络连接与代理设置9. 更新与卸载# 更新到最新版npmupdate-greasonix# 卸载npmuninstall-greasonix10. 下一步官方文档与下载地址https://reasonix.io/DeepSeek 开放平台https://platform.deepseek.com/想深入了解与 Claude Code 等同类工具的区别可以直接在 Reasonix 里提问或查看官方说明
