内容
# 代码委托 MCP
**保留精华。委托构建。**
[](https://www.npmjs.com/package/codex-delegate-mcp)
[](https://www.npmjs.com/package/codex-delegate-mcp)
[](https://nodejs.org)
[](LICENSE)
[](https://github.com/andreilungeanu/codex-delegate-mcp/actions/workflows/test.yml)
<img src="assets/logo-light.png" alt="代码委托 MCP logo" width="150" align="left" hspace="15">
在最关键的环节使用您最好的编码代理：理解任务、制定计划和审查结果。
代码委托是 MCP 桥接器，允许 Claude Code、Cursor、Copilot 或任何 MCP 客户端将实现委托给 **OpenAI Codex CLI**，然后获取干净、结构化的结果进行审查。
<br clear="left">
## 🧠 前沿质量，保持
您的助手执行前沿模型实际应做的任务：理解任务、编写精确的简介、审查完成的差异。Codex 作为实施者 - 由更智能的协调器指导和检查。结果读起来像前沿工作，因为前沿模型计划并批准了它。
## ⚡ 更快完成
Codex 在处理多文件编辑时，速度比前沿聊天模型快得多，而后者仍在处理第一个文件。您委托、继续与助手合作，差异结果就会出现。
## 🔋 您的限制不再成为瓶颈
委托工作在 **OpenAI Codex CLI** 上运行，其使用与协调器的聊天配额分开。您的 Claude、Cursor 或 Copilot 订阅在简介和审查上消耗令牌；Codex 执行具体工作。在 API 上？这意味着每令牌的计算量从您的主要账单中转移。
## 🔍 可信的结果
只有当 Codex 干净地退出并写入自己的最后一条消息文件时，答案才被视为最终答案。取消或超时运行，但您仍然会得到 Codex 的最后一条消息 - 明确标记为抢救的消息，绝不会冒充已完成的工作。当 Codex 的工具调用在其他方面看起来干净的回合内失败时，您会收到警告，表明情况并非如此，因为对从未发生过的工作的自信总结是一种昂贵的失败。
```
您 → 您的代理（计划和审查）
│ MCP 委托工具
▼
Codex CLI（实施）
│ 编辑您的工作区
▼
清洁结果：更改内容、文件、线程 ID
```
## 功能
- 🤝 **原生插件** - 安装到 Claude Code、Cursor 或 GitHub Copilot CLI 中，只需说 *"委托给 Codex"*。共享技能教会您的代理如何有效地委托。
- 📦 **干净的、类型化的结果** - 验证的结构化输出：最终答案、`status` 加上 `reason`（当状态不是 `completed` 时）、`threadId`、令牌 `usage` 和 Codex 编辑的文件。非信号字段被省略，因此任何存在的内容都值得阅读 - 空的 `warnings` 真正意味着干净的运行。
- 📋 **计划第一** - `plan` 模式返回架构验证的计划。审查它，然后恢复相同的线程以实施它。
- 💬 **随意提问** - `ask` 模式：对您的代码库进行只读问答，零文件更改。
- 🕵️ **原生代码审查** - `review` 模式对未提交的工作、基准分支或单个提交运行 Codex 的审查员。
- 🧵 **恢复** - 使用 `resumeThreadId` 继续相同的 Codex 线程，并告知您上下文是否实际传递。
- 🛑 **取消意味着取消** - 跨平台的进程树终止，并且 `cancel` 在进程 *结束* 后返回，而不是在请求终止后。
- 📊 **令牌会计** - 每个回合的输入、缓存、输出和推理计数，直接来自 Codex。
- 🩺 **自我诊断** - 一个 `doctor` 工具，如果设置不正确，它会准确告诉您缺少什么。
- 🔌 **在 MCP 工作的所有地方** - VS Code、JetBrains、Windsurf、Visual Studio 等。
## 快速开始
您需要 [Node.js 18+](https://nodejs.org/) 和 [OpenAI Codex CLI](https://github.com/openai/codex) **0.144.0+**，并且已经登录（`codex login`）。
### Claude Code
```shell
/plugin marketplace add andreilungeanu/codex-delegate-mcp
/plugin install codex-delegate-mcp@codex-delegate-mcp
```
然后直接询问：
> 委托给 Codex：将 src/api 从回调迁移到 async/await 并更新测试，然后带我了解更改的内容。
这就是整个循环 — Claude 编写简介，Codex 处理文件，Claude 带您了解差异。
### Cursor
在 **Cursor 设置 → MCP** （或项目 `.cursor/mcp.json`）中添加 MCP 服务器：
```json
{
"mcpServers": {
"codex-delegate-mcp": {
"command": "npx",
"args": ["-y", "codex-delegate-mcp"]
}
}
}
```
然后要求 Cursor 将实现委托给 Codex。
### GitHub Copilot CLI
```shell
copilot plugin install andreilungeanu/codex-delegate-mcp
```
### 更多客户端
<details>
<summary><strong>VS Code</strong> — <code>.vscode/mcp.json</code></summary>
```json
{
"servers": {
"codex-delegate-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "codex-delegate-mcp"]
}
}
}
```
或使用此存储库的 URL 运行 **Chat: Install Plugin From Source**。
</details>
<details>
<summary><strong>JetBrains AI Assistant</strong> — 设置 → 工具 → AI 助手 → MCP</summary>
在 **设置 → 工具 → AI 助手 → 模型上下文协议（MCP）** 下，添加一个命令为 `npx` 且参数为 `-y codex-delegate-mcp` 的服务器。
</details>
<details>
<summary><strong>Windsurf</strong> — <code>~/.codeium/windsurf/mcp_config.json</code></summary>
```json
{
"mcpServers": {
"codex-delegate-mcp": {
"command": "npx",
"args": ["-y", "codex-delegate-mcp"]
}
}
}
```
注意：Cascade 限制您在所有服务器上最多使用 100 个工具。
</details>
<details>
<summary><strong>Visual Studio 2022</strong> — <code>%USERPROFILE%\.mcp.json</code></summary>
```json
{
"servers": {
"codex-delegate-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "codex-delegate-mcp"]
}
}
}
```
需要 17.14+。注意顶级键是 `servers` 而不是 `mcpServers`。
</details>
### Kiro、Kilo Code 和任何其他 MCP 客户端
将以下服务器添加到客户端的 MCP 配置中：
```json
{
"mcpServers": {
"codex-delegate-mcp": {
"command": "npx",
"args": ["-y", "codex-delegate-mcp"]
}
}
}
```
## 需要注意的事项
这是一个 **worker**，适用于协调器主机 - 不是 Codex 自有 `codex mcp-server` 的替代品。您的主机编写简介并审查差异；此桥接运行 Codex 时禁用钩子并忽略您的个人配置，然后返回主机可以信任的证据。将工作区视为受信任：项目 `.codex` 配置在 Codex 的正常优先级下仍然适用。
它开箱即用。如果您需要，可以调整所有内容 - 模型、推理努力、超时、Windows 沙盒模式 - 在 [配置](CONFIGURATION.md) 中。
## 许可证
MIT © [Andrei Lungeanu](https://github.com/andreilungeanu)
<sub>[配置](CONFIGURATION.md) · [安全](SECURITY.md) · [隐私](PRIVACY.md) · [条款](TERMS.md) · [更新日志](CHANGELOG.md)</sub>
