安装 Claude Code 和 Codex 并配置自定义 API 的核心思路是相通的：先通过包管理器安装工具，再通过环境变量或配置文件将 API 指向你选择的第三方服务商。下面的步骤以阿里云百炼平台为例，但配置方法同样适用于其他兼容的 API 提供商。
⚙️ 通用准备
在开始之前，请确保你的电脑上已安装 Node.js 18.0 或更高版本 。
🤖 安装与配置 Claude Code
1. 安装 Claude Code
你可以使用 npm 来全局安装。
npm install -g @anthropic-ai/claude-code
安装后，运行 claude --version 验证是否成功。
2. 配置自定义 API
Claude Code 通过读取环境变量来切换 API 提供商。需要修改它的设置文件来永久配置这些变量。
配置文件路径：
- macOS/Linux:
~/.claude/settings.json - Windows:
C:\Users\<你的用户名>\.claude\settings.json
如果文件不存在，可以手动创建。在文件中填入以下内容（以阿里云百炼的 Token Plan 团队版为例），并将 YOUR_API_KEY 替换为你的真实密钥：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.7-max",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
"CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max"
}
}
各个环境变量的含义如下：
ANTHROPIC_AUTH_TOKEN: 你的 API Key，用于认证。ANTHROPIC_BASE_URL: 你选择的 API 服务的网关地址。ANTHROPIC_BASE_URL不能带 /v1 后缀：Claude Code SDK 会自动追加/v1/messages，带上会导致请求路径变为 .../v1/v1/messages，返回 404。ANTHROPIC_MODEL: 默认调用的主模型。ANTHROPIC_DEFAULT_*_MODEL: 将 Claude Code 内部对不同能力档位（Opus, Sonnet, Haiku）的调用，映射到你指定的模型上。
3. 跳过首次登录 (可选)
Claude Code 默认会要求登录 Anthropic 账号。你可以创建一个 ~/.claude.json 文件，写入以下内容来跳过登录验证：
{
"hasCompletedOnboarding": true
}
即使用下面的命令
echo '{"hasCompletedOnboarding": true}' > ~/.claude.json
配置完成后，新开一个终端窗口，进入你的项目目录运行 claude 即可。
⌨️ 安装与配置 Codex
1. 安装 Codex
同样使用 npm 进行全局安装：
npm install -g @openai/codex
安装后，运行 codex --version 验证。
注意：部分第三方 API 提供商可能只支持旧版 Codex (如 0.80.0)，如果遇到问题可以尝试安装指定版本：
npm install -g @openai/codex@0.80.0。
2. 配置自定义 API
Codex 的配置分为两步：设置环境变量和修改配置文件。
第一步：设置 API Key 环境变量
在终端中将你的 API Key 设置为环境变量 OPENAI_API_KEY。
- macOS/Linux (Zsh/Bash):
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc source ~/.zshrc - Windows (CMD):
setx OPENAI_API_KEY "YOUR_API_KEY" - Windows (PowerShell):
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
第二步：创建配置文件 config.toml
在用户目录下的 .codex 文件夹中创建 config.toml 文件。
- macOS/Linux:
~/.codex/config.toml - Windows:
C:\Users\<你的用户名>\.codex\config.toml
在文件中，你需要根据你使用的 API 服务商的接口类型（是更现代的 Responses API，还是传统的 Chat/Completions API），配置不同的内容。
如果使用 Responses API (通常用于较新模型和最新版 Codex)：
model_provider = "MyProvider"
model = "qwen3.7-max"
[model_providers.MyProvider]
name = "MyProvider"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
如果使用 Chat/Completions API (通常需要安装 Codex 0.80.0 版本)：
model_provider = "MyProvider"
model = "qwen3.7-plus"
[model_providers.MyProvider]
name = "MyProvider"
base_url = "https://coding-intl.dashscope.aliyuncs.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
配置要点：
model_provider后的名称需要与[model_providers.MyProvider]中的名称完全一致。base_url是服务的网关地址，需要根据你选择的平台和地域正确填写。wire_api字段是关键，它告诉 Codex 使用哪种 API 协议与后端通信。
配置完成后，新开一个终端窗口，进入项目目录运行 codex 即可开始使用。
💡 补充说明
- API 提供商的选择：上述步骤以阿里云百炼为例，但配置方法适用于所有兼容 Anthropic (Claude) 或 OpenAI (Codex) API 格式的服务，如 DeepSeek、腾讯云 TokenHub 等。你只需将
base_url和ANTHROPIC_AUTH_TOKEN/OPENAI_API_KEY替换为相应服务的值即可。 - CC Switch 工具：对于 Claude Code，如果你想在多个 API Key 或服务之间方便地切换，而不想每次手动修改
settings.json，可以尝试安装社区工具CC Switch，它能提供可视化的管理界面。
评论