配置驱动，不绑定某一个模型
供应商、Agent、启用的工具和插件都写在 reasonix.toml 里。DeepSeek 是内置预设，任何 OpenAI 兼容端点都以配置而不是代码的方式添加。
还可以让一个执行模型和一个规划模型同时运行，各自使用缓存稳定的会话。
Reasonix 对比 HagiCode: 功能与差异
HagiCode 是一款提案驱动的 AI 编码工作台，可将需求转化为可审阅的提案，通过 Claude Code、Codex、GitHub Copilot 等 Agent CLI 执行，并把结果沉淀为团队知识。
Reasonix 是在你本机运行的 MIT 许可开源编码 Agent，内置 DeepSeek 预设，也支持任何 OpenAI 兼容模型。HagiCode 通过 ACP 模式运行 Reasonix，并在外面补上会话、提案和提交工具。
简短结论
Reasonix 是一个开源编码 Agent，会读你的项目、改文件、运行命令和测试，内置权限级别和回退功能。模型由你自己选：DeepSeek 是内置预设，任何 OpenAI 兼容服务只需加一条配置。HagiCode 是工作台，把 Reasonix 作为执行器启动，并提供并行会话、规格提案、提交和历史记录。它不会替代 Reasonix，也不提供模型。
如果你主要想要一个终端、桌面或编辑器里的 Agent，配上便宜的模型和自己简单的工作流，只用 Reasonix 就够了。当你同时跑多个任务，或希望每次改动都从书面提案开始时，再加上 HagiCode。
Reasonix 与 HagiCode 一览对比
对比项ReasonixHagiCode
定位
开源编码 Agent：在你的项目文件夹里读代码、改文件、运行命令和测试
AI 编程工作台，把各类 Agent CLI（包括 Reasonix）当作执行器来运行
界面与平台
终端界面、Studio 桌面应用、浏览器（reasonix web）、VS Code、通过 ACP 接入其他编辑器；支持 macOS、Linux、Windows
桌面应用（Windows、macOS、Linux）、Docker Compose 容器版、Microsoft Store 版
价格与许可
MIT 许可，免费；直接向模型供应商付费
桌面版和容器版免费；Store 版基础免费，可选一次性购买 TurboEngine
模型与供应商
DeepSeek 预设；任何 OpenAI 兼容端点只需一条配置；可选执行模型加规划模型
不托管模型；使用你 Reasonix 配置里的供应商，或配置后走 OmniRoute
并行工作
会话内可用子 Agent 配置
多个会话并排运行，作为命名 Agent 统一管理
规格与规划流程
计划模式：经你批准计划后才开始动手
OpenSpec 提案：提出、校验、实施、归档
Git 与提交
每轮对话的文件检查点，可回退编辑而不动 git 历史
AI 生成提交信息并锁定仓库；界面内管理 Git
向你提问
内置带选项的提问工具
在对话中显示每个问题；每题选一个选项，然后继续运行
上手成本
npm i -g reasonix 或下载桌面应用，然后用 reasonix setup 选模型
先装好 Reasonix，再装 HagiCode，然后选择 Reasonix 作为 Agent CLI
最适合
想用配置驱动的 Agent、搭配低成本模型，在终端、桌面或编辑器里使用的开发者
在多个仓库里并行跑 Reasonix 任务，并希望规格、审查和历史集中管理的人
Reasonix 的强项
可调可撤的自主程度
权限级别让你选择每次都询问，还是让日常操作自动执行，你设的禁止规则始终生效。计划模式则要等你批准后才开始动手。
文件改动前会先保存，所以可以按对话轮次回退，而不动 git 历史。只覆盖编辑工具改过的文件，不包括 shell 命令的影响。
对缓存友好的上下文管理
启动时注入一份小而稳定的环境摘要，过期的工具输出会在摘要压缩前被裁剪。项目把这称作缓存感知，对给缓存前缀打折的供应商尤其有用。
四种入口，同一个引擎
终端、Studio 桌面应用、用 reasonix web 启动的浏览器界面，或通过 ACP 接入的编辑器，运行的都是同一个本地引擎。MCP 服务器和 Extension Protocol sidecar 可以添加工具、提示和事件。
Reasonix 有两条版本线：2.x（Studio，积极开发中）和 1.x（稳定，维护中）。安装时请留意选的是哪一条。
什么时候选 Reasonix，什么时候选 HagiCode
这些情况继续用 Reasonix
- 只用 Reasonix：你想要配置驱动的 Agent，搭配便宜或自选的模型，DeepSeek 是最容易的起点。
- 只用 Reasonix：你把权限级别、计划模式和按轮回退当作安全网。
- 只用 Reasonix：你的编辑器已经支持 ACP，想把 Agent 放进编辑器里。
- 只用 Reasonix：你一次只做一个任务，笔记自己管理。
这些情况选 HagiCode
- 选 HagiCode：你想同时运行多个 Reasonix 会话，每个会话有独立上下文和状态。
- 选 HagiCode：你希望每次改动都从书面提案开始，并以归档记录结束。
- 选 HagiCode：一个功能横跨多个仓库，你想一次声明清楚。
- 选 HagiCode：你想在会话旁边有 AI 生成的提交和浏览器编辑器。
- 选 HagiCode：你会在不同 Agent 间切换，想用同一个界面管理 Reasonix、Claude Code、Codex 等。
把 Reasonix 和 HagiCode 一起用
HagiCode 不会打包或替换 Reasonix。它会查找 reasonix 可执行文件、检测版本，并在每次运行时以 ACP 模式启动它，所以你的安装、供应商密钥和 reasonix.toml 都保持原样。
模型选择使用你 Reasonix 配置里已定义的引用；未定义的模型会让该轮失败并给出明确错误，而不是悄悄回退。
- 安装 Reasonix（例如 npm i -g reasonix，macOS 上也可用 brew install esengine/reasonix/reasonix），运行 reasonix setup 配置供应商和模型。
- 安装适用于 Windows、macOS 或 Linux 的 HagiCode Desktop。
- 在 HagiCode 里把 Reasonix 选为 Agent CLI，并填写在 Reasonix 配置里定义过的模型引用。
- 打开一个仓库，开始会话或提案。
- 输出和工具调用会流式显示在对话中；enableYolo 默认关闭，可在 HagiCode 的 Reasonix 设置里打开。
- 想回到原来的方式，直接在终端里照常运行 reasonix 即可。你的配置和会话不会被 HagiCode 锁定。
HagiCode 在 Agent 之上增加了什么
并行会话与 Agents 管理
HagiCode 里每次 Reasonix 运行都是独立会话，一个处理 bug，另一个做新功能。Agents 管理会显示每个会话的状态，不用开一排终端。
OpenSpec 提案
Reasonix 的计划模式是在单个会话里批准计划，HagiCode 的提出、校验、实施、归档流程则把这份计划留成长期记录。免费版同时最多 3 个提案。
AI 提交与 Code Server
HagiCode 根据差异生成提交信息，并在提交期间锁定仓库。内置 Code Server 可在浏览器编辑器里打开 Reasonix 改过的文件。
Monospecs 与 Vault
Monospecs 在一个文件里列出你的仓库，让 Reasonix 开始提案时就了解完整的改动范围。Vault 保存参考项目和笔记，新提案可拿来当上下文。
OmniRoute、工具调用视图与 TokenMonitor
Reasonix 本来就支持任何 OpenAI 兼容端点，所以 OmniRoute 可以作为又一条可选的路由。Reasonix 的工具调用与其他 Agent 使用同一种格式，状态栏里还可选显示 TokenMonitor 提供的今日 token 与费用。
交互式提问
Reasonix 提问时，HagiCode 会在对话中显示，会话等待回复，你回答后同一次运行继续。每个问题只能选 Reasonix 给出的选项之一，每个回答都会和会话一起保存。
- 同时提出的多个问题可以一次提交回答；
- 超过 30 分钟未回答的问题会过期，仍可通过后续消息回答；
- 由各 CLI 的交互控制设置决定是否启用。
结论
- Reasonix 是免费、MIT 许可、配置驱动的 Agent；HagiCode 是运行它的工作台，并不替代它。
- 想要权限级别、回退和自选模型，又只需要轻量流程，只用 Reasonix 就够了。
- 需要并行会话、提案、提交辅助和多仓库上下文时，在同一个 Reasonix 安装之上加上 HagiCode。
- 你的 Reasonix 配置不受影响，可以放心试用 HagiCode，随时回到终端。
常见问题
Reasonix 免费吗？
Reasonix 采用 MIT 许可，可免费安装。你直接向模型供应商付费，成本取决于你配置的模型和供应商。最新信息请看 Reasonix 仓库。
怎么安装 Reasonix？
任何系统运行 npm i -g reasonix，macOS 也可用 brew install esengine/reasonix/reasonix，然后运行 reasonix setup 选择模型。Studio 桌面应用和 2.x CLI 压缩包在 esengine/DeepSeek-Reasonix 的 GitHub releases 页面。
Reasonix 只能用 DeepSeek 吗？
不是。DeepSeek 是内置预设，但任何 OpenAI 兼容服务都可以在 reasonix.toml 里作为一条配置加入。
Reasonix 能和 HagiCode 一起用吗？
可以。HagiCode 支持把 Reasonix 作为 Agent CLI，并通过 reasonix acp 运行它。先安装 Reasonix 并配置好供应商，再在 HagiCode 里选择它。
HagiCode 会取代 Reasonix 吗？
不会。HagiCode 是围绕 Reasonix 的工作台，提供会话、提案、提交和历史记录。运行时需要先安装并配置好 Reasonix。
Reasonix 和 HagiCode 该选哪个？
想要配置驱动、用自选模型、一次做一个任务，只用 Reasonix。想要并行会话、提案和可视化历史，就在它之上加 HagiCode。