Claude Code

Claude Code 是 Anthropic 提供的 AI 编程工具。Bita API 提供 Anthropic Messages 兼容接口，可以通过 Claude Code 的网关配置直接接入。

准备工作

开始前，请准备：

已安装的 Claude Code。
一个处于启用状态、仍有可用额度的 Bita API 密钥。
密钥所属分组可以使用的 Claude 模型 ID。

如果尚未创建密钥或选择模型，请阅读创建 API 密钥和选择模型。

安装 Claude Code

macOS、Linux 或 WSL

使用官方安装脚本：

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

macOS 也可以使用 Homebrew：

brew install --cask claude-code

Windows

Windows 用户可以直接下载安装 Claude 桌面应用：

打开 Claude 官方下载页面。
下载适合当前设备的 Windows 安装程序；ARM64 设备请选择 ARM64 版本。
双击安装程序，按照页面提示完成安装。
启动 Claude，在应用中使用 Code 功能打开本地项目。

如果需要在 PowerShell、命令提示符或 WSL 中使用 claude 命令，请再按照 Claude Code 官方 CLI 安装说明安装终端版本。

安装终端版本后可以检查版本：

claude --version

Windows 桌面版配置

通过官方下载页面安装的 Claude 桌面应用不会读取 Claude Code CLI 的 settings.json，需要在应用内配置 Bita API：

打开 帮助（Help）→ 故障排查（Troubleshooting）。
启用 开发者模式（Enable Developer Mode），等待应用重新启动。
打开 开发者（Developer）→ 配置第三方推理（Configure Third-Party Inference）。
在连接配置中填写：

配置项填写内容
Inference provider Gateway
Gateway base URL https://www.bita-api.com
Gateway API key 完整的 Bita API 密钥
Credential kind Static API key
Gateway auth scheme Bearer
保存配置并重新打开应用。
在 Code 中选择 Bita API 返回的 Claude 模型，打开一个本地项目并发送消息。

配置项	填写内容
Inference provider	`Gateway`
Gateway base URL	`https://www.bita-api.com`
Gateway API key	完整的 Bita API 密钥
Credential kind	`Static API key`
Gateway auth scheme	`Bearer`

Bita API 提供 /v1/models，桌面应用会尝试自动读取模型。模型选择器为空时，请检查 API 密钥分组是否包含 Claude 模型。

配置 Claude Code CLI

以下配置适用于 macOS、Linux、WSL 和 Windows 终端版 Claude Code。推荐把配置写入 Claude Code 的用户设置，使其对本机所有项目生效：

系统	用户设置文件
macOS、Linux、WSL	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

如果 .claude 目录或 settings.json 不存在，可以手动创建。将下面内容保存到该文件：

settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bita-api.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_BITA_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_CLAUDE_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_CLAUDE_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_CLAUDE_MODEL_ID"
  }
}

替换以下内容：

YOUR_BITA_API_KEY：完整的 Bita API 密钥。
YOUR_CLAUDE_MODEL_ID：从模型广场复制的 Claude 模型 ID。

第一次接入时，可以先把四个模型配置都设为同一个确认可用的模型。验证成功后，再分别配置 Opus、Sonnet 和 Haiku。

Base URL 只填写站点根地址

ANTHROPIC_BASE_URL 必须填写 https://www.bita-api.com。Claude Code 会自动请求 /v1/messages，不要在地址后添加 /v1 或 /v1/messages。

为什么使用 `ANTHROPIC_AUTH_TOKEN`

Claude Code 会把 ANTHROPIC_AUTH_TOKEN 作为 Bearer Token 发送：

Authorization: Bearer YOUR_BITA_API_KEY

Bita API 支持这种鉴权方式。不要同时设置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY，避免 Claude Code 检测到多个凭据来源。

配置不同模型

Claude Code 会在主对话、模型别名和后台任务中使用不同的模型配置：

配置项	用途
`ANTHROPIC_MODEL`	Claude Code 启动时使用的主模型
`ANTHROPIC_DEFAULT_OPUS_MODEL`	选择 `opus` 或计划模式中的 Opus 阶段时使用
`ANTHROPIC_DEFAULT_SONNET_MODEL`	选择 `sonnet` 时使用
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	选择 `haiku`以及部分轻量后台任务时使用

如果密钥分组内提供多个 Claude 模型，可以分别填写实际 ID：

settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bita-api.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_BITA_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_SONNET_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_OPUS_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_SONNET_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_HAIKU_MODEL_ID"
  }
}

每个模型都必须属于 API 密钥可用的分组。不要仅根据模型名称猜测 ID，应从 Bita API 模型广场复制。

在模型选择器中显示 Bita API 模型

较新版本的 Claude Code 可以从网关读取模型列表。需要时，在 env 中增加：

"CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"

启动 Claude Code 后使用 /model，从标记为 From gateway 的模型中选择。该功能需要较新的 Claude Code 版本；如果列表没有出现，可以继续使用 ANTHROPIC_MODEL 指定模型。

启动并验证

进入项目目录后启动 Claude Code：

cd your-project
claude

进入交互界面后：

发送一条简单消息，确认可以正常回复。
输入 /status。
确认 Anthropic base URL 显示 https://www.bita-api.com。
确认凭据来源显示 ANTHROPIC_AUTH_TOKEN。
输入 /model，检查当前模型是否为 Bita API 中实际可用的模型。

如果已经登录过 Claude.ai，网关凭据会优先于保存的登录信息。出现凭据冲突时，可以在 Claude Code 中执行 /logout，然后重新启动。

临时切换模型

只为当前会话指定模型：

claude --model YOUR_CLAUDE_MODEL_ID

也可以在交互界面中运行：

/model YOUR_CLAUDE_MODEL_ID

临时切换不会修改 Bita API 密钥的分组权限。如果目标模型不属于当前密钥分组，请更换密钥或选择该分组可用的模型。

VS Code 扩展

Claude Code 的 VS Code 扩展会在启动前自行检查凭据。若扩展仍显示登录界面，可以打开 VS Code 的用户设置 JSON，加入：

VS Code settings.json
{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://www.bita-api.com"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_BITA_API_KEY"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "YOUR_CLAUDE_MODEL_ID"
    }
  ]
}

保存后完全关闭并重新打开 VS Code。

常见问题

现象	建议检查
启动后仍要求登录	用户设置文件路径是否正确、JSON 是否有效；使用 `/status` 检查配置是否加载
返回 `401`	`ANTHROPIC_AUTH_TOKEN` 是否为完整 API 密钥；是否同时存在其他凭据配置
返回 `403`	密钥是否启用、过期、超额，分组是否支持当前模型
返回 `404` 或请求路径含 `/v1/v1/messages`	把 Base URL 改为 `https://www.bita-api.com`
返回模型不存在	模型 ID 是否与模型广场完全一致，密钥分组是否可用
主对话正常，后台任务失败	检查 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 等映射是否指向可用模型
`/model` 中没有目标模型	启用网关模型发现，或通过 `ANTHROPIC_MODEL`、`--model` 直接指定
VS Code 扩展仍要求登录	在 VS Code 用户设置中配置 `claudeCode.environmentVariables` 并重启编辑器
配置正确但调用失败	查看 Bita API 使用日志中的接口、模型和错误信息

Claude Code 会持续更新，安装方式和配置项以 Claude Code 安装说明、网关接入说明及模型配置说明为准。

如果希望通过图形界面管理多个服务商，也可以使用上一节的 CC Switch。

下一步：Codex。

准备工作​

安装 Claude Code​

macOS、Linux 或 WSL​

Windows​

Windows 桌面版配置​

配置 Claude Code CLI​

为什么使用 ANTHROPIC_AUTH_TOKEN​

配置不同模型​

在模型选择器中显示 Bita API 模型​

启动并验证​

临时切换模型​

VS Code 扩展​

常见问题​