Claude Code 接入指南

适合想在本地项目中使用 Claude Code 的用户。目标是完成一次短验证，并在使用记录中看到对应请求。

开始前准备

• 已注册 BestAI 账号。
• 已在 API Keys 创建 Key，并分配到支持 Claude 的分组。
• 终端中可以运行 claude；如果还不能运行，先安装 Claude Code，再回来配置网关。

推荐方式：使用控制台一键安装

1. 打开 API Keys。
2. 找到要使用的 Key，打开“使用密钥”或配置提示。
3. 选择 Claude Code，复制当前系统对应的一键安装命令或配置。
4. 只在自己的本机执行；不要把包含 Key 的命令发到聊天或仓库。
5. 回到本页的“验证”步骤。

控制台生成的地址可能来自站点当前配置；如果它和本文示例不同，以控制台显示为准。

当前一键安装器会把 Key 保存为 ANTHROPIC_API_KEY。如果旧版配置里还有 ANTHROPIC_AUTH_TOKEN，不要让两个变量同时存在；按下面的手工配置方式清理旧值。

手工方式：当前终端临时验证

macOS / Linux / WSL

export ANTHROPIC_BASE_URL="https://api.bestai.chat"
export ANTHROPIC_API_KEY="sk-你的Key"
unset ANTHROPIC_AUTH_TOKEN

检查变量是否存在，但不要打印 Key：

test -n "$ANTHROPIC_BASE_URL" && echo "ANTHROPIC_BASE_URL is set"
test -n "$ANTHROPIC_API_KEY" && echo "ANTHROPIC_API_KEY is set"

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://api.bestai.chat"
$env:ANTHROPIC_API_KEY="sk-你的Key"
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue

Windows CMD

set ANTHROPIC_BASE_URL=https://api.bestai.chat
set ANTHROPIC_API_KEY=sk-你的Key
set ANTHROPIC_AUTH_TOKEN=

临时变量只对当前窗口生效。先用它验证一次，确认服务正常后再保存长期配置。

长期配置

方式一：Claude Code 专用 settings.json

文件位置：

• macOS / Linux：~/.claude/settings.json
• Windows：%USERPROFILE%\.claude\settings.json

如果文件不存在，可以创建；如果已经有内容，只合并 env 字段，不要覆盖其他设置：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.bestai.chat",
    "ANTHROPIC_API_KEY": "sk-你的Key"
  }
}

如果原文件中已有 ANTHROPIC_AUTH_TOKEN，删除或改用本文的 ANTHROPIC_API_KEY，避免旧认证值被优先读取。

方式二：Shell 环境变量

macOS / Linux：

cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL="https://api.bestai.chat"
export ANTHROPIC_API_KEY="sk-你的Key"
EOF
source ~/.zshrc

如果你使用 Bash，把 ~/.zshrc 换成 ~/.bashrc。不要同时维护多份互相矛盾的地址和 Key。

验证

先完全退出已有的 Claude Code，再在新的终端窗口运行：

claude --version
claude

发送一条短验证句：

请只回复：BestAI Claude Code 已连接。

接入完成必须同时满足：

1. Claude Code 返回验证句对应的回复。
2. 使用记录 中出现刚才时间附近的请求。

只看到回复、没有使用记录，说明当前会话可能仍然使用旧 Provider 或官方地址。

Claude Code + VS Code

VS Code 扩展、VS Code 集成终端和外部终端可能使用不同的环境继承方式。

排查顺序：

1. 先在外部终端验证 claude 能正常连接。
2. 在 VS Code 集成终端运行 test -n "$ANTHROPIC_API_KEY"，确认变量存在。
3. 在 VS Code 中完全重启 Claude Code 扩展，再发送短验证句。
4. 如果扩展有独立的环境配置入口，按扩展当前界面填写同一组地址和 Key。

不要把完整 Key 写进项目仓库的 .vscode/settings.json。

常见问题

401 / 403

• Key 是否完整，是否仍是 sk-你的Key。
• ANTHROPIC_API_KEY 是否存在。
• 是否残留 ANTHROPIC_AUTH_TOKEN。
• Key 对应分组是否支持 Claude。
• 账户余额或 Key 额度是否可用。

404 或 URL 解析失败

Claude Code 的 ANTHROPIC_BASE_URL 填基础地址：

https://api.bestai.chat

不要填：

https://api.bestai.chat/v1/messages
https://api.bestai.chat/v1

有回复但没有记录

关闭 Claude Code 后重新打开，确认新环境变量已加载；然后到 使用记录 按时间查找。

重启终端后配置消失

你只执行了临时 export。将配置写入 settings.json 或 shell 配置文件，并打开一个新终端验证。

Key 可能泄露

不要尝试继续使用旧 Key。打开 API Keys 停用旧 Key，创建新 Key，再更新本机配置。

完成标准

• claude 可以启动并返回验证句。
• 使用记录 有对应请求。
• 你知道 Key 保存在哪个文件或环境变量中。
• 真实 Key 没有进入仓库、截图或公开日志。