microcodex 是什么 和 Codex CLI 怎么分工
microcodex 用 C++ 做成不到 1MB 的终端 agent。讲清它省体积不省账单、不是官方 Codex,以及和 Codex CLI / Cursor 怎么分活。

microcodex 是什么:社区用 C++23 重做的超轻量终端 coding agent,思路贴近 OpenAI Codex,体积压到 1MB 以下,但模型调用仍走 ChatGPT / Codex 那套账号与 API,不是本地大模型。值不值得装,取决于你嫌的是「客户端太重」,还是「能力不够」。
先给选型结论
适合试的人很窄:已经在用或愿意用 ChatGPT / Codex 登录、主要在终端派活、想要一个依赖极少的本地 agent 二进制,并且能接受 alpha 质量与不完整沙箱。2026-08-02 的 Show HN 标题写的是「OpenAI/codex reimplemented in C++ <1MB binary」;仓库 paoloanzn/microcodex,许可 Apache-2.0,写作日最新 tag 是 v0.1.9-alpha。
不适合当成「官方 Codex 平替全家桶」。MCP 尚未实现;bash 安全门是词法黑名单,README 自己写「不是 sandbox」。日常若重度依赖编辑器内联改写、多 MCP、完整权限策略,继续用 Cursor 或官方 Codex CLI 更省事。写作日仓库约 30 star、tag 带 alpha,当作实验客户端比当作生产默认入口更合适。是否要从 Cursor 迁一部分活到 Codex 侧,见Cursor 转 Codex 值不值。
它真正省掉的是什么
省的是客户端体积和运行时依赖,不是模型账单。
Release 里 macOS Apple Silicon 包 microcodex-aarch64-apple-darwin.tar.gz 约 317 KB;2026-08-04 解压后可执行文件 826936 字节(约 807 KB),落在「<1MB」宣称内。Linux 包同样是单文件 gzip,外加 README 要求的 libcurl / OpenSSL 运行库。安装一行:
curl -fsSL https://github.com/paoloanzn/microcodex/releases/latest/download/install.sh | sh
microcodex login
microcodex
对照官方 Codex CLI 文档页(developers.openai.com/codex/cli):官方安装走 chatgpt.com/codex/install.sh,另有 npm、Homebrew,产物是完整产品线入口(终端、IDE、App、Cloud)。MicroCodex 的卖点是「一个很小的本地 agent 进程」:one-shot 提示、交互 TUI、本地编码工具、会话持久化、自动上下文压缩。HN 帖里作者还提过约 8k 行 C++ 量级的重实现,那是实现路径说明,不是功能对等证明。
不是官方 Codex,能力边界在哪
名字带 Codex,账号目录也复用 $CODEX_HOME(默认 ~/.codex),但发布主体是个人仓库,不是 OpenAI。登录流程是 microcodex login 打开浏览器,或 --device-auth 走设备码;凭证落到 Codex 家目录。换句话说,本地二进制变轻了,智能仍来自远端模型。
能力边界按 README「Known bugs」和安全警告可以直接列:
- 无 MCP。要连外部系统、要工具市场生态,现在走不通。
- 终端里暂时不能复制选中文本(TUI 限制)。
- Shell 前只有简单 denylist(
rm -rf、git reset --hard、强制git clean、磁盘格式化、关机类等);未命中黑名单的命令与文件操作,权限等于进程本身。 - Skills 能发现
$CODEX_HOME/skills下带name/description的SKILL.md,元数据进会话,正文按匹配再读。这和官方 Codex 的文件系统 skill 习惯兼容,但不等于功能集对齐。
官方 Codex CLI 文档强调的是完整产品能力:权限模式、模型切换、codex exec 进脚本/CI、云任务等。MicroCodex 目前更像「同账号体系下的轻客户端实验」,不是官方发行通道。
和 Codex CLI、Cursor 怎么分活
分活用途时可以这样记:Cursor 管编辑器里的连续小改;官方 Codex CLI 管完整终端 agent 与脚本化;MicroCodex 管「只要一个极小二进制、能接受 alpha」的本地派活。更完整的栈拆法见三层工具栈怎么组。
| 维度 | MicroCodex | 官方 Codex CLI | Cursor |
|---|---|---|---|
| 形态 | C++ 单二进制,<1MB | 官方安装器 / npm / brew | 编辑器 + Agent |
| 模型 | ChatGPT/Codex 登录,远端推理 | 同上账号体系 | 自有订阅与模型路由 |
| MCP | 未实现 | 支持(见官方文档) | 支持 |
| 安全边界 | 词法 denylist,非沙箱 | 产品级权限与策略 | 工作区与权限对话框 |
| 适合 | 轻依赖终端实验 | 终端主流程、CI、云任务 | 内联改写、多文件点改 |
官方 Codex 和 ChatGPT 网页版的差别,另见Codex CLI 是什么。实务建议:用 MicroCodex 试「同账号、更瘦客户端」是否够用;主业流水线仍钉在官方 CLI 或编辑器,直到 MCP 与沙箱策略补齐。版本是 alpha,接口和体积都可能变,安装前看当前 Release 资产表比看宣传句更稳。
第一次试跑怎么排,别踩坑
别一上来就对着生产仓库开权限。更稳的顺序是:用空目录或玩具仓库登录一次,确认 microcodex login 能写进 $CODEX_HOME;再丢一个只读任务(例如「列出当前目录结构并解释一个小函数」),看 TUI 是否稳定、会话是否落盘。
试跑时把这三条记下来,方便和官方 CLI 对照:
- 同一账号下,官方
codex与microcodex是否共享 skills 目录与登录态,有没有互相覆盖配置。 - 一条会触发 denylist 的命令(如故意写
rm -rf /tmp/fake-empty)是否被拦,以及拦不住时进程权限实际能碰到哪些路径。 - 需要 MCP 的任务(查 issue、读文档站、连浏览器)在 MicroCodex 里会怎样失败——预期是直接不可用,而不是静默降级。
若你主要痛点是「Cursor 太重、只想终端派活」,MicroCodex 值得占一个周末下午;若痛点是「模型不够强」或「要接公司 MCP」,它解决不了,换模型档位或回到官方 Codex / 编辑器才对路。账单仍按远端用量走,二进制再小也不会把百万 token 变免费。
Show HN 讨论里也会出现「为什么不用官方 CLI」这类问题。合理回答只有一层:作者做的是实现与体积实验,不是功能竞品发布。把它放进工具箱时,标签应是「轻客户端原型」,不是「Codex 替代品」。
常见问题
MicroCodex 能完全离线跑吗?
不能当本地大模型用。二进制和工具在本地,推理仍要登录后的远端服务。没网或登录失败时,它起不来完整编码循环。
和官方 Codex 的 skills 能共用吗?
README 写明:会发现 $CODEX_HOME/skills(或 ~/.codex/skills)里符合 frontmatter 的 skill,并在任务匹配时读全文。目录习惯可共用;触发质量、工具面仍受 MicroCodex 自身能力限制(例如无 MCP)。
它比官方 Codex 更安全吗?
不更安全。作者警告它不是 sandbox;denylist 拦不住变形命令。高风险仓库或生产凭据环境,应按官方 Codex / 编辑器的权限模型来选,而不是因为二进制小就放松隔离。
参考资料
- paoloanzn/microcodex — README:安装、登录、skills、已知问题与非沙箱警告
- Show HN: MicroCodex(item 49147842) — 2026-08-02 讨论帖,标题含 C++ / <1MB 重实现表述
- Codex CLI 官方文档 — 官方终端 Codex 的安装与能力对照页