Claude Desktop / Codex CLI 配置排错

1. claude_desktop_config.json 的 env / API Key

先纠正一个高频误解：claude_desktop_config.json 里没有文件级的 API Key 或 base URL 字段。它的 env 只属于某个 MCP server 进程，不会改变 Claude Desktop 自己的推理上游。

如果你只是给 MCP server 传 Key，这样写：

{
  "mcpServers": {
    "your-mcp-server": {
      "command": "npx",
      "args": ["-y", "your-mcp-server"],
      "env": {
        "API_KEY": "sk-cg-YOUR_KEY"
      }
    }
  }
}

macOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json； Windows：%APPDATA%\Claude\claude_desktop_config.json。改完完全退出并重启 Claude Desktop。

2. Claude Desktop developer mode：把整个应用指向网关

1. 打开 Claude Desktop → Help → Troubleshooting → Enable Developer Mode。
2. 菜单栏出现 Developer 后，进入 Developer → Configure Third-Party Inference…。
3. inferenceProvider 选择 gateway（或等价的自定义网关选项）。
4. inferenceGatewayBaseUrl 填 https://api.codegateway.dev。
5. inferenceGatewayApiKey 填你的 sk-cg- 开头 Key，保存并完全退出后重启 Claude Desktop。

网关需要实现 Anthropic Messages API（POST /v1/messages，含流式与 tool use）。 保存后如果仍走官方端点，先完全退出应用再重开；只关窗口不会重载配置。

3. codex cli install：安装并指向 CodeGateway

npm install -g @openai/codex
codex --version

安装后在 ~/.codex/config.toml 写入：

model_provider = "codegateway"

[model_providers.codegateway]
name = "codegateway"
base_url = "https://api.codegateway.dev/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false

自检（把 Key 换成你自己的）：

export OPENAI_API_KEY="sk-cg-YOUR_KEY"
codex exec "reply with the single word: ok"

常见报错对照

常见问题