Claude Code 默认使用 Anthropic 官方 API。如果你需要切换到其他兼容 Anthropic 接口的服务商（如第三方代理、自建网关等），可以通过手动编辑配置文件来实现。本文介绍如何通过修改本地配置文件来切换 API 端点和模型。
前置条件
- 已安装 Claude Code（参考 Claude Code 安装指南）
- 拥有兼容 Anthropic API 的 API Key
清除旧环境变量
在配置新的 API 之前，请确保清除已有的 Anthropic 相关环境变量，避免配置冲突：
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL
如果这些变量在 ~/.bashrc 或 ~/.zshrc 中被永久导出，请同步删除对应行，否则新开的 shell 会再次注入旧配置。
编辑配置文件
Step 1: 编辑 settings.json
编辑或创建 Claude Code 的配置文件：
- macOS / Linux:
~/.claude/settings.json - Windows:
用户目录\.claude\settings.json
将以下内容写入配置文件，将 YOUR_API_KEY 和 YOUR_BASE_URL 替换为你的实际值：
{
"env": {
"ANTHROPIC_BASE_URL": "YOUR_BASE_URL",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
"ANTHROPIC_SMALL_FAST_MODEL": "claude-sonnet-4-20250514",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-sonnet-4-20250514",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-3-5-20241022"
}
}
Step 2: 设置 onboarding 标记
编辑或创建 ~/.claude.json 文件：
- macOS / Linux:
~/.claude.json - Windows:
用户目录\.claude.json
{
"hasCompletedOnboarding": true
}
这一步跳过了 Claude Code 的首次启动引导流程。如果不设置，启动时可能会被引导到官方登录流程。
环境变量说明
| 变量名 | 说明 |
|---|---|
| ANTHROPIC_BASE_URL | API 端点地址，使用代理或兼容服务填写对应地址 |
| ANTHROPIC_AUTH_TOKEN | API Key，用于接口身份验证 |
| API_TIMEOUT_MS | 请求超时时间（毫秒），建议3000000适配长耗时任务 |
| CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 设为1禁用遥测等非必要网络请求，第三方API推荐开启 |
| ANTHROPIC_MODEL | 默认调用的模型名称 |
| ANTHROPIC_SMALL_FAST_MODEL | 轻量高速模型，适配简易任务 |
| ANTHROPIC_DEFAULT_SONNET_MODEL | Sonnet系列默认模型 |
| ANTHROPIC_DEFAULT_OPUS_MODEL | Opus系列默认模型 |
| ANTHROPIC_DEFAULT_HAIKU_MODEL | Haiku系列默认模型 |
验证配置
启动 claude 后，在 TUI 中依次输入以下 slash 命令确认配置生效：
/status
/model
/status应显示ANTHROPIC_BASE_URL指向你配置的地址/model应显示当前模型为你配置的模型名称
项目级配置
除了全局配置，你还可以在项目根目录创建 .claude/settings.json 来覆盖全局配置，实现不同项目使用不同的 API 端点或模型：
{
"env": {
"ANTHROPIC_MODEL": "claude-opus-4-20250514"
}
}
项目级配置优先级高于全局配置，适合需要为特定项目指定不同模型的场景。
常见问题
1. 启动后仍走官方 API
检查环境变量是否被 ~/.bashrc 或 ~/.zshrc 中的旧配置覆盖。运行 env | grep ANTHROPIC 查看当前环境变量。
2. 模型不可用
确认你的 API Key 有对应模型的访问权限，且模型名称与 API 服务商支持的名称一致。
3. 连接超时
检查网络连接和 Base URL 是否正确。如果使用代理，确认 ANTHROPIC_BASE_URL 配置无误，必要时设置 HTTPS_PROXY 环境变量。
← 返回文章列表使用 Wishmere 管理你的 AI Agent
Wishmere 内置 Gateway 代理，可以在 Web 界面中一键切换不同的 API 配置和模型，无需手动编辑配置文件。所有操作都有完整的日志和回滚能力。