ltxzs/claude-subagent-mcp

通过mcp的形式在Codex中调用claude code CLI实现claude负责实现代码,Codex负责审查代码.Local stdio MCP server that delegates implementation tasks to Claude Code for Codex review workflows.

About claude-subagent-mcp

Claude Code Subagent MCP 是一个用户级 stdio MCP server，让 Codex Desktop 或 Codex CLI 可以调用 Claude Code CLI 作为实现者。Codex 负责协调任务、展示 Claude 的回复，并审核目标仓库的变更。 server 将经解析、目录验证且确认为 Git 仓库的 workspacePath 用作 Git 和 Claude Code 子进程的 cwd；这只是工作目录设置，不是操作系统级文件系统沙箱。

1. 先使用状态工具检查目标工作区。 2. 通过显式的 workspacePath 将实现任务委派给 Claude Code。 3. 审核 server 返回的 Git 状态和未暂存差异摘要，再自行检查 git diff、git diff --cached，并逐个 打开 git status --short 列出的未跟踪文件，确认完整变更后再决定是否接受结果。

- Node.js 18 或更高版本 - Git - Claude Code CLI - Codex Desktop 或 Codex CLI

将相应配置添加到全局 Codex 配置文件。Windows 的配置文件是 %USERPROFILE%\.codex\config.toml；macOS 和 Linux 的配置文件是 ~/.codex/config.toml。

可参考 examples/config.example.toml 中的完整配置模板。模板中的 REPLACEWITHABSOLUTEPATHTOSRCSERVERMJS 必须替换为当前电脑上的实际路径。

args 必须写入 src/server.mjs 的实际绝对路径。不要指望 TOML 中的 %USERPROFILE% 或 ~ 被展开。

也可独立于 Codex，在项目目录向 server 进程发送 initialize JSON-RPC 请求，以验证进程本身。 这不能替代重启 Codex 和检查工具注册。响应必须包含 claude-code-subagent。

先调用 claudesubagent.getclaudesubagentstatus：

再调用 claudesubagent.delegatetoclaude，传入具体实现要求：

Claude 返回后，server 在结构化结果的 Git 部分包含审核相关字段 statusShort、diffStat 和 diffNameOnly，分别来自 git status --short、git diff --stat 和 git diff --name-only；结果还包含 changedFiles 和 errors（可能为空），但不提供完整 diff。后两个 命令与 git diff 一样，默认只覆盖未暂存变更；暂存变更需另行检查 git diff --cached。Codex 或用户 还必须逐个打开 git status --short 列出的未跟踪文件检查其内容，确认未暂存、暂存和未跟踪变更后再决定 是否接受实现结果。

参数 要求 --- --- task 必填，非空字符串。 workspacePath 必填，非空目录路径，且必须是 Git 仓库。 allowDirty 可选布尔值，默认 false。 resumeSessionId 可选的非空 Claude Code 会话 ID。 timeoutMs 可选整数，单位为毫秒；默认 1200000，且不得小于 1000。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/ltxzs--claude-subagent-mcp.html)

Related MCP servers