BestAI Docs

外观

Claude Code 接入指南 ​

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

开始前准备 ​

  • 已注册 BestAI 账号。
  • 已在 API Keys 创建 Key，并分配到支持 Claude 的分组。
  • 终端中可以运行 claude；如果还不能运行，先按官方安装指南选择当前系统的安装方式。

推荐方式：使用控制台配置 ​

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

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

控制台手工示例和安装器可能使用不同的认证变量。BestAI 支持 ANTHROPIC_API_KEY（x-api-key 请求头）和 ANTHROPIC_AUTH_TOKEN（Bearer 请求头）。本文手工路径统一使用前者；如果采用控制台的后一种方案，整套保持一致即可。不要同时保留两个不同的 Key，也不要把有用的另一服务配置直接覆盖。

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

macOS / Linux / WSL ​

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

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

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

Windows PowerShell ​

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 ​

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

临时变量只对当前窗口及其启动的进程生效。设置后直接在同一个窗口进入“验证”步骤，确认正常后再保存长期配置。上面的命令用于说明字段；直接把真实 Key 粘进命令可能进入 shell 历史，长期配置优先通过本机编辑器保存。

长期配置 ​

方式一：Claude Code 专用 settings.json ​

文件位置：

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

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

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

先备份原文件。若本次切换到 ANTHROPIC_API_KEY，检查用户与项目的 Claude 配置中是否残留旧 ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper。设置文件里的 env 可以覆盖终端变量；仅执行 unset 并不能清除文件中的旧值。在 Claude Code 内用 /status 核对实际地址和认证来源，不输出完整 Key。

方式二：Shell 环境变量 ​

macOS / Linux：

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

用本机编辑器将上述两行合并到 Zsh 的 ~/.zshrc 或 Bash 的 ~/.bashrc，替换占位符，再打开新终端。已有同名字段时修改原值，不反复追加。不需要同时配置 settings.json 和 shell 两条路径。

验证 ​

先退出已有的 Claude Code，再在刚设置临时变量的同一个窗口运行；长期配置保存后，可在重新加载配置的窗口运行：

bash
claude --version
claude

进入后先运行 /status 核对 Base URL 和认证来源，再发送一条短验证句：

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

接入完成必须同时满足：

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

回复不必逐字相同。暂时没有使用记录时，先刷新、检查日期和 Key/模型筛选，再核对当前会话的地址与认证来源；不能仅凭缺少记录就断定请求走了其他服务。

Claude Code + VS Code ​

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

先在外部终端验证 CLI，再在 VS Code 执行 Preferences: Open User Settings (JSON)，合并下面字段。它是 VS Code 的用户设置，不是项目 .vscode/settings.json：

json
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.bestai.chat" },
    { "name": "ANTHROPIC_API_KEY", "value": "sk-你的Key" }
  ]
}

如果原数组已有其他项目，保留它们，只更新本次变量。官方说明指出：~/.claude/settings.json 中的变量能传给子进程，但扩展自身的登录检查可能仍需要这个入口。设置完成后重启扩展，新建会话并单独核对使用记录。集成终端能读到变量，不等于扩展也读到了。

不要把完整 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 填基础地址：

text
https://api.bestai.chat

不要填：

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

有回复但没有记录 ​

先刷新使用记录，检查日期和 Key/模型筛选，再用 /status 核对配置。临时配置要在原终端重启 Claude Code，避免换窗口后变量丢失。

重启终端后配置消失 ​

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

Key 可能泄露 ​

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

完成标准 ​

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

配置依据 ​

核对日期：2026-10-03。Claude Code 官方网关指南说明认证变量、配置优先级、/status 和 VS Code 的设置入口。BestAI 分组是否支持所选模型，仍以模型广场与实际请求为准。

模型、协议与价格以当前分组和使用记录为准。

© 2026 BestAI