GitHub: https://github.com/zed-industries/codex-acp

OpenAI 的 Codex CLI 最近挺火，但终端毕竟不是写代码最舒服的地方。Zed 团队整了个 codex-acp，把 Codex 包装成 ACP（Agent Client Protocol）适配器，让 Codex 能直接跑在 Zed 的 Agent Panel 里。

这是什么

codex-acp 是一个轻量级适配层，把 Codex CLI 的能力通过 ACP 协议暴露出来。Zed 从 v0.180 开始原生支持 External Agents，装上这个适配器就能在编辑器里跟 Codex 对话。

核心功能

  • 上下文 @-mentions：在对话里 @ 文件、符号、代码片段，Codex 能看到完整上下文
  • 图片支持：直接贴图给 Codex 分析
  • 工具调用：Codex 可以调用本地工具，执行前会弹窗请求权限
  • 编辑审查：Codex 提出的修改会显示在 diff 视图里，你点确认才生效
  • TODO 列表：Codex 能创建任务清单，完成一项勾一项
  • Slash 命令：
    • /review - 代码审查（可加自定义指令）
    • /review-branch - 审查整个分支的改动
    • /review-commit - 审查指定 commit
    • /init - 初始化项目配置
    • /compact - 压缩对话历史
    • /logout - 登出

怎么接入

Zed 最新版已经内置支持。打开 Agent Panel，点右上角 + 号，选 “New Codex Thread” 就行。

如果你用其他 ACP 客户端，可以手动安装：

# 从 release 下载对应平台的二进制
# 或者直接用 npx
npx @zed-industries/codex-acp

认证支持两种方式：

  • ChatGPT Plus 订阅（需要付费，且不支持远程项目）
  • CODEX_API_KEY 或 OPENAI_API_KEY 环境变量

为什么值得关注

673 stars 的小众项目，但解决了实际痛点：Codex 很强，但终端交互总是差点意思。把它塞进编辑器，配合 Zed 的多人协作和极速性能，体验上了一个台阶。

尤其是 /review 系列命令，让 Codex 从”写代码工具”变成”代码审查助手”，工作流更完整了。

项目还在快速迭代，Zed 团队自己也在用。如果你同时是 Zed 和 Codex 用户，这个适配器值得一试。