来来来,看看 DeepSeek-Reasonix 这个agent
一句话:花 Claude Code 1/50 的钱,干差不多的活。真香。
📋 目录
这货是啥?
Reasonix,一个专门为 DeepSeek 打造的终端 AI 编程助手。
2026 年 4 月开源,MIT 协议,GitHub 上已经 10,300+ star,NPM 每周下载 17,000+。
说人话就是:你花几毛钱,它帮你写一天代码。
速览
| 指标 | 数值 |
|---|---|
| GitHub Stars | 10,300+ |
| 协议 | MIT(白嫖党狂喜) |
| 语言 | TypeScript |
| 要求 | Node.js ≥ 22 |
| 系统 | macOS / Linux / Windows |
| 版本 | v0.53.x |
和其他工具比一比
| 维度 | Reasonix | Claude Code | Cursor | Aider |
|---|---|---|---|---|
| 后端 | DeepSeek(只此一家) | Anthropic | OpenAI / Anthropic | 啥都行 |
| 协议 | MIT 开源 | 闭源 | 闭源 | Apache 2.0 |
| 花费 | 几毛钱一天 | 几十到几百 | $20/月 + 按量 | 看心情 |
| DeepSeek 缓存优化 | 专门搞的 | 没这功能 | 没这功能 | 顺便带的 |
| 内置 Dashboard | ✅ 有 | ❌ 没有 | 不适用 | ❌ 没有 |
有啥牛的?
1. 🚀 缓存命中率逆天(99.82%)
这是 Reasonix 最牛的地方。
真实案例: 有人一天用了 4.35 亿 token,账单才 **61。
怎么做到的?后面技术原理会细说,这里先记住结论:它的架构就是为 DeepSeek 缓存而生的。
2. 💰 便宜到离谱
- DeepSeek 本身比 Claude 便宜 20-50 倍
- Reasonix 的缓存优化再打 1 折
- 日常任务自动用最便宜的 flash 模型
3. 🔧 帮 DeepSeek 擦屁股
DeepSeek 模型有几个臭毛病:
- 有时候把 tool-call 藏在思考过程里忘了发出来
- 参数多了容易漏字段
- JSON 截断了不会自己修
- 同一个工具反复调用
Reasonix 全帮你自动修了,开箱即用,不用操心。
4. 🎯 只支持 DeepSeek(这是优点!)
别觉得这是缺点。正因为只支持一个后端,才能把缓存命中率做到极致。通用框架做不到这个程度。
5. 🛠️ 功能还挺全
- MCP 支持:stdio + SSE + Streamable HTTP
- Skills 系统:写个 Markdown 就能当技能用
- Memory 记忆:让 AI 记住你的项目上下文
- Hooks 钩子:在关键节点执行自定义脚本
- Web 搜索:Mojeek / SearXNG / Metaso
- 桌面客户端:Tauri 做的 GUI(还在测试阶段)
- QQ 频道:用 QQ 远程控制你的 Reasonix session(离谱但真实)
怎么装?
你需要准备
- Node.js ≥ 22
- 去 nodejs.org/ 下最新的 LTS 版本,最好更更新到 v24
- DeepSeek API Key
- 去 复制一下 key
装法一:npx 一把梭(推荐尝鲜,毕竟现在更新很频繁)
不用装,直接跑,每次都拉最新版:
cd my-project
npx reasonix code
裦法二:全局安装(准备全面迁移使用前不推荐)
npm install -g reasonix
reasonix code my-project
裦法三:懒人短命令
npm install -g dsnix
dsnix code
首次启动
第一次跑会弹出配置向导:
- 粘贴你的 DeepSeek API Key
- 选模式(直接回车用默认的
smart就行) - MCP 配置(不懂就跳过)
配置会存到 ~/.reasonix/config.json,下次不用再输。
怎么用?
命令速查
| 命令 | 干啥用 |
|---|---|
reasonix / reasonix code [dir] | 编程模式,日常用这个 |
reasonix chat | 纯聊天,不碰你文件 |
reasonix run "任务" | 一次性任务,输出到 stdout,能管道 |
reasonix doctor | 检查环境是否正常 |
reasonix update | 升级自己 |
Slash 命令(在 TUI 里敲)
换模型
| 命令 | 效果 |
|---|---|
/preset fast | 用 V4-Flash,最便宜最快 |
/preset smart | 默认,R1 推理 |
/preset max | R1 + harvest + 3路分支,质量拉满 |
/model deepseek-reasoner | 手动切 R1 |
/model deepseek-chat | 手动切 V3/V4 |
/pro | 下一轮用 Pro |
功能开关
| 命令 | 效果 |
|---|---|
/harvest on | 开启 R1 思考链收割(把 R1 的推理过程利用起来) |
/branch 3 | 3 路并行采样,选最优答案 |
/stats | 看你花了多少钱(精确到分) |
/sessions | 列出所有会话 |
/forget | 删掉当前会话 |
/help | 完整命令列表 |
代码怎么改?
Reasonix 不会直接改你的文件。它会:
- 生成一个 SEARCH/REPLACE 格式的编辑提案
- 你用
/apply看看改了啥 - 确认没问题才写入
放心,它不会偷偷乱改你代码。
Memory 记忆
# 让 AI 记住点东西
/remember "这个项目用的 PostgreSQL"
# 问它记住了啥
/recall_memory
Skills 技能
# 新建技能
/skill new my-skill
# 全局技能(所有项目都能用)
/skill new my-skill --global
# 看看有啥技能
/skill list
凭啥这么省?(技术原理)
Reasonix 的架构有三大支柱,每个都是为了省钱而设计的。
支柱一:Cache-First Loop(缓存优先循环)
DeepSeek 的缓存规则很简单:你发的请求,开头部分和上次一模一样,就只收 10% 的钱。
问题是,大多数 Agent 框架每轮都在:
- 重排历史顺序
- 注入新的时间戳
- 改写 system prompt
- 工具列表每次序列化结果不一样
结果就是缓存命中率不到 20%,钱白花了。
Reasonix 的做法是把上下文切成三块:
┌─────────────────────────────────────────┐
│ IMMUTABLE PREFIX(死不动) │
│ system + 工具定义 + 示例 │
├─────────────────────────────────────────┤
│ APPEND-ONLY LOG(只加不改) │
│ [用户1][AI1][工具1]... │
├─────────────────────────────────────────┤
│ VOLATILE SCRATCH(每轮清空) │
│ R1 的思考过程、临时状态 │
└─────────────────────────────────────────┘
三条铁律:
- Prefix 一启动就锁死 —— 计算完哈希就不再动
- Log 只能往后面加 —— 绝不改已经有的内容
- Scratch 处理完才能进 Log —— 通过支柱二来处理
支柱二:Tool-Call Repair(工具调用修复)
DeepSeek 有几个臭毛病,Reasonix 帮你修:
| 问题 | 怎么修 |
|---|---|
| tool-call 藏在思考过程里没发出来 | 从 <think> 里捞回来 |
| 参数太多漏字段了 | 自动拍平成扁平结构 |
| JSON 被截断了 | 补全括号、修复格式 |
| 同一个工具反复调 | 滑动窗口熔断 |
支柱三:Cost Control(成本控制)
Flash-First 策略
| 预设 | 用啥模型 | 花多少 |
|---|---|---|
flash | v4-flash | 1× |
auto(默认) | 简单用 flash,难的自动切 pro | 1-3× |
pro | v4-pro | ~12× |
模型会自己升级
如果 flash 搞不定,模型会在响应里输出 <<<NEEDS_PRO>>>,系统自动用 pro 重试。你不用操心。
钱花在哪一目了然
每轮费用实时显示:
- 🟢 绿色:< $0.05(几分钱)
- 🟡 黄色:$0.05-0.20(几毛钱)
- 🔴 红色:≥ $0.20(开始心疼了)
实战演练
场景一:让 AI 帮你写代码
cd my-project
npx reasonix code
> 帮我写一个 Express 服务器,提供 /api/users 接口
# AI 会:
# 1. 看看你项目里有啥
# 2. 想个方案
# 3. 给你看 SEARCH/REPLACE 预览
# 4. 你确认了才写入
场景二:代码审查
npx reasonix code
> 当前目录的代码有什么问题?帮我看看
> 这个函数太乱了,用 TypeScript 重写一遍
> 帮我补几个单元测试
场景三:Git 操作
npx reasonix code
> 帮我提交一个 git commit,总结一下今天的改动
场景四:纯聊天问问题
npx reasonix chat
> React 的 useEffect 和 useLayoutEffect 有啥区别?
> 为啥 JavaScript 的 this 这么坑?
场景五:管道模式(高级玩家)
# 输出到文件
npx reasonix run "分析这段代码的性能" < input.js > report.txt
# 复制到剪贴板
npx reasonix run "写个 README" | pbcopy
场景六:看看花了多少钱
在 TUI 里敲:
/stats
输出长这样:
📊 Session Stats
─────────────────────────────
Total Tokens: 125,432
Cache Hit Rate: 94.2%
Cache Tokens: 118,157
Input Cost: ¥0.05
Output Cost: ¥0.12
─────────────────────────────
Total: ¥0.17
12 万 token 才一毛七,Claude Code 看了会沉默。
场景七:3 路并行采样(追求极致)
npx reasonix code --branch 3
# 或者在 TUI 里
/preset max
# 系统会同时跑 3 个 R1,选最好的那个
# 🔀 branched 3 samples → picked #1
和 Claude Code 正面刚
这是大家最关心的问题:Reasonix 和 Claude Code 到底差多少?
基本面对比
| 维度 | Reasonix | Claude Code |
|---|---|---|
| 开发者 | esengine 社区(开源) | Anthropic(闭源) |
| 协议 | MIT(随便用) | 闭源(得花钱) |
| 支持模型 | 只支持 DeepSeek | 只支持 Claude |
| 运行方式 | 终端 TUI | 终端 TUI |
| 代码编辑 | SEARCH/REPLACE 预览 | 类似机制 |
| MCP 支持 | ✅ | ✅ |
| Skills 系统 | ✅ | ✅ |
| Memory 记忆 | ✅ | ✅ |
| Hooks 钩子 | ✅ | ✅ |
| Web 搜索 | ✅ | ✅ |
能力对比
| 能力 | Reasonix | Claude Code | 说明 |
|---|---|---|---|
| 写代码 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | Claude 在复杂推理上更强 |
| 修 Bug | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 差不多 |
| 代码审查 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 差不多 |
| 重构 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 差不多 |
| 写测试 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 差不多 |
| 解释代码 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | Claude 解释更清晰 |
| 复杂架构设计 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | Claude 明显更强 |
| 数学/证明题 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | Claude Opus 碾压 |
花费对比(重点来了!)
同样干一天活(中等复杂度编程任务):
| 场景 | Claude Code | Reasonix | 差距 |
|---|---|---|---|
| 日常写代码 | ¥50-100 | ¥1-3 | 30-50 倍 |
| 重度使用 | ¥200-500 | ¥5-15 | 30-50 倍 |
| 写一个功能改 5 次 | ¥10-20 | ¥0.2-0.5 | 50 倍 |
| 一天 4.35 亿 token | 不敢算 | ¥85($12) | —— |
该选谁?
选 Reasonix 如果你:
- 钱包不富裕(或不想给 Anthropic 送钱)
- 日常编程任务为主(修 bug、写 CRUD、重构)
- 喜欢折腾终端
- 已经有 DeepSeek API
选 Claude Code 如果你:
- 不差钱
- 需要处理复杂架构设计
- 需要解决高难度算法题
- 需要最强的推理能力
我的建议: 日常用 Reasonix 省钱,遇到真的搞不定的难题再切 Claude Code。两个可以同时装,不冲突。
到底省多少钱?
DeepSeek API 价格(2026年)
| 模型 | 输入(每百万 token) | 输出(每百万 token) |
|---|---|---|
| deepseek-chat (V3/V4) | ¥1 | ¥4 |
| deepseek-reasoner (R1) | ¥4 | ¥16 |
| deepseek-v4-flash | ¥0.6 | ¥1.8 |
对比 Claude Opus:输入 75(每百万 token)。差了几十倍。
缓存省了多少?
| 场景 | 不开缓存 | 开缓存 | 省了多少 |
|---|---|---|---|
| 5 轮对话 | $0.009 | $0.0009 | 93.9% |
| 2 轮工具调用 | $0.015 | $0.0006 | 95.8% |
| 真实用户一天(4.35亿 token) | ~$61 | ~$12 | 80.3% |
和 Claude Code 比花费
写一个中等复杂度功能,改 5 次:
| 工具 | 花费 |
|---|---|
| Claude Code | ¥10-20(3) |
| Reasonix + DeepSeek R1 | ¥0.2-0.5 |
| 差距 | 50 倍 |
3 路并行采样值不值?
开 3 路分支,成本还是只有 Claude 的 1/5,但正确率能提升 10-15%。
结论:DeepSeek 便宜到你可以随便开并行。
谁该用?谁别用?
✅ 适合你
- 穷逼开发者(或不想给 Anthropic 送钱的)
- 日常 CRUD 工人:修 bug、写接口、重构、写测试
- 长时间开着 AI 的人:不想心疼 token
- 终端党:不喜欢臃肿的 IDE 插件
- 开源爱好者:MIT 协议,代码随便看
- 已经有 DeepSeek API 的:别浪费了
❌ 不适合你
- 需要多模型切换的:Reasonix 只支持 DeepSeek
- 要解 PhD 级难题的:Claude Opus 在这类任务上更强
- 要离线/零成本的:试试 Aider + Ollama
- 非要 IDE 集成的:Reasonix 是 terminal-first
踩坑指南
Q: Windows 装不上?
确保装了 Git for Windows,Reasonix 需要 Git Bash 环境。
Q: API Key 哪里搞?
去 platform.deepseek.com/api_keys 注册,新用户有免费额度。
Q: 缓存命中率为啥这么高?
因为 Reasonix 的架构就是为缓存设计的:
- Prefix 启动时就锁死
- Log 只能追加不能改
- 工具声明的序列化结果固定
Q: 怎么退出?
输入 exit 或按 Ctrl+C,会话历史会保留。
Q: 能和 Claude Code 一起用吗?
能。Reasonix 用的是 ~/.reasonix/ 目录,不会冲突。
Q: 怎么看花了多少钱?
在 TUI 里敲 /stats。
Q: 桌面版去哪下?
GitHub Releases:github.com/esengine/De…
注意:桌面版还在测试阶段。
参考链接
官方的
| 啥 | 链接 |
|---|---|
| GitHub 仓库 | github.com/esengine/re… |
| NPM 包 | www.npmjs.com/package/rea… |
| 官网 | esengine.github.io/DeepSeek-Re… |
| 架构文档 | github.com/esengine/De… |
| CLI 参考 | github.com/esengine/De… |
| DeepSeek 官方接入指南 | api-docs.deepseek.com/zh-cn/quick… |
社区的
| 啥 | 链接 |
|---|---|
| Discord 社区 | discord.gg/XF78rEME2D |
| SegmentFault 架构解析 | segmentfault.com/a/119000004… |
| 缓存命中率分析 | www.cnblogs.com/itech/p/201… |
求助
- 跑
reasonix doctor检查环境 - 在 TUI 里敲
/help看完整命令 - 去 Discord 问人
快速参考
一行启动
npx reasonix code
常用命令
/preset fast # 最便宜
/preset smart # 默认
/preset max # 最高质量
/stats # 看花了多少钱
/harvest on # 收割 R1 思考过程
/branch 3 # 3路并行
/help # 完整列表
退出
exit
# 或者
Ctrl+C
最后说一句: 如果你已经在用 DeepSeek API,Reasonix 是目前最好的终端编程 Agent。没有之一。试试就知道了。