Claudemcp

🔗 ClaudeMCP

让 Codex 与 Claude Code 无缝协作

将 Claude Code CLI 封装为 MCP 协议接口 让 Codex 能够调用 Claude 进行代码审查、架构规划

简体中文 | English

🤔 这是什么？

你可能已经用过 CodexMCP 或 GeminiMCP — 它们让 Claude Code 能够调用 Codex/Gemini。

ClaudeMCP 是反过来的版本。

| 项目 | 方向 | |------|------| | CodexMCP | Claude → Codex | | GeminiMCP | Claude → Gemini | | ClaudeMCP | Codex → Claude |

当你在 Codex 中工作时，可以调用 Claude Code 来：

• 📝 审查代码改动
• 🏗️ 规划实现方案（Plan 模式）
• 🔍 分析架构设计

---

✨ 核心特性

| 特性 | 说明 | |------|------| | 🔄 会话持久化 | 通过 SESSION_ID 支持多轮对话 | | 🛡️ 权限控制 | 支持 permission_mode 配置（plan/default 等） | | 🎯 工具限制 | 通过 allowed_tools 控制 Claude 可用的工具 | | 🤖 模型选择 | 支持 sonnet/opus/haiku | | ⏱️ 轮次限制 | max_turns 防止无限循环 |

---

🚀 快速开始

1️⃣ 前置要求

• Codex CLI
• Claude Code
• uv

# 安装 uv (如果还没有)
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2️⃣ 配置 MCP

在 Codex 的 MCP 配置中添加：

{
  "mcpServers": {
    "claude": {
      "command": "uvx",
      "args": ["--from", "/path/to/claudemcp", "claudemcp"]
    }
  }
}

---

📖 工具参数

| 参数 | 类型 | 必填 | 默认值 | 说明 | |------|------|:----:|--------|------| | PROMPT | str | ✅ | - | 发送给 Claude 的任务指令 | | cd | Path | ✅ | - | 工作目录 | | SESSION_ID | str | | "" | 会话 ID（多轮对话） | | model | str | | "" | 模型（sonnet/opus/haiku） | | permission_mode | str | | "" | 权限模式（plan/default/bypassPermissions） | | allowed_tools | str | | "" | 允许的工具（逗号分隔） | | max_turns | int | | 0 | 最大轮次（0=无限制） | | return_all_messages | bool | | False | 返回完整消息记录 |

返回值

// 成功
{
  "success": true,
  "SESSION_ID": "550e8400-e29b-41d4-a716-446655440000",
  "agent_messages": "Claude 的回复..."
}

// 失败
{
  "success": false,
  "error": "错误信息"
}

---

🎯 使用场景

代码审查

使用 claude 工具审查当前目录的代码改动，设置 allowed_tools="Read,Grep,Glob"

Plan 模式

调用 claude 工具，设置 permission_mode="plan"，分析如何重构 auth 模块

多轮对话

继续上次的会话，SESSION_ID="之前返回的ID"，追问实现细节

---

❓ FAQ

Q: 与直接用 Claude Code 有什么区别？

ClaudeMCP 让 Codex 能够程序化调用 Claude Code，支持会话管理和结构化返回。适合在 Codex 工作流中集成 Claude 的能力。

Q: 会话会冲突吗？

不会。每个会话使用独立的 SESSION_ID，完全隔离。

Q: 如何限制 Claude 的权限？

两种方式：

• permission_mode="plan" — Claude 只能规划，不能执行
• allowed_tools="Read,Grep,Glob" — 只允许只读工具

---

📜 许可证

[](LICENSE)

Copyright (c) 2025 Ying

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: snakeying
• Source: snakeying/Claudemcp
• License: MIT

Install and usage instructions live in the source repository linked above.