配置 Claude Code 接入 BytePass

Claude Code 是 Anthropic 官方的终端编程助手。本教程教你如何将它连接到 BytePass，无需直接注册 Anthropic 账号即可使用 Claude 模型。

预计耗时： 5–10 分钟（使用 CC-Switch 可缩短至 2 分钟内）

前置条件

npm install -g @anthropic-ai/claude-code

macOS/Linux 遇到权限问题可用 sudo npm install -g @anthropic-ai/claude-code，或修改 npm 全局路径。

如果你已安装 CC-Switch，直接到 bytepass.ai/keys 点击 Key 旁边的 「导入到 CCS」 按钮即可，无需手动配置。

在你的 shell 配置文件（~/.zshrc、~/.bashrc 或 ~/.bash_profile）中添加：

export ANTHROPIC_BASE_URL="https://api.bytepass.ai"
export ANTHROPIC_AUTH_TOKEN="sk-你的bytepass-key"

然后重新加载：

source ~/.zshrc

注意： Base URL 是 https://api.bytepass.ai，末尾不要加 /v1。Claude Code 会自动补全路径。

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.bytepass.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的bytepass-key"
  }
}

这和 CC-Switch 写入的是同一个文件。如果已有其他配置项，只需添加或更新 env 字段。

打开新终端，运行：

claude

输入任意消息。如果收到 Claude 的回复，配置成功。

一直弹出登录页面

首次运行 claude 时可能会尝试浏览器登录。配置好 API Key 后应该不会再弹出。如果仍然出现，确保你打开了新终端。

401 Unauthorized（未授权）

400 Bad Request 或「URL 无效」

可能是在 Base URL 后面多加了 /v1。正确地址是 https://api.bytepass.ai，不带尾部路径。

连接超时或拒绝连接

检查网络连接
测试 API 是否可达：curl https://api.bytepass.ai/v1/models -H "Authorization: Bearer 你的KEY"

环境变量不生效