本文整合了 Claude Code、Codex、Gemini 等 AI 编程工具的配置方法，包括命令行工具和 VS Code 插件。

Claude Code 命令行

安装

1
npm install -g @anthropic-ai/claude-code

配置文件

系统 路径
Windows %USERPROFILE%\.claude\settings.json
macOS/Linux ~/.claude/settings.json

编辑配置文件：

1
2
3
4
5
# Windows
notepad $env:USERPROFILE\.claude\settings.json

# macOS/Linux
vim ~/.claude/settings.json

写入配置：

1
2
3
4
5
6
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.example.com/claude",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx"
  }
}

配置完成后直接运行 claude 即可。

Claude Code VS Code 插件

如果你更喜欢在 VS Code 中使用 Claude Code，可以安装插件并配置自定义 API。

安装插件

从 VS Code 扩展市场安装 Claude Code 插件。

配置 API 地址

  1. 打开 VS Code 设置（Ctrl+, 或 Cmd+,）
  2. 搜索 claude-code.environmentVariables
  3. 点击 Edit in settings.json
  4. 添加配置：
1
2
3
4
5
6
7
8
{
  "claude-code.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.example.com"
    }
  ]
}

配置 API Key

插件从 ~/.claude/config.json 读取 API 密钥：

macOS / Linux:

1
2
mkdir -p ~/.claude
echo '{"primaryApiKey": "your-api-key"}' > ~/.claude/config.json

Windows:

1
2
New-Item -ItemType Directory -Force -Path "$HOME\.claude"
Set-Content -Path "$HOME\.claude\config.json" -Value '{"primaryApiKey": "your-api-key"}'

重启 VS Code 后，点击活动栏的 Claude 图标即可开始使用。

Codex CLI

安装

1
npm install -g @openai/codex

配置文件

系统 路径
Windows %USERPROFILE%\.codex\config.toml
macOS/Linux ~/.codex/config.toml

写入配置：

1
2
3
4
5
6
7
8
model = "gpt-5"
model_provider = "openai-chat-completions"

[model_providers.openai-chat-completions]
name = "PROXY"
base_url = "https://api.example.com/v1"
env_key = "PROXY_OPENAI_API_KEY"
wire_api = "chat"

设置环境变量

Codex 需要额外配置环境变量：

Windows:

1
2
3
4
5
# 临时
$env:PROXY_OPENAI_API_KEY = "sk-xxxx"

# 永久
[System.Environment]::SetEnvironmentVariable('PROXY_OPENAI_API_KEY', 'sk-xxxx', 'User')

macOS/Linux:

1
2
3
4
5
6
# 临时
export PROXY_OPENAI_API_KEY="sk-xxxx"

# 永久
echo 'export PROXY_OPENAI_API_KEY="sk-xxxx"' >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc

Gemini CLI

安装

1
npm install -g @google/gemini-cli

配置方式

Gemini 没有专门的配置文件，使用环境变量或 .env 文件。

方法一：.env 文件

1
2
3
4
5
6
# Windows: notepad $env:USERPROFILE\.env
# macOS/Linux: vim ~/.env

GOOGLE_GEMINI_BASE_URL=https://api.example.com/gemini
GEMINI_API_KEY=sk-xxxx
GEMINI_MODEL=gemini-2.5-pro

方法二：环境变量

Windows:

1
2
3
[System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_BASE_URL', 'https://api.example.com/gemini', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'sk-xxxx', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_MODEL', 'gemini-2.5-pro', 'User')

macOS/Linux:

1
2
3
4
5
6
7
cat >> ~/.bashrc << 'EOF'
export GOOGLE_GEMINI_BASE_URL=https://api.example.com/gemini
export GEMINI_API_KEY=sk-xxxx
export GEMINI_MODEL=gemini-2.5-pro
EOF

source ~/.bashrc

工具对比

工具 配置方式 环境变量 难度
Claude Code CLI JSON 配置文件 不需要 简单
Claude Code 插件 VS Code 设置 + JSON 不需要 简单
Codex TOML 配置 + 环境变量 需要 中等
Gemini CLI 环境变量或 .env 需要 简单

注意事项

API Key 安全

把配置文件加到 .gitignore：

1
2
3
.env
settings.json
config.toml

文件权限

macOS/Linux:

1
2
3
chmod 600 ~/.claude/settings.json
chmod 600 ~/.codex/config.toml
chmod 600 ~/.env

Windows:

1
icacls "$env:USERPROFILE\.claude\settings.json" /inheritance:r /grant:r "$env:USERNAME:F"

环境变量持久化

系统 配置文件
Windows 系统环境变量或 $PROFILE
macOS ~/.zshrc（默认 Zsh）
Linux ~/.bashrc 或 ~/.zshrc

常见问题

问题 解决方案
找不到配置目录 手动创建：mkdir ~/.claude
环境变量不生效 Windows 重启终端，macOS/Linux 执行 source ~/.bashrc
切换不同 API Codex 可配多个 model_providers，修改 model_provider 字段

使用建议

  • 推荐：命令行版 Claude Code 比 VS Code 插件更好用
  • 如果使用官方服务，直接登录更方便，不需要这些自定义配置
  • Codex 支持多 provider 切换，适合需要在不同 API 间切换的场景

参考资料