让所有 AI 编程工具走同一个网关

Router One 是所有 AI 编程工具共用的 LLM API 网关：Claude Code（Anthropic 兼容端点）、OpenAI Codex CLI（原生 Responses API）和任何 OpenAI 兼容 agent 共用一个钱包、各拿一把带消费上限的 Key，每次请求都留下成本 Trace，覆盖 30+ 个模型，全球与中国大陆均可直连。不走网关的话，每个工具都要自己的 Key、计费账户和 base URL，而且每一个都可能悄悄烧光预算。

立即接入

网关给编程工作流带来什么

Claude Code 原生接入

把 ANTHROPIC_BASE_URL 指向 https://api.router.one，Claude Code 即走网关——工作流不变，背后多了 Trace、预算和故障转移。

Codex CLI 原生接入

OpenAI Codex CLI 把 Router One 注册为 model provider（base_url https://api.router.one/v1），一条命令配置完成，之后每个 Codex 请求都和你技术栈的其他流量一样被计量、追踪、限额。

任何 OpenAI 兼容 agent

Cline、Aider、Zed、Continue 等支持自定义 OpenAI 兼容 base URL 的工具同理——改 URL 和 Key，工作流照旧。

每工具一把 Key，每把 Key 一个预算

给每个工具独立 API Key，各设消费上限（maxSpend）；限流与每分钟 Token 上限按平台默认值执行，可申请调高。陷入重试循环的 agent 只会撞上自己的上限，掏不空公共钱包。

每请求一条成本 Trace

每次工具调用都进面板：模型、API Key、Token、成本、总耗时（产生过输出的流式请求另有首字延迟）、状态。开销到底花在哪个工具、哪类任务上，终于有了答案。

故障时自动转移

指定模型的请求遇到可重试上游错误时，网关可能尝试另一个能提供同一模型的健康线路。控制台 → 日志记录模型、请求 ID 和请求指标，不公开实际上游身份与线路。

TRAE / TraeCode

在 TRAE 的模型设置里添加自定义模型，关闭「完整 URL」开关：API 格式选 OpenAI Chat Completions，基础地址填 https://api.router.one/v1，所有对话模型都能用；选 Anthropic Messages 则填 https://api.router.one，适用于 Claude 与 DeepSeek V4 的 ID。

Qoder

Qoder 桌面端（0.1.8 起）的自定义模型可以填自己的 Base URL：供应商选 OpenAI Compatible，再选 Chat Completions（所有对话模型）或 Responses（GPT、DeepSeek V4 与 Grok 对话模型），接口地址填 https://api.router.one/v1。

CodeBuddy

CodeBuddy 通过 models.json 添加自定义模型，目前只支持 OpenAI 兼容格式；url 字段要填完整接口路径 https://api.router.one/v1/chat/completions。

Hermes Agent

运行 hermes model，选择 Custom endpoint，填 https://api.router.one/v1 并选 Chat Completions；也可以在 config.yaml 中把 Router One 写成命名 provider。上下文长度与 compression.threshold_tokens 请按成本取舍，见完整指南。

GitHub Copilot CLI

把 COPILOT_PROVIDER_BASE_URL 设为 https://api.router.one/v1，COPILOT_PROVIDER_WIRE_API 设为 completions，COPILOT_MODEL 填精确的目录 ID；按 GitHub 说明，BYOK 不需要登录 GitHub。

所有编码 agent 共用一个钱包

编码 agent 是最容易失控的工作负载：会话长、失败就重试、还会随团队扩散。把它们放到一个网关后面，你得到一个带 Key 级归因的预付费钱包——所有工具花同一笔余额，每个请求按公示模型费率计价，每把 Key 的上限决定单个 agent 最多能花多少。充值走同一个托管收银台的支付宝或银行卡，也支持 6 条链上的 USDT/USDC。

每个工具一条命令

Claude Code 走 Anthropic 兼容端点；Codex CLI 把 Router One 注册为 model provider。两条一键命令分别完成安装 CLI、写入配置、验证 Key——其他 OpenAI 兼容工具把 base URL 指向网关即可。

# 让 Claude Code 和 Codex 都走同一个网关
curl -fsSL https://router.one/install/claude-code.sh | bash -s -- sk-your-router-one-key
curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-router-one-key

# 让 Claude Code 和 Codex 都走同一个网关
$env:ROUTER_ONE_API_KEY = "sk-your-router-one-key"; irm https://router.one/install/claude-code.ps1 | iex
$env:ROUTER_ONE_API_KEY = "sk-your-router-one-key"; irm https://router.one/install/codex.ps1 | iex

常见问题

哪些 AI 编程工具可以接入 Router One？

Claude Code（走 Anthropic 兼容端点）、OpenAI Codex CLI，以及任何支持自定义 OpenAI 兼容 base URL 的工具——包括 Cline、Aider、Hermes Agent、GitHub Copilot CLI（BYOK），以及通过自定义模型设置接入的 TRAE（TraeCode）、Qoder 桌面端和 CodeBuddy（CLI 与 IDE）。只要工具允许配置 base URL 和 API Key，就能走网关。

Claude Code 怎么配置？

把 ANTHROPIC_BASE_URL 设为 Anthropic 兼容端点，使用你的 Router One Key。完整步骤（含验证与排障）见 Claude Code 中国页。

Codex CLI 怎么配置？

运行 CLI 配置指南里的一键命令——它会把 Router One 注册为 ~/.codex/config.toml 里的 model provider，并通过 ROUTER_ONE_API_KEY 环境变量读取你的 Key。完整指南见 Codex CLI 中国页。

可以给每个工具单独设预算吗？

可以。为每个工具建一把 API Key，分别设置消费上限；限流与每分钟 Token 上限按平台默认值执行，可申请调高。某个工具的 Key 触顶后，只有它需要钱包付费的请求停下，其他工具照常工作。

会话进行中供应商故障了怎么办？

指定模型的请求遇到可重试上游错误时，可能尝试下一个能提供同一模型的健康线路。增加的延迟取决于失败方式和重试，没有固定延迟保证。控制台 → 日志里的 Trace 展示模型、请求 ID 和请求指标，不公开供应商身份、上游渠道名称或内部重试线路；Trace 里唯一可见的渠道，是你所调用模型 ID 自带的销售渠道前缀（azure/、aws/ 或 vertex/）。

在哪里看每个工具花了多少钱？

控制台 → API 密钥会显示设了消费上限的 Key 已花多少——每个工具一把带上限的 Key，就等于每个工具一行账。控制台 → 用量可按 API Key 查看所选时间段的花费、Token 和请求数，并跳转到该 Key 的日志；控制台 → 日志支持按模型、API Key、状态和日期筛选，会标出发起请求的 Key，并可按当前筛选导出 CSV。给整个研发团队上 Claude Code 和 Codex 时，按同样的做法每人一把 Key；套餐额度和 Key 上限的关系、有人离职怎么处理，见团队接入指南（/blog/claude-code-codex-team-rollout）。

按所用编程工具选择配置页

请打开你所用工具的配置教程——每种客户端接入网关的方式不同，一种工具的配置不能直接套到另一种上。

Anthropic 兼容配置 Claude Code设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 并持久化，验证连接，再按 Key 设消费上限。Responses API配置 OpenAI Codex CLI在 config.toml 中注册 Codex 原生 provider 并使用 Responses wire API，看懂不支持 /v1/responses 的端点为什么返回 404。编辑器集成配置 Cursor覆盖 Cursor 的 OpenAI base URL，并从实时模型目录选择模型。国内直连国内使用 Claude Code国内无需 VPN 直连 Anthropic 兼容端点，用支付宝或银行卡为钱包充值。国内直连国内使用 Codex CLI国内无需 VPN、无需 ChatGPT Plus，Codex 直连 Responses 端点，按 Token 从钱包扣费。国内接入国内使用 Cursor把 Cursor 的模型调用改走国内可直连的端点，充值不需要境外信用卡。编辑器集成配置 Zed在 Zed 的 settings.json 注册 openai_compatible provider，按精确目录 ID 和上下文窗口列出模型，Key 放在系统凭据存储或 ROUTER_ONE_API_KEY 中。IDE 扩展Continue（已停止维护）最终版 2.x 仍可用每个模型一段 config.yaml 接入网关；指南同时列出有人维护的替代工具。VS Code、JetBrains 与 CLI配置 Cline选择 OpenAI Compatible provider，挑选支持工具调用的聊天 ID，并按模型设置上下文窗口与图像支持。JetBrains IDE配置 JetBrains AI Assistant把 AI Assistant 的 OpenAI 兼容 BYOK provider 指向带 /v1 的地址并分配聊天模型，核对哪些功能仍依赖 JetBrains AI。终端 agent配置 OpenCode在 opencode.json 里把网关注册为 OpenAI 兼容 provider，从实时目录选模型。终端编程 Agent配置 Pi Agent在 models.json 注册 Router One，明确 API 协议与精确模型 ID，再按供应商启动 Pi。终端 Agent配置 Crush在 crushrc 中把 Router One 加为 openai-compat 供应商，并固定两个模型槽位，让标题请求也走同一把 Key。桌面与命令行 agent配置 Goose用 OPENAI_HOST 把内置 OpenAI provider 指向主机根地址，请求路径保持默认，再用 GOOSE_MODEL 选目录里的模型。终端 agent配置 Qwen Code在 .qwen/.env 里设置 OPENAI_BASE_URL、OPENAI_API_KEY 与 OPENAI_MODEL，或在 modelProviders 里登记网关供 /model 选择器使用。终端结对编程配置 Aider设置 OPENAI_API_BASE，在完整目录 ID 前加 openai/，并告诉 Aider 如何对待它不认识的模型 ID。Xcode 26 与 27配置 Xcode 的聊天 provider添加一个 Internet Hosted 聊天 provider，URL 填主机根地址；/v1/models 与 /v1/chat/completions 由 Xcode 自行拼接。AI IDE配置 TRAE（TraeCode）添加自定义模型：OpenAI Chat Completions 格式填 /v1 基础地址；Claude 与 DeepSeek V4 的 ID 也可用 Anthropic Messages 格式填主机根地址。桌面端配置 Qoder添加 OpenAI Compatible 自定义模型，接口地址填 /v1，选 Chat Completions；GPT、DeepSeek V4 与 Grok 对话模型也可选 Responses。命令行与 IDE配置 CodeBuddy在 models.json 中用完整的 /v1/chat/completions 地址定义 Router One 模型，自行设置 Token 上限，并指定更便宜的 lite 模型。终端 agent配置 Hermes Agent用 hermes model 添加自定义端点，或在 config.yaml 写命名 provider，按模型 ID 选 transport，并自己设定上下文长度。终端 agent配置 GitHub Copilot CLI（BYOK）COPILOT_PROVIDER_BASE_URL 填 /v1 地址，wire API 设为 completions，COPILOT_MODEL 填精确的目录 ID。Agent 框架 Web UI配置 DeepSeek Harness在「设置 → 模型」中按协议添加「自定义模型 API」提供商：Chat Completions 与 Responses 填 /v1 地址，Anthropic Messages 填主机根地址。VS Code 扩展配置 Kilo Code用 Router One Key 把 Kilo Code agent 扩展指向网关。VS Code 扩展配置 GitHub Copilot（BYOK）在 Copilot Chat 里把网关加为 Custom Endpoint provider，并填写精确的目录模型 ID。对比GitHub Copilot BYOK vs Continue vs Cline三个 VS Code 扩展哪些功能跑在你自己的 Key 上、各自怎么配置，以及一把 Key 同时接入三者。其他客户端查看 SDK 与客户端配置指南每个支持的编程 agent、SDK、聊天客户端和 LLM 应用平台都有独立的分步教程，指向同一个端点。

给每个编码 agent 一个网关、一个预算。

立即接入