编程 agent
编程工具
在各类负载里,AI 编程 agent 消耗的 token 最多,也最容易碰上厂商的速率限制和订阅时间窗。下面每个工具在 BoostRail 上都有原生端点:Claude Code 走 Anthropic Messages 协议,其余走 OpenAI 协议。所以切换到 BoostRail 大约只要 30 秒:把 base URL 指向 BoostRail,填上一个 Key。
从零到第一次调用
每个工具一段配置,复制即用
Claude Code 用 Anthropic 原生的 Messages 协议,对接 BoostRail 的 /v1/messages 端点。其余工具用 OpenAI 协议:Codex CLI 走 /v1/responses,另外四个走 Chat Completions。不管哪种协议,都是同一个 Key、同一个目录:设好 base URL,粘贴你的 BoostRail API Key,模型 ID 可以填目录里的任意模型。
Anthropic 原生协议,走 /v1/messages。写进 ~/.claude/settings.json,桌面端启动和后台 agent 也能读到;只在 shell 里 export 的话,它们读不到。
// ~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.boostrail.com",
"ANTHROPIC_API_KEY": "你的 API Key",
"ANTHROPIC_MODEL": "claude-sonnet-5",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
"CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
}
}
// 验证:启动 claude 后输入 /status,
// base URL 应显示 api.boostrail.com。
// 非 Claude 模型:把 ANTHROPIC_MODEL 设为目录里的任意 ID,
// 例如 deepseek-v4.1-flash。/model 选择器只列出 claude 系列。在 ~/.codex/config.toml 里加一段 provider 配置,并导出你的 Key。Codex 用 Responses 协议,BoostRail 的 /v1/responses 端点原生支持。
# ~/.codex/config.toml
model = "claude-sonnet-5"
model_provider = "boostrail"
[model_providers.boostrail]
name = "BoostRail"
base_url = "https://api.boostrail.com/v1"
env_key = "BOOSTRAIL_API_KEY"
wire_api = "responses"
# 在 shell 里:export BOOSTRAIL_API_KEY=你的 API Key在 VS Code 的 Cline 设置面板里,选 OpenAI Compatible,按下面填写。
# Cline → Settings → API Provider
API Provider: OpenAI Compatible
Base URL: https://api.boostrail.com/v1
API Key: 你的 API Key
Model ID: claude-sonnet-5在 opencode.json(项目根目录或 ~/.config/opencode/)里,把 BoostRail 声明为 provider。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"boostrail": {
"npm": "@ai-sdk/openai-compatible",
"name": "BoostRail",
"options": {
"baseURL": "https://api.boostrail.com/v1",
"apiKey": "{env:BOOSTRAIL_API_KEY}"
},
"models": {
"claude-sonnet-5": { "name": "Claude Sonnet 5" }
}
}
}
}在 ~/.continue/config.yaml 里加一条模型配置,provider 设为 openai,并用 apiBase 指定地址。
# ~/.continue/config.yaml
models:
- name: BoostRail Claude Sonnet 5
provider: openai
model: claude-sonnet-5
apiBase: https://api.boostrail.com/v1
apiKey: 你的 API KeyAider 读取标准的 OpenAI 兼容环境变量,把它们指向 BoostRail 即可。
export OPENAI_API_BASE=https://api.boostrail.com/v1
export OPENAI_API_KEY=你的 API Key
aider --model openai/claude-sonnet-5- 配置默认用 claude-sonnet-5,这是多数编程 agent 常用的旗舰模型。把模型 ID 换成目录里的任意模型,比如 claude-opus-4.8、gpt-5.4、deepseek-v4.1-flash,其他都不用动。base URL 和 Key 不变。
- 「你的 API Key」是占位符:在控制台创建 Key 后粘贴进去。
- 用的是 OpenClaw?长时间运行的 agent 有单独的接入页,里面有 openclaw.json 的 provider 配置。 OpenClaw 接入
确认已经接通
粘贴配置后先运行一次这条命令。它能分清是配置问题还是模型问题:前者两分钟就能改好,不必花一小时去猜。
直接调用 API 的一条命令
curl https://api.boostrail.com/v1/chat/completions \
-H "Authorization: Bearer 你的 API Key" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"reply with OK"}]}'接通后会返回一段 JSON,里面有 choices 数组和模型的回复。几秒钟内,控制台就会显示这次请求的用量和实际适用的价格。
401 未授权
请求里没有带上 Key。确认粘贴的是 Key 本身而不是 Key 的名称,并且改完配置后重启过工具。
400 model_not_found
这个模型 ID 不在目录里。请从模型页复制 ID;ID 必须完全一致,例如 claude-sonnet-5。
curl 能通,工具不通
工具还在读旧配置。Claude Code 要把配置写进 ~/.claude/settings.json(在 shell 里 export 的变量,桌面端启动和后台 agent 读不到);VS Code 插件需要重新加载窗口。
为什么让编程 agent 走 BoostRail
编程 agent 是行业里消耗 token 最多的一类:长文件、工具调用循环、反复带上的上下文,让高负载成了常态。用官方订阅时,会碰上约 5 小时的用量窗口;直接用 API 的等级额度时,会在任务中途碰上每分钟限速。
BoostRail 用一个 API 提供主流模型,支持 OpenAI 和 Anthropic 两种格式。你现在用的工具照常工作,只换 base URL 和 Key。没有订阅时间窗,也没有按等级设的速率限制。
要付的和不用付的
对 token 消耗大的编程负载,要紧的是这几项:
agent 负载的价格更划算
主流模型的价格不高于官方牌价,每款模型的价格都公开在模型页。每次请求以控制台显示的实时价格为准。
没有用量窗口
agent 和模型之间没有约 5 小时的订阅用量窗口。长会话和高强度循环不受订阅时间限制。
编程工具常见问题
为什么有些 Qwen 模型有上下文上限?
阿里云对这些模型按用量分档计价,输入越长,每个 token 的单价要贵好几倍。BoostRail 按所覆盖那一档的官方价格,给每款定一个固定单价,并把输入限制在那一档以内(两款 coder 模型 ≤120K,qwen3.7-plus/flash ≤240K)。超过上限的请求会在扣费之前返回 context_length_exceeded,编程 agent 会自动压缩上下文继续。需要 1M 上下文时,可以用 qwen3.7-max,它只有一个官方价格,没有上限。
每个工具要分别配一个 Key 吗?
不用。一个 BoostRail API Key 可以用在这里的所有工具上(Claude Code、Codex CLI、Cline、OpenCode、Continue、Aider),对接同一个 base URL。
Claude Code 的扩展思考能用吗?
能。Claude Code 的思考设置会按承接这款模型的线路转换后传过去,模型会进行思考。思考内容本身不会以 thinking 块返回,你拿到的是回答和工具调用。线路无法应用这个设置时,响应头 x-boostrail-degraded 会注明。
用 Claude Code 接 BoostRail,还有什么要注意的?
有两点。token 计数:BoostRail 不提供 /v1/messages/count_tokens,Claude Code 会改用自己的本地估算,这是官方支持的做法。工具结果里的图片(例如读取截图文件)会换成一段文字占位;消息里正常的图片输入不受影响。
Codex CLI 只支持 Responses 协议,真的能用吗?
能。BoostRail 以无状态方式提供 /v1/responses:消息、function 工具和流式输出,走的是和 Chat Completions 相同的线路与计费。详见文档里的 Responses 接口说明。
切换过来会影响现有配置吗?
不会。只改 base URL 和 Key,工具、提示词和工作流都不变。任何时候都可以把 base URL 改回厂商的地址,不存在锁定。
agent 负载怎么计价?
按 token 以美元计费,主流模型的价格不高于官方牌价。模型所在线路支持提示词缓存时,命中缓存的输入按这款模型公布的缓存读取价计费;除 DeepSeek V4 Pro、DeepSeek V4.1 Flash 和 Kimi K3 外,不高于厂商官方的缓存读取价。缓存写入不加价。每款模型的实时 token 单价都公布在模型页。
把 agent 接到 BoostRail
创建一个 Key,粘贴到你用的工具里,就能接着写代码,目录里的任何模型都能用。
更新日期:2026-10-03