Claude Code 接入指南

速查配置

项目	值
Base URL 环境变量	ANTHROPIC_BASE_URL
API Key 环境变量	ANTHROPIC_AUTH_TOKEN
Base URL	https://api.bestai.chat
API Key	你在控制台创建的 Key（sk- 开头）

接入方式

Claude Code 支持两种配置方式，选一种即可。

方式一：环境变量（推荐）

在 ~/.zshrc（macOS）或 ~/.bashrc（Linux）末尾添加：

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

保存后执行 source ~/.zshrc 或重新打开终端。

方式二：Claude Code settings.json

编辑 ~/.claude/settings.json，添加 env 字段：

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

如果文件已有其他内容，只需合并 env 字段即可。

重要说明

• ANTHROPIC_AUTH_TOKEN 是 Claude Code 读取的环境变量名，不要改
• sk-你的Key 替换为你实际的 BestAI API Key
• 不要在终端输出 Key 的值，避免泄露到日志
• 如果之前设置过 ANTHROPIC_API_KEY，Claude Code 优先读取 ANTHROPIC_AUTH_TOKEN

验证

打开新终端，启动 Claude Code：

claude

发送验证句：

请只回复：BestAI 已连接。

成功标准：

1. Claude Code 正常回复
2. 余额页面 出现对应请求记录

Claude Code + VS Code

VS Code 中的 Claude Code 扩展共享终端环境变量。只要 shell 配置了 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，在 VS Code 内置终端启动的 Claude Code 会自动使用 BestAI。

如果 VS Code 读不到环境变量，确认：

• VS Code 是从终端启动的（code .），不是从 Dock 直接打开
• 或者在 VS Code settings 中配置 terminal.integrated.env.osx

临时切换 vs 长期配置

方式	作用范围	适合场景
终端 export	仅当前终端窗口	临时测试
~/.zshrc	所有新终端	日常使用
~/.claude/settings.json	Claude Code 专用	不影响其他工具

常见问题

认证失败 (401)

按顺序检查：

1. Key 是否以 sk- 开头，且完整复制（没有多余空格或换行）
2. 环境变量名是否是 ANTHROPIC_AUTH_TOKEN（不是 ANTHROPIC_API_KEY）
3. 账户余额是否充足：查看余额
4. 运行 echo $ANTHROPIC_AUTH_TOKEN | head -c 5 确认变量已加载

请求没走 BestAI

运行：

echo $ANTHROPIC_BASE_URL

输出应该是 https://api.bestai.chat。如果为空或是其他地址，说明环境变量没生效。

清理旧配置

如果之前用过其他服务，确保清理：

unset ANTHROPIC_API_KEY

ANTHROPIC_AUTH_TOKEN 优先级高于 ANTHROPIC_API_KEY，但同时存在可能导致混淆。