自带 Key(BYOK)已上线,每月 1,000,000 次免费 BYOK 请求,不需要充值了解详情

编程 agent

编程工具

在各类负载里,AI 编程 agent 消耗的 token 最多,也最容易碰上厂商的速率限制和订阅时间窗。下面每个工具在 BoostRail 上都有原生端点:Claude Code 走 Anthropic Messages 协议,其余走 OpenAI 协议。所以切换到 BoostRail 大约只要 30 秒:把 base URL 指向 BoostRail,填上一个 Key。

从零到第一次调用

1

创建 API Key

注册后在控制台创建一个 Key。这一页的所有工具都能用这个 Key,目录里的任何模型也都能调用。

创建 Key

2

粘贴配置

在下面选你的工具,复制对应的配置。只改 base URL 和 Key,提示词、工作流和编辑器设置都保持原样。

跳到配置

3

确认接通

开始长会话之前,先发一次调用。几秒钟就能知道配置有没有生效。

运行检查

每个工具一段配置,复制即用

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 Key

Aider 读取标准的 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