Claude Code 配置教程
Claude Code 使用 Anthropic Messages 协议。接入 ai2save 时,地址填站点根地址 https://ai2save.com,不要手动追加 /v1;密钥使用 ai2save 控制台创建的 sk-...。
1. 准备 API Key
- 打开 https://ai2save.com/keys。
- 点击「创建密钥」,填写名称并选择包含 Claude 模型的分组。
- 创建后立即复制完整 Key。完整 Key 只显示一次。
2. 安装 Claude Code
先完成 Node.js 环境安装,然后执行:
npm install -g @anthropic-ai/claude-code
claude --version
如果版本低于网关要求,按提示升级:
npm update -g @anthropic-ai/claude-code
3. 当前终端临时启用
macOS / Linux / WSL:
export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude
Windows PowerShell:
$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude
ANTHROPIC_AUTH_TOKEN 是中转站密钥专用变量。不要同时把 ANTHROPIC_API_KEY 设置为其他官方 Key,避免 Claude Code 读取到错误凭据。
4. 写入 Claude Code 配置文件(推荐)
编辑 ~/.claude/settings.json(Windows 通常在 %USERPROFILE%\.claude\settings.json):
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://ai2save.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
}
}
保存后重新打开终端并启动 claude。如果只想在某个项目生效,把同样内容写入项目内的 .claude/settings.local.json,不要把真实 Key 提交到 Git。
5. 选择模型并验证
claude --model claude-sonnet-4-6
进入交互界面后:
- 输入一句短问题,例如「你好,介绍一下你自己」。
- 能正常返回内容,说明地址、密钥和模型分组已连通。
- 需要切换模型时使用
/model,模型 ID 必须与控制台开放的 ID 一致。
也可以先用 Claude Code 内置诊断查看配置状态:
/status
/doctor
6. 多配置与旧配置清理
如果之前登录过官方 Claude 或其他中转站:
- 优先使用 CC Switch 管理多个供应商,避免手工改错配置。
- 手工配置时,确认没有旧的
ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY覆盖当前值。 - WSL 和 Windows 是两套环境;在 Windows 终端配置后,WSL 内还需要单独配置。
macOS / Linux 临时清理:
unset ANTHROPIC_API_KEY
常见报错
- 401 / invalid_api_key:Key 未复制完整、已撤销,或分组不含当前模型。
- 404 / model not found:模型 ID 不正确,或该 Key 分组未开放此模型。
- 连接失败:Base URL 写成
https://ai2save.com/v1会出错;Claude Code 应填https://ai2save.com。 - 仍然请求官方地址:检查
~/.claude/settings.json、项目.claude/settings.local.json和终端环境变量中是否残留旧地址。 - Windows 打开后不生效:完全退出终端、VS Code 或 Claude Desktop 后重新打开。