Codex 对比 HagiCode: 功能与差异

HagiCode 是一款提案驱动的 AI 编码工作台,可将需求转化为可审阅的提案,通过 Claude Code、Codex、GitHub Copilot 等 Agent CLI 执行,并把结果沉淀为团队知识。

Codex 是 OpenAI 的开源终端编程 Agent,用 ChatGPT 账户或 API 密钥登录。HagiCode 是桌面工作台,把 Codex 当作执行器运行,并在外面补上并行会话、提案和 AI 提交。

安装 HagiCode 桌面版

简体中文2026-10-16

简短结论

Codex 是 OpenAI 的终端编程 Agent:它会查看你的仓库、修改文件并在本机运行命令。HagiCode 是桌面和网页端的工作台,把 Codex 当作执行器之一来运行。它不替代 Codex,也不出售或托管 OpenAI 的模型。

如果你想在 ChatGPT 套餐里用一个快速的终端 Agent,脚本和 CI 用 codex exec 处理,那就只用 Codex。想同时跑多个 Codex 任务、每次改动前先有书面提案,或者在一个工作区里管理多个仓库时,再考虑 HagiCode。

Codex 与 HagiCode 一览

对比项CodexHagiCode
它是什么

OpenAI 的终端编程 Agent;同一产品还有 IDE 扩展、桌面应用、网页版和云端任务

运行 Agent CLI(包括 Codex)的桌面和网页工作台,本身不是模型也不是 Agent

界面与平台

终端界面,另有用于脚本的 codex exec;提供 macOS、Linux、Windows 的安装方式

Windows、macOS、Linux 桌面端;Docker Compose 容器版;微软商店版

价格与授权

CLI 仓库采用 Apache-2.0;用量随 ChatGPT 套餐(截至 2026 年 10 月:Free、Go 8 美元、Plus 20 美元、Pro 每月 100 美元起)或按 API 计费

桌面版和容器版免费;商店版基础功能免费,可选一次性购买 TurboEngine

模型与来源

通过 ChatGPT 登录或 API 密钥使用 OpenAI 模型,可自选模型和推理强度

不托管模型,使用你 Codex 已登录的账户;可选 OmniRoute 模型目录

并行工作

会话内有子 Agent;codex cloud 可把任务交给 OpenAI 云端

多个会话并排运行,每个以 Agent 形式显示状态

规格与规划流程

用 /init 生成 AGENTS.md,用 /permissions 设置权限;自身没有提案归档

OpenSpec 提案:提出、校验、应用、归档;免费版允许 3 个并发提案

Git 与提交

/review 可审查未提交改动、某个提交或分支;文档建议在任务前后做 Git 检查点

AI 生成提交,提交时锁定仓库,Monospecs 可按仓库定位

上手成本

一个安装器、npm 或 Homebrew 命令,再用 ChatGPT 或 API 密钥登录

要先装好并登录 Codex,再装 HagiCode 桌面版

最适合

使用 ChatGPT 套餐的终端用户、脚本和 CI

并行任务、提案驱动的开发和多仓库项目

Codex 的长处

开源,安装方式多

Codex 的代码仓库采用 Apache-2.0 许可。可以用 npm install -g @openai/codex、brew install --cask codex 或独立安装器安装:macOS 和 Linux 用 curl -fsSL https://chatgpt.com/codex/install.sh | sh,Windows 有 PowerShell 安装器。在项目里运行 codex,选择“使用 ChatGPT 登录”,或改用 API 密钥。

ChatGPT 套餐就是账户

Codex 包含在 ChatGPT 的套餐里,从 Free、Go 到 Plus、Pro、Business、Edu 和 Enterprise,并与 ChatGPT 的其他工作功能共用用量额度。自动化场景可改用 API 密钥,按标准 API 价格计费,与订阅用量分开。如果你本来就在为 ChatGPT 付费,成本很容易估算。

可控制它能做什么

/permissions 设置 Codex 何时可以不经询问就编辑文件或运行命令,并显示当前沙箱和可写目录。每次会话可以选择模型和推理强度。/review 可审查未提交的改动、某个提交或基准分支,而不会改动你的工作区。

为脚本和委派而设计

codex exec 为 CI 和可重复任务运行非交互命令,codex mcp 添加 MCP 服务器,--search 开启实时联网搜索,--image 附加截图,codex resume 重新打开保存的对话。Codex 还可以把专门的工作交给子 Agent,codex cloud 则把任务移到云端的 Codex。

什么时候选 Codex,什么时候选 HagiCode

这些情况继续用 Codex

  • 你已经在付 ChatGPT 套餐的钱,希望直接包含 Codex;
  • 你想用 codex exec 或 API 密钥跑脚本和 CI 任务;
  • 你喜欢只用 /permissions 来控制沙箱和审批;
  • 你喜欢一个终端加简短的安装路径,不多装应用;
  • 你想用 codex cloud 把任务交给云端的 Codex。

这些情况选 HagiCode

  • 你同时跑多个 Codex 任务,想在一处看到全部进度;
  • 你想让 Agent 改代码前先有经过评审的提案,完成后归档;
  • 一个 Codex 任务跨越多个仓库,你希望把它们声明成一个工作区;
  • 你想把 Codex 的产出整理成清爽的提交,并用浏览器里的编辑器修正不对的地方;
  • 你把 Codex 和其他 Agent CLI 搭配使用,想在一个工作区里管理。

把 Codex 和 HagiCode 一起用

HagiCode 架在 CLI 之上。它通过 SDK 集成运行你已安装的 Codex,你的 ChatGPT 登录或 API 密钥、套餐额度和计费都留在 OpenAI 那边。

没有任何绑定。仓库、AGENTS.md 和 Codex 配置都在原处,随时可以在同一个项目里运行 codex。

  • 用 npm、Homebrew 或独立安装器安装 Codex,并用 codex --version 确认。
  • 运行一次 codex,用 ChatGPT 或 API 密钥登录,让它在 HagiCode 使用之前就已认证。
  • 安装 Windows、macOS 或 Linux 版 HagiCode 桌面端,也可用 Docker Compose 版或微软商店版。
  • 在 HagiCode 的 Agent CLI 设置里把 Codex 选为执行器;HagiCode 会在 PATH 中查找 codex 命令。
  • 打开仓库,开始会话或 OpenSpec 提案;Codex 的工具调用会显示在 HagiCode 的统一视图里。
  • 想回去时,关闭 HagiCode,在同一目录运行 codex 即可,无需还原任何设置。

HagiCode 在 Agent 之上增加了什么

并行会话与 Agents 管理

每个 Codex 会话都是一个有独立上下文和可见状态的 Agent,三个文件夹里的三个 Codex 任务就是一份列表,而不是三个终端。

OpenSpec 提案

任务可以从一份提案开始,经过提出、校验、应用和归档。Codex 在提案范围内实现,提案记录了“为什么”,这是单靠 codex resume 的历史做不到的。

AI 提交与 Code Server

HagiCode 根据 Codex 的改动起草提交信息,并在提交期间锁定仓库。内置的 Code Server 编辑器在对话旁边打开这些文件。

Monospecs 与 Vault

Monospecs 列出多仓库工作区里的所有仓库,让 Codex 的任务了解全部仓库。Vault 把参考代码和笔记留给后续会话,而新启动的 codex 是没有这些的。

模型路由、工具调用视图与用量

Codex 的工具调用以与其他 CLI 相同的结构化形式显示,实时和历史一致。OmniRoute 可为每个 Agent CLI 提供模型目录,可选的 TokenMonitor 状态栏会显示今日的 Token 与费用。

结论

  • Codex 是终端里的 Agent,HagiCode 是运行它的工作台。
  • 在 ChatGPT 套餐上做个人、单任务或脚本化工作,只用 Codex;需要并行任务、提案和多仓库改动时再加 HagiCode。
  • 前提是先装好并登录 Codex,而且随时可以退回直接运行 codex。

常见问题

Codex 怎么安装?

运行 `npm install -g @openai/codex` 或 `brew install --cask codex`。macOS 和 Linux 的独立安装器是 `curl -fsSL https://chatgpt.com/codex/install.sh | sh`,Windows 的 PowerShell 安装器见 github.com/openai/codex 的 README。然后运行 `codex` 完成登录。

Codex 免费吗?

CLI 本身以 Apache-2.0 开源,但使用需要 ChatGPT 套餐或 API 密钥。截至 2026 年 10 月,OpenAI 把 Codex 列在 ChatGPT 的 Free、Go(8 美元)、Plus(20 美元)及更高套餐里;用 API 密钥则按 API 价格计费。

Codex 能和 HagiCode 一起用吗?

可以。先安装并登录 Codex,再在 HagiCode 里选它作为 Agent CLI。你的 ChatGPT 登录或 API 密钥及其计费仍由 OpenAI 管理。

HagiCode 会取代 Codex 吗?

不会。HagiCode 把 Codex 当执行器,在外面补上会话、提案、提交和多仓库工具。你仍可在同样的仓库里直接运行 `codex`。

Codex 支持 Windows 吗?

OpenAI 在 Codex 的 README 中提供了 Windows 的 PowerShell 安装器。依赖之前请查看 Codex 文档中最新的 Windows 说明。

Codex 和 HagiCode 该选哪个?

在 ChatGPT 套餐上做终端、个人或 CI 工作,选 Codex 即可。想在 Codex 之上获得并行会话、OpenSpec 提案或多仓库工作区时,再加上 HagiCode。

桌面版

本地化的 AI 代码助手,保护隐私,提升效率