codex-acp for Mac 版
为 ACP 兼容客户端提供 Codex CLI 功能的 ACP 服务器
codex-acp 是什么
codex-acp 是一个 stdio ACP agent server,用来让支持 Agent Client Protocol 的客户端调用 OpenAI Codex。它启动 Codex App Server,把 ACP 请求翻译成 Codex 操作,再把 Codex 事件映射回客户端。
核心功能包括:支持 ChatGPT、API key 和客户端自定义网关认证;可选择模型、推理强度、快速模式、审批与沙箱模式;处理文本提示、嵌入上下文、图片、资源链接和额外工作区目录;覆盖 shell 命令、文件变更、权限请求、MCP 工具调用、终端输出、推理、计划、网页搜索、图像生成与查看、token 用量和 review 等事件。它还支持原生 ACP 子代理会话、回合中 steering 输入、异步 Codex 提问、后台终端任务、会话级长期目标、客户端提供的 MCP server,以及 /status、/mcp、/skills、/goal、/review 等斜杠命令。
它解决的是 Codex 与 ACP 客户端之间的协议适配问题,适合需要在既有 ACP 客户端里使用 Codex 能力、又不想自己处理请求与事件转换的开发者。
核心功能包括:支持 ChatGPT、API key 和客户端自定义网关认证;可选择模型、推理强度、快速模式、审批与沙箱模式;处理文本提示、嵌入上下文、图片、资源链接和额外工作区目录;覆盖 shell 命令、文件变更、权限请求、MCP 工具调用、终端输出、推理、计划、网页搜索、图像生成与查看、token 用量和 review 等事件。它还支持原生 ACP 子代理会话、回合中 steering 输入、异步 Codex 提问、后台终端任务、会话级长期目标、客户端提供的 MCP server,以及 /status、/mcp、/skills、/goal、/review 等斜杠命令。
它解决的是 Codex 与 ACP 客户端之间的协议适配问题,适合需要在既有 ACP 客户端里使用 Codex 能力、又不想自己处理请求与事件转换的开发者。
如何安装 codex-acp
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2026-11-08,当前版本 v2.6.0,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v2.6.0 | 2026-11-08 | 稳定版 | — | — | — | — |
| v2.5.0 | 2026-10-29 | 稳定版 | — | — | — | — |
| v2.4.0 | 2026-10-29 | 稳定版 | — | — | — | — |
| v2.3.0 | 2026-10-26 | 稳定版 | — | — | — | — |
| v2.2.2 | 2026-10-10 | 稳定版 | — | — | — | — |
| v2.2.1 | 2026-10-10 | 稳定版 | — | — | — | — |
| v2.2.0 | 2026-10-10 | 稳定版 | — | — | — | — |
| v2.1.1 | 2026-10-01 | 稳定版 | — | — | — | — |
| v2.1.0 | 2026-10-01 | 稳定版 | — | — | — | — |
| v2.0.1 | 2026-09-29 | 稳定版 | — | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- Apple 芯片 · 最新 macOS
- Apple 芯片 · macOS 26 Tahoe
- Apple 芯片 · macOS 15 Sequoia
- Linux · ARM64
- Linux · x86_64
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| codex-acp | v2.6.0 | Apache-2.0 | 命令行 | 346 |
| cc-switch-cli | v5.11.3 | MIT | 命令行 | 397 |
| agent-manager | v0.48.1 | Apache-2.0 | 命令行 | 315 |
| Osaurus | 1.0.4 | — | 仅 Apple 芯片 | 256 |