AI 编程工具配置指南

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

Claude Code 命令行

安装

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

配置文件

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

编辑配置文件：

# Windows
notepad $env:USERPROFILE\.claude\settings.json

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

写入配置：

{
  "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. 添加配置：

{
  "claude-code.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.example.com"
    }
  ]
}

配置 API Key

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

macOS / Linux:

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

Windows:

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

安装

npm install -g @openai/codex

配置文件

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

写入配置：

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:

# 临时
$env:PROXY_OPENAI_API_KEY = "sk-xxxx"

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

macOS/Linux:

# 临时
export PROXY_OPENAI_API_KEY="sk-xxxx"

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

---

Gemini CLI

安装

npm install -g @google/gemini-cli

配置方式

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

方法一：.env 文件

# 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:

[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:

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：

.env
settings.json
config.toml

文件权限

macOS/Linux:

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

Windows:

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 间切换的场景

参考资料

• Claude Code 官方文档
• CSDN - Claude Code 配置教程