CodeX CLI安装与VSCode部署全攻略

2601_95602870

263人浏览 · 2026-06-16 21:51:39

2601_95602870 · 2026-06-16 21:51:39 发布

CodeX CLI 安装、MCP 适配与 VSCode 部署指南

一、CodeX CLI 安装

1. 环境准备

操作系统：Windows 10 或 11 。
依赖工具：需预先安装 Git 和 Node.js 。

2. 安装步骤| 步骤 | 操作 | 命令/说明 |

3. 配置 API 密钥与模型

安装完成后，需要在用户目录下配置 .codex 文件夹及相关文件。

定位配置文件目录：路径为 C:\Users\<你的用户名>\.codex。如果该文件夹不存在，需手动创建。
创建并配置 auth.json：此文件用于存放 API 密钥。
```
{
  "OPENAI_API_KEY": "你的_API_密钥"
}
```

创建并配置 config.toml：此文件用于配置模型提供商和参数。

model = "gpt-4o" # 指定使用的模型
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

# 以下是自定义API供应商的示例配置（如果使用非OpenAI官方端点）
[model_providers.yourapi]
name = "自定义供应商名称"
base_url = "https://你的API端点/v1"
wire_api = "responses"

重启终端并启动：完成配置后，务必重启终端 。然后进入你的项目目录并启动 CodeX。
```
cd your-project-folder codex ```
```

4. 常用命令与权限* /status：检查当前权限和模型配置，对于使用自定义 API 的用户尤为重要。

/approvals：设置 Codex 的操作权限。有三种模式：

权限模式	描述	用户体验
Read Only	仅能读取文件。	限制过多，需要频繁手动批准。
Auto	可读写文件、运行命令。	仍需要较多手动确认。
Full Access	完全访问权限，包括使用网络工具。	推荐，可实现真正的自动化，无需中途确认。

二、MCP (Model Context Protocol) 适配

MCP 允许 CodeX 连接外部工具和服务。推荐使用 mcp-router 来统一管理多个 MCP 服务。

1. 安装与配置 mcp-router

下载：从 mcp-router GitHub Releases 页面下载对应 Windows 版本的安装程序。
运行与添加服务：
- 运行 mcprouter.exe。
- 点击 Use 按钮安装依赖。
- 在界面中选择需要导入的 MCP 服务（例如 serena）。
启动服务：添加服务后，点击开启按钮，软件会测试服务是否可用。

2. 配置 CodeX 连接 mcp-router

编辑 CodeX 的配置文件 config.toml，添加 mcp-router 服务器配置。

打开 C:\Users\<你的用户名>\.codex\config.toml 。
在文件末尾添加以下配置：
```
[mcp_servers.mcp-router]
command = "npx"
args = ["-y", "mcpr-cli@latest", "connect"]
env = { MCPR_TOKEN = "你的_mcp-router_token" }
```
- MCPR_TOKEN：需要在 mcp-router 软件中获取。在 mcp-router 界面中添加一个自定义应用（如 Codex），即可生成对应的 Token 。

3. (备选方案) 直接配置单个 MCP 服务

如果不使用 mcp-router，也可以直接配置单个 MCP 服务。例如，配置 serena 服务：

[mcp_servers.serena]
command = "uvx"
args = ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "codex"]

4. 激活 MCP 服务

重要：MCP 服务通常不会自动激活，需要在与 CodeX 交互时，在提示词中明确指定使用哪个服务。

示例提示词：使用 serena 将当前目录激活为项目

三、VSCode 插件集成部署

开启自动发现：安装 mcp-router 后，在 VSCode 中，相关 MCP 服务通常可以被支持 MCP 的插件（如 Claude for VS Code, Cursor 等）自动发现。
在 IDE 中配置：在 IDE 的设置或专用配置面板中，找到 MCP 设置项，开启你已配置并启动的 MCP 服务。
使用提示：与 CLI 中一样，在 IDE 中使用 AI 编程助手时，若需调用特定 MCP 服务，仍需在对话中明确指令，例如“使用 serena 搜索文档” 。