Windows 10/11 下 Codex MCP 服务配置指南
在 Windows 平台上配置 Codex MCP 服务涉及环境搭建与系统配置，常因路径结构、环境变量机制和终端编码问题导致开发流程受阻。本文将介绍完整配置流程，包括基础环境搭建、核心配置及高级调试技巧。
1. 基础环境搭建
1.1 Node.js 安装与版本管理
Windows 上的 Node.js 安装看似简单，但版本选择和管理却直接影响后续 MCP 服务的稳定性。建议从 Node.js 官网下载 LTS 版本（当前推荐 18.x），避免使用最新版可能带来的兼容性问题。
安装完成后，验证 Node.js 和 npm 是否正常工作：
node -v
npm -v
提示：如果系统提示'不是内部或外部命令'，说明环境变量未正确配置。需要在安装时勾选'自动添加 PATH'选项，或手动将 Node.js 安装目录添加到系统 PATH 中。
1.2 Codex CLI 全局安装
在 PowerShell（推荐使用新版 pwsh）中执行以下命令：
npm install -g @openai/codex
安装完成后，验证 CLI 是否可用：
codex --version
常见安装问题排查：
- 权限不足：以管理员身份运行 PowerShell
- 网络问题：配置 npm 镜像源
npm config set registry https://registry.npmmirror.com - 路径冲突：检查是否有旧版本残留，彻底卸载后重新安装
2. 核心配置：config.toml 的 Windows 特调
2.1 配置文件位置与基础结构
Windows 下的 config.toml 文件位于 %USERPROFILE%\.codex\ 目录下。与 Unix 系统不同，Windows 的路径需要使用反斜杠，且环境变量引用方式也有差异。
基础配置示例：
model = "gpt-5-codex"
model_provider = "packycode"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"
[model_providers.packycode]
name = "packycode"
base_url = "https://codex-api.packycode.com/v1"
wire_api = "responses"
env_key = "PACKYCODE_CODEX_KEY"
