ai2saveai2save

Claude Code 配置教程

Claude Code 使用 Anthropic Messages 协议。接入 ai2save 时,地址填站点根地址 https://ai2save.com,不要手动追加 /v1;密钥使用 ai2save 控制台创建的 sk-...。

1. 准备 API Key

  1. 打开 https://ai2save.com/keys。
  2. 点击「创建密钥」,填写名称并选择包含 Claude 模型的分组。
  3. 创建后立即复制完整 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

进入交互界面后:

  1. 输入一句短问题,例如「你好,介绍一下你自己」。
  2. 能正常返回内容,说明地址、密钥和模型分组已连通。
  3. 需要切换模型时使用 /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 后重新打开。