项目简介

'cc-codex' 仓库提供了一个连接Claude Code（作为客户端）和OpenAI Codex（作为后端智能体）的桥梁。其核心是 'codex-mcp-server'，一个实现了Model Context Protocol (MCP) 的服务器。这个服务器将Codex的推理、规划、分析等能力封装成可供MCP客户端调用的“工具”，从而让Claude Code等LLM客户端能够无缝地利用Codex的深度智能进行软件开发任务，同时还能共享会话上下文，提升开发效率并降低API成本。

主要功能点

提供Codex工具服务: 通过MCP协议，将OpenAI Codex的强大推理能力（如深度分析、规划、规范制定、代码审查、技术选型等）作为可调用工具提供给LLM客户端。
共享上下文: 支持会话级别的上下文持久化和共享，确保不同工具调用和客户端交互之间状态的一致性。
无缝集成: 专为与Claude Code等LLM客户端的无缝双向集成设计，允许客户端通过简单的命令调用服务器提供的复杂AI功能。
成本效益: 通过利用CLI订阅而非直接API调用，显著降低了使用大型语言模型的运行成本。
工具集: 包含5个核心工具：'codex_reason' (深度推理), 'codex_plan' (实施计划), 'codex_spec' (技术规范), 'codex_analyze' (代码/架构分析), 'codex_compare' (选项比较)。

安装步骤

前置条件: 确保您拥有ChatGPT Plus/Pro/Team账户（用于Codex CLI）和Anthropic Claude订阅（用于Claude Code），并已安装和认证这两个CLI工具。

克隆仓库: 将'cc-codex'仓库克隆到您的本地机器。例如：

git clone https://github.com/rachittshah/cc-codex.git
cd cc-codex

构建MCP服务器: 进入'codex-mcp-server'目录，安装依赖并构建服务器。
```
cd codex-mcp-server
npm install
npm run build
```
（请确保您在仓库的根目录下执行 'cd codex-mcp-server'）

服务器配置

MCP服务器通常由MCP客户端启动并与之通信。以下是Claude Code客户端连接此MCP服务器所需的配置示例（将其添加到您的 '~/.claude/settings.json' 文件中）：

{
  "mcpServers": {
    "codex": {
      "command": "node",
      "args": ["/path/to/cc-codex/codex-mcp-server/dist/index.js"]
    }
  },
  "permissions": {
    "allow": ["mcp__*"]
  }
}

请将上述配置中的 '/path/to/cc-codex' 替换为您的 'cc-codex' 仓库在本地文件系统中的实际路径。

配置说明：

'mcpServers': 定义了MCP服务器列表。
'codex': 这是您为该MCP服务器指定的名称，MCP客户端会通过此名称识别和调用它。
'command': 启动MCP服务器所需的执行命令，这里是 'node'。
'args': 传递给 'command' 的参数，即MCP服务器的入口文件路径。
'permissions.allow': 允许Claude Code客户端调用所有以 'mcp__' 开头的工具。

基本使用方法

启动Claude Code: 在终端中输入 'claude' 启动Claude Code客户端。
使用斜杠命令调用Codex工具: 在Claude Code的交互界面中，可以直接使用预定义的斜杠命令来调用MCP服务器上的Codex工具。
- '/plan implement user authentication with JWT'：请求Codex生成用户认证功能的详细实现计划。
- '/reason should we use PostgreSQL or MongoDB?'：请求Codex进行深度推理，评估数据库选型的优缺点并给出建议。
- '/spec REST API for user management'：请求Codex创建用户管理API的详细技术规范。
- '/codex compare Redis vs Memcached for caching'：执行通用Codex任务，客户端会智能选择合适的工具进行比较分析。

通过这些斜杠命令，Claude Code客户端会将请求发送给本地运行的 'codex-mcp-server'，由后者协调Codex CLI执行任务并将结果返回给Claude Code，实现高效的AI协同开发。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息