Claude Code
四步让 Claude Code 在 bInference Router 上运行,可用 Claude、GPT 或无审查模型。
bInference Router 使用和 Anthropic 相同的 Messages API,所以 Claude Code 可以直接连接它。不需要另外安装任何东西,除了 Claude Code 本身,你的电脑上也不用运行别的程序。每次调用都从你的 bInference 额度中支付。
你需要先安装好 Claude Code(运行 claude --version 能显示版本号),并且有一个带额度的 bInference 账户或 Agent。
创建密钥
在 binference.io 上点击创建密钥。账户密钥使用你自己的额度;Agent 密钥使用该 Agent 的 AI 预算。打开限制消费并设置每日上限:Claude Code 会循环工作,一个下午就可能发起几百次调用。
复制密钥。它只显示一次。
让 Claude Code 连接 Router
打开 ~/.claude/settings.json(Windows 上是 %USERPROFILE%\.claude\settings.json),加入下面这些内容。如果文件里已经有设置,就把 model 这一行和五个变量加进去。
{
"model": "sonnet",
"env": {
"ANTHROPIC_BASE_URL": "https://binference.io/api",
"ANTHROPIC_AUTH_TOKEN": "binf_...",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
}
}| 这一行 | 作用 |
|---|---|
model | 每个会话都从 Claude Sonnet 5.5 开始。不设置的话,Claude Code 会从更贵的 Opus 5.5 开始。 |
ANTHROPIC_BASE_URL | 把每次模型调用都发送到 Router。不要带 /v1:Claude Code 会自己加上。 |
ANTHROPIC_AUTH_TOKEN | 你的 binf_ 密钥。 |
ANTHROPIC_API_KEY | 保持为空,这样你电脑上其他地方设置的 Anthropic 密钥永远不会被一起发送。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 让 Claude Code 的后台小任务(比如给会话起名)使用 Haiku 4.5,而不是你的主模型。 |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | 把每次回答限制在 32,000 个 Token 以内,这样每一轮预留的额度更少。见每一轮预留多少。 |
密钥就在这个文件里
不要把 ~/.claude/settings.json 给别人,也永远不要把密钥写进项目的
.claude/settings.json:那个文件会被提交,克隆项目的每个人都能看到。
如果想先在一个终端里试用,就在那里设置同样的值。关闭终端后它们就会失效:
export ANTHROPIC_BASE_URL="https://binference.io/api"
export ANTHROPIC_AUTH_TOKEN="binf_..."
export ANTHROPIC_API_KEY=""
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32000
claude --model sonnet启动 Claude Code 并检查
在你的项目里运行 claude,然后输入 /status。看到这三行就说明设置成功:Auth token 显示 ANTHROPIC_AUTH_TOKEN,Anthropic base URL 显示 https://binference.io/api,Model 显示 Sonnet。
❯ /status
- cwd:
- ~/my-project
- Auth token:
- ANTHROPIC_AUTH_TOKEN
- Anthropic base URL:
- https://binference.io/api
- Model:
- sonnet (claude-sonnet-5-5)
随便发一条消息。这次调用会在一分钟内出现在你的调用记录页面上,并显示花费。
如果你还用 Claude 订阅登录了 Claude Code,设置了密钥后就会改用密钥。你的登录状态会保留:见回到你的 Claude 订阅。
推荐先用的模型
- Claude Sonnet 5.5默认日常编程
- Claude Opus 5.5大型代码库
- Claude Fable 5.1最难的任务
- Claude Haiku 4.5快速的小改动
- GPT-6.1 Sol智能体编程
- GPT-6 AstraOpenAI 的旗舰模型
- Abliterated Large v2无审查其他模型拒绝的请求
写这篇文档之前,以上每个模型都通过 Router 在 Claude Code 中实际运行过,都用 Claude Code 的工具读取了文件、执行了命令。模型页面中其他擅长使用工具的模型也一样可用:在 /model 后面填上它的 ID。
Claude Code 是为 Claude 模型打造的。GPT 和 Abliteration 的模型可以通过 Router 使用,但 Anthropic 不支持在 Claude Code 中使用它们,所以某些功能的表现可能不同。使用这些模型时,Claude Code 会提示它不认识这个模型,并在会话达到 200,000 个 Token 之前压缩。这是正常的。
在菜单中显示更多 Claude 模型: 在 env 中加入 "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",/model 就会按名称列出 Router 提供的每个 Claude 模型,包括旧版本。
每一轮预留多少
每次调用开始之前,Router 会预留足够的额度:够支付这次调用允许的最长回答,再加上到目前为止的对话。你只为模型实际写出的内容付费,其余部分在调用结束时退回。见调用如何付费。
Claude Code 会要求很长的回答:在 Opus 5.5 上最多 128,000 个 Token。会话刚开始时,这样每一轮大约预留 $2.40,Claude Code 同时运行的辅助任务也各自预留一份。用第 2 步设置的 32,000 上限后,同样的 Opus 一轮大约预留 $0.67,Sonnet 5.5 一轮大约 $0.33。对话越长,预留越多;GPT-6 Astra 这类更贵的模型,预留会多出好几倍。
- Haiku 4.5$0.18
- Abliterated Large v2$0.18
- Sonnet 5.5$0.33
- GPT-6.1 Sol$0.33
- Opus 5.5$0.67
- Fable 5.1402$1.53
- Opus 5.5无上限402$2.36
- GPT-6 Astra402$9.09
8 个中有 5 个能在 $1 内完成3 个会返回 402
Sonnet 5.5 的一轮:预留与实付
当你的额度不够预留时,Claude Code 会显示 API Error: 402,并说明余额低于这次请求的预留。可以调低 CLAUDE_CODE_MAX_OUTPUT_TOKENS(比如调到 16000),换一个更便宜的模型,或者充值额度。
实际花费则是另一回事:Claude Code 每一轮都会重新发送整个对话,而 Router 会原样传递它的缓存标记。在我们用 Sonnet 5.5 做的测试中,第二次调用从缓存中读取了 26,463 个 Token,花费大约只有第一次的十二分之一。
须知
- 长会话: 超过 4 MB 的请求会被拒绝并返回
413,通常是因为粘贴了截图。运行/compact或/clear。想更早压缩的话,在env中加入"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "400000"。 /cost显示的是 Anthropic 的价格, 不是你实际支付的金额。真实的扣费在调用记录页面上。/context的数字是估算: Router 不会在调用之前计算 Token 数,所以 Claude Code 会自己估算。- 自动模式可能会提示这个会话
isn't eligible,不能使用免费的安全检查。按 Enter 继续:这些检查会作为普通调用,使用你的密钥运行。不想看到这个提示,就在env中加入"CLAUDE_CODE_AUTO_MODE_SERVER": "0"。 - Remote Control 和语音输入需要登录 Claude,所以设置了密钥后无法使用。
- Claude 桌面应用: 它的 Code 标签页有自己的地址设置,不会读取这个文件。本页介绍的是在终端和 VS Code 中使用 Claude Code。
- VS Code 扩展: 把同样的变量写进 VS Code 自己的设置,放在
claudeCode.environmentVariables下,每项写成{ "name": "ANTHROPIC_BASE_URL", "value": "https://binference.io/api" }这样的格式。扩展启动前会在那里查找密钥。 - 让 Claude Code 查看自己的额度: 用同一个密钥连接 MCP 服务器,Claude Code 就能查看自己的余额、用量和限制。
回到你的 Claude 订阅
删除第 2 步加入的内容,或者删除整个 env 块,然后重新启动 Claude Code。你的 Claude 登录状态一直都在:/status 会重新显示它是登录方式。
遇到问题
| 你看到 | 解决方法 |
|---|---|
| Claude Code 要求你登录 | 它没有读到密钥。检查 ~/.claude/settings.json 的路径和 JSON,或者在同一个终端里设置这些值 |
/status 中没有 Anthropic base URL 这一行 | 和上面一样:设置没有传到 Claude Code |
401 和 invalid_api_key | 密钥错误或已撤销。在 API 密钥页面创建一个新的 |
402 并提示低于这次请求的预留 | 额度不够预留。见每一轮预留多少 |
402 和 key_limit | 密钥达到了消费上限。它会在 UTC 时间 00:00 重置,或者调高上限 |
413 | 对话超过了 4 MB。运行 /compact |
所有错误码都在错误页面上,附有处理方法。