在 Claude Code 中使用 OpenBridger
Claude Code 使用 Anthropic Messages 协议。网关对应的路径是 POST /v1/messages。密钥可以放在 x-api-key(Claude Code 会这么做),网关在这条路径上接受它。
模型名必须是 模型广场 里的完整 ID,而且当前分组要有能处理 Messages 请求的线路。只在广场里看得到名字还不够,需要实际发一条短请求并用 使用日志 确认。
开始之前
- 已安装
claude命令。 - 一把名为
claude-code的 API Key。 - 知道你要使用的模型 ID。
当前终端临时生效
export ANTHROPIC_BASE_URL="https://openbridger.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
cd /path/to/your/project
claude
ANTHROPIC_BASE_URL 是站点根,不要写成 https://openbridger.com/v1。Claude Code 会自己请求 {BASE}/v1/messages。写成带 /v1 的地址会变成 /v1/v1/messages。
关掉这个终端后变量就没了。恢复官方服务:
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN
然后新开终端再运行 claude。
写进 Claude Code 的配置
~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://openbridger.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
}
}
这个文件里有密钥,不要提交,不要截图。项目目录里的 .claude/settings.json 同样不要写入真实密钥。
如果客户端允许指定模型,把值设成广场上的完整 ID。Claude Code 默认发出的模型名如果和广场不一致,会得到 503「无可用渠道」或上游的 model not found。以日志里记录的模型 ID 为准。
检查当前终端实际生效的变量:
env | grep ANTHROPIC_
只确认变量在不在,不要把输出贴到聊天或工单。
常见问题
| 现象 | 处理 |
|---|---|
| 仍要求登录官方账号 | 新开终端,确认两个 ANTHROPIC_ 变量已导出,再启动 claude |
| 401 | 重新复制密钥。不要在 token 前面再加 Bearer |
| 503 无可用渠道 | 广场中的模型 ID 与 Claude Code 发出的名字不一致,或该分组没有 Messages 线路 |
| 请求没进使用日志 | Base URL 还指着官方主机。用 `env |
协议要对上
Chat Completions 可用,不等于 Claude Code 可用。需要模型、分组和 /v1/messages 同时成立。