Claude Code 接入

Claude Code 使用 Anthropic Messages 协议。它的 Base URL 与 OpenAI 客户端不同， 应填写 https://freedomz.cn，不要在末尾添加 /v1。

1. 准备信息

• Key 分组需要支持 Anthropic Messages 协议。
• 目标模型必须对当前 Key 可用。
• 如果网关模型名与 Claude Code 默认值不同，需要显式指定模型。

2. 安装 Claude Code

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex
claude --version

macOS、Linux 或 WSL：

curl -fsSL https://claude.ai/install.sh | bash
claude --version

3. 当前终端临时配置

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://freedomz.cn"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "MODEL_ID_FROM_V1_MODELS"
claude

macOS / Linux：

export ANTHROPIC_BASE_URL="https://freedomz.cn"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="MODEL_ID_FROM_V1_MODELS"
claude

ANTHROPIC_AUTH_TOKEN 适用于 Bearer Token 网关。不要同时设置会冲突的旧 ANTHROPIC_API_KEY、官方登录代理或其他网关变量。

4. 持久化配置

Claude Code 用户设置通常位于 ~/.claude/settings.json。官方网关配置支持：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://freedomz.cn",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "MODEL_ID_FROM_V1_MODELS"
  }
}

该文件会以明文保存密钥。个人设备需要限制文件权限；共享设备或生产环境应通过 凭据管理和进程环境注入，不要把此文件提交到仓库。

5. VS Code 扩展

Claude Code 扩展可在 VS Code 用户设置中配置网关环境变量：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://freedomz.cn" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_API_KEY" },
    { "name": "ANTHROPIC_MODEL", "value": "MODEL_ID_FROM_V1_MODELS" }
  ]
}

保存后重新加载 VS Code 窗口。

6. 验证

1. 启动 Claude Code。
2. 发起一句最小文本请求。
3. 打开 使用记录。
4. 核对请求时间、Key、模型和费用。

部分后台任务可能使用 Claude Code 自带的模型别名。若主对话成功但后台功能出现 model not found，需要检查当前分组是否支持这些别名或按控制台配置模板调整。

常见错误

现象	处理
404 或 /v1/v1/messages	Base URL 改为 https://freedomz.cn
401	检查 ANTHROPIC_AUTH_TOKEN，停止重试
model not found	设置 ANTHROPIC_MODEL 或检查分组支持
仍要求官方登录	清理冲突登录态，确认网关环境变量在启动前已设置
CLI 成功、VS Code 失败	在扩展设置中配置变量并重新加载窗口

更多网关字段见 Claude Code 官方 LLM Gateway 文档。