在 Claude Code 中使用 6bee.ai

Claude Code 可以连接任何支持 Anthropic Messages 格式的服务。改三个环境变量，它就运行在 6bee.ai 的模型上。

开始之前

已安装 Claude Code（npm install -g @anthropic-ai/claude-code）。
用已验证的邮箱注册账户，预付费充值后，在控制台的「API 密钥」页创建密钥，并妥善保管。
模型 ID 可以在控制台查看，也可以用 GET https://api.6bee.ai/v1/models 获取。把 <模型 id> 换成其中一个。

设置环境变量

在启动 Claude Code 的终端里执行：

shell

export ANTHROPIC_BASE_URL=https://api.6bee.ai
export ANTHROPIC_AUTH_TOKEN=<你的密钥>
export ANTHROPIC_MODEL=<模型 id>
export ANTHROPIC_DEFAULT_HAIKU_MODEL=<模型 id>   # 后台任务使用
claude

ANTHROPIC_BASE_URL: 6bee.ai 的地址，不带 /v1。Claude Code 会自己加上 /v1/messages。
ANTHROPIC_AUTH_TOKEN: 你的 6bee.ai 密钥，以 Bearer 令牌发送。
ANTHROPIC_MODEL: 主对话使用的模型。
ANTHROPIC_DEFAULT_HAIKU_MODEL: 生成标题、摘要等后台任务使用的模型。需要一并设置，否则这些请求会去找 6bee.ai 没有上架的模型。

长期生效

不想每次打开终端都 export，可以把变量写进 Claude Code 的设置文件：

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.6bee.ai",
    "ANTHROPIC_AUTH_TOKEN": "<你的密钥>",
    "ANTHROPIC_MODEL": "<模型 id>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<模型 id>"
  }
}

这个文件以明文保存密钥，不要提交到代码仓库。

确认可用

在项目目录里启动 claude。
发一条简短的消息，回复来自你设置的模型。
打开控制台的使用日志，可以看到这次请求的 token 数和费用。

长会话需要注意的限额

上下文: 输入加输出不超过模型窗口：按模型不同，为 128K 至 1M token。
输出: max_tokens 最高到模型的输出上限：按模型不同，为 16,384 至 131,072。超出时自动降到上限，不会拒绝请求。不传时默认 8,192 至 32,768。
输入: 滚动每分钟 100 万未命中缓存的 token，缓存命中不计。
请求频率: 每分钟 60 次。
并发: 同时 2 个请求。
请求体: 不超过 8 MiB，n 必须为 1。

超出限额返回 HTTP 429 和 Retry-After；请求放不进上下文时返回 400。输出上限被降低时，响应头 X-6bee-Output-Cap 会注明实际上限；在 /v1/messages 上，thinking 预算会一并降低。

排错

HTTP 401: 密钥缺失或不正确。从控制台重新复制，不要带空格或引号。
提示模型不存在: 模型 ID 不匹配。用 GET /v1/models 查看可用的 ID，或到控制台核对。
HTTP 429: 超出了账户限额（请求频率、输入 token 或并发）。响应头 Retry-After 给出需要等待的秒数。
长会话中出现 HTTP 400: 请求已经放不进模型的上下文窗口。压缩或清空对话，或换用窗口更大的模型。
因余额不足被拒绝: 每次请求会先预扣「输入 + max_tokens 输出」。充值，或调低 max_tokens。
请求了你没有设置的模型: 同时设置 ANTHROPIC_DEFAULT_HAIKU_MODEL。Claude Code 的后台任务使用它。