人在国内？先看 Claude Code 国内稳定接入（国内直连、支付宝或银行卡充值）和国内配置教程（429/DNS 排查）。本文是与地区无关的通用接入步骤。
Claude Code 是 Anthropic 官方的 CLI 工具，让你直接在终端中使用 Claude。默认情况下，它直连 Anthropic API——能用，但你看不到花费明细，没有预算管控，API 挂了也没有备用方案。
通过 Router One 来连接 Claude Code 只需要大约两分钟，就能获得按请求的用量追踪、自动预算管控，以及平台自带的完整可观测能力。下面是具体的配置步骤。
前置条件
开始之前，请确认你已经准备好：
- 已安装 Claude Code ——如果还没有，请参考官方安装指南
- 一个 Router One 账号 ——如果需要注册，前往 router.one
就这些。不需要额外的依赖或工具。
第一步：获取 Router One API Key
登录 Router One，进入控制台 → API 密钥。点击创建密钥，起一个有辨识度的名字，比如「claude-code-personal」或「claude-code-work」。
复制生成的 API Key，下一步会用到。Key 以 sk- 开头，请妥善保管；之后如果找不到了，也可以在密钥列表里点掩码 Key 旁的眼形图标（查看密钥）再次查看。
在控制台里顺便看一下你的可用余额。Router One 采用预充值模式，确保余额足够你的预期用量。
一条命令可完成下面两步并验证 Key：curl -fsSL https://router.one/install/claude-code.sh | bash -s -- sk-your-router-one-key——Windows 与手动版本见 CLI 配置指南。
第二步：将 Claude Code 指向 Router One
Claude Code 从 shell 环境变量中读取 Anthropic 兼容的端点和凭证。这让配置过程非常简洁，也与官方 CLI 的工作方式保持一致。
在当前 shell 中导出这两个变量：
export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_AUTH_TOKEN=sk-your-router-one-api-key
unset ANTHROPIC_API_KEY
将 sk-your-router-one-api-key 替换为你在第一步中复制的实际 API key。
各变量的作用：
ANTHROPIC_BASE_URL——告诉 Claude Code 将请求发送到 Router One 的 Anthropic 兼容网关，而不是直连 Anthropic。ANTHROPIC_AUTH_TOKEN——接第三方网关时，Claude Code 就是用它作为Authorization: Bearer发送认证凭证。把它设为你的 Router One Key。ANTHROPIC_API_KEY——不需要设置。当前版本设了它启动时会多弹一次授权确认，所以保持未设即可；如果之前设过，请在同一个 shell 里unset，并从~/.zshrc或~/.bashrc里删掉。
第三步：让配置永久生效
如果你希望这些配置在新开终端后仍然生效，把上面两行 export 添加到 shell 配置文件（~/.zshrc 或 ~/.bashrc）；顺手把里面残留的 ANTHROPIC_API_KEY 那行删掉。
第四步：固定模型别名
按 Claude Code 更新日志与模型配置文档（2026-09-29 核对），Claude Code 2.1.284（2026 年 9 月 28 日）把 sonnet 别名指向 Claude Sonnet 5.5，发出的 ID 是 claude-sonnet-5-5。Router One 自 2026-09-29 起列出 claude-sonnet-5-5，但 2026-09-29 的套餐接口里 Pro、Max、Ultra 都没有档位列出它，所以用套餐时，凡是经过 sonnet 别名的请求——/model sonnet、定义为 model: sonnet 的子 agent、/statusline 以及 opusplan 的执行阶段——都按 token 从钱包扣费。请固定这几个别名；Sonnet 这一行让这些请求改用 Claude Sonnet 5，它在三个套餐的「中级模型」档：
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5
Haiku 这一行可选，用于让后台任务改用 Claude Haiku 4.5，而不是跟随主模型。按 Claude Code 2.1.296 的更新日志、模型配置与子 agent 文档（2026-10-10 核对），2.1.293 起 haiku 别名解析到 Claude Haiku 5.5（claude-haiku-5-5）；截至 2026-10-10 的模型目录，Router One 已列出它，但 2026-10-10 的套餐接口里没有档位列出它。不加这一行时，/model haiku、定义为 model: haiku 的子 agent 和内置的 claude-code-guide 子 agent（子 agent 文档写明它用 Haiku）都按 token 从钱包扣费；加上这一行，它们改用 Claude Haiku 4.5（三个套餐的「普通模型」档）。Fable 这一行把 fable 别名指向 Claude Fable 5：按 Claude Code 2.1.296 的模型配置文档（2026-10-10 核对），不固定时这个别名解析到 Claude Fable 5.1（claude-fable-5-1），截至 2026-10-09 的模型目录，Router One 已不再列出它；截至 2026-10-09 的套餐接口，Claude Fable 5 不在任何套餐档位，按 token 从钱包扣费。用钱包、想让 sonnet 别名用 Claude Sonnet 5.5 的，可以去掉 Sonnet 这一行。
套餐用户： Claude Code 2.1.280 及以后的版本在没有固定模型时会发送 claude-opus-5-5；截至 2026-09-29 的套餐接口，Pro、Max、Ultra 都没有任何档位列出 Claude Opus 5.5，这些调用会按 token 从钱包扣费。想继续消耗套餐额度，再把模型固定到套餐「高级模型」档覆盖的 Claude Opus 5：
export ANTHROPIC_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
ANTHROPIC_MODEL 决定会话使用的模型；ANTHROPIC_DEFAULT_OPUS_MODEL 把 opus 别名也指向 Opus 5，这样 /model opus 和定义为 model: opus 的子 agent 同样走套餐。Claude Sonnet 5 在三个套餐的「中级模型」档，Claude Haiku 4.5 在「普通模型」档；Claude Fable 5 不在任何档位，按钱包扣费。如果用的是一键安装脚本，请把这些键写进 ~/.claude/settings.json 的 env 块——那里的值会覆盖 shell 里的 export。详细说明见 Claude Code 默认 Opus 5.5 之后怎么配。
第五步：验证是否生效
打开一个新的终端窗口，启动 Claude Code：
claude
发送一条简单消息，确认连接正常：
> Hello, can you confirm this is working?
如果收到正常响应，配置就完成了。所有请求现在都通过 Router One 转发。
再到 Router One 的控制台 → 日志（请求日志）确认一下，你应该能看到刚才发出的请求，包括使用的模型、消耗的 token 数和费用。
充分利用这套配置的建议
按请求核对你的用量
每个 Claude Code 请求都会记入 Router One 控制台 → 日志——消耗的 token、单次请求费用、使用的模型和响应延迟；刷新页面（或切回该标签页）即可看到最新记录。如果你重度使用 Claude Code 来做开发工作，这尤其有用，因为长时间的编码会话中 token 用量增长很快。
把控制台加个书签，定期查看，了解你的使用模式。
设置按 Key 的消费上限
进入控制台 → API 密钥，为 Claude Code 使用的 Key 设置 maxSpend。达到上限后，这把 Key 会停止继续消费。多个开发者或项目共享一个钱包时，应分别创建独立 Key，隔离各自用量和风险。
为每个项目使用独立 API Key
如果你跨多个项目工作，请为每个项目创建独立 API Key，分别设置消费上限。控制台 → 日志支持按模型、API Key、状态和日期筛选，控制台 → 用量可按 API Key 查看花费、Token 和请求数，所以一个项目一把 Key 就能直接看到各项目的成本。需要细到 Key 以下（按任务或按次运行）归因时，在客户端或应用日志中保存自己的标签与请求 ID。
长时间会话前检查余额
针对复杂重构或大型代码库的 Claude Code 会话可能消耗大量 token。在开始重要会话前快速看一眼 Router One 余额，可以避免中途被打断。
妥善保管 API Key
在生产环境或共享机器上，将 Router One key 写入 shell 配置文件，而不是每次在终端里手动输入：
export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_AUTH_TOKEN="sk-your-router-one-api-key"
故障排除
「Authentication failed」错误 ——仔细检查 API key 是否正确，以及 Router One 账户余额是否为正。key 区分大小写。另外确认当前 shell 里没有 ANTHROPIC_API_KEY：接第三方网关时 Claude Code 认的是 ANTHROPIC_AUTH_TOKEN，残留的 ANTHROPIC_API_KEY 只会多弹一次授权确认。完整清单见 Claude Code 403 排查页。
「Connection refused」错误 ——确认 ANTHROPIC_BASE_URL 是 https://api.router.one，结尾没有多余的斜杠或路径。
响应缓慢 ——网关自身开销很小；大陆端到端延迟实测见中国延迟基准。如果感觉响应慢了，在 Router One 控制台 → 日志查看延迟指标。问题更可能出在上游供应商的延迟，而非网关本身。
配置没有生效 ——导出变量后请打开一个新的终端窗口，或者在启动 claude 之前在当前 shell 中重新执行 export 命令。
常见问题
如何把 Claude Code 连接到 Router One？
在 shell 中导出 ANTHROPIC_BASE_URL=https://api.router.one，并把 ANTHROPIC_AUTH_TOKEN 设为你的 Router One API key，再把同样的 export 写入 shell 配置文件（~/.zshrc 或 ~/.bashrc）。整个配置过程只需要大约两分钟。
使用 Router One 时需要设置 ANTHROPIC_API_KEY 吗？
不需要。当前版本设了它启动时会多弹一次授权确认；接第三方网关时 Claude Code 用 ANTHROPIC_AUTH_TOKEN 作为 Authorization: Bearer 发送认证凭证，所以保持 ANTHROPIC_API_KEY 未设置，并从 ~/.zshrc 或 ~/.bashrc 里删掉残留的那行。
如何确认 Claude Code 的请求走的是 Router One？
打开新终端运行 claude，发送一条测试消息，然后到 Router One 的控制台 → 日志（请求日志）查看——你应该能看到刚才发出的请求，包括使用的模型、消耗的 token 数和费用。
Claude Code 报「Authentication failed」错误怎么办？
仔细检查 API key 是否正确、Router One 账户余额是否为正，key 区分大小写；并确认当前 shell 里没有残留的 ANTHROPIC_API_KEY（有就 unset 掉），完整清单见 Claude Code 403 排查页。
通过 Router One 调用会让 Claude Code 变慢吗？ 网关自身开销很小；大陆端到端延迟实测见中国延迟基准。如果感觉响应慢了，可在 Router One 控制台 → 日志查看延迟指标——问题更可能出在上游供应商的延迟，而非网关本身。
接下来做什么
将 Claude Code 连接到 Router One 之后，每个请求都会被追踪、计量，并受到预算管控的保护。你获得的是完全一样的 Claude 体验，外加对花费和用量的完整可见性。
探索 Router One 控制台，查看请求分析，并为每把 Key 设置 maxSpend 消费上限（速率限制按平台默认值生效，可申请调高）。如果你还在使用 Claude Code 之外的其他 AI 工具，请为每个工具创建独立 Key，再通过同一网关转发和追踪用量。同一个 /v1/messages 端点也承接 Claude 的服务端 web_search 与 code_execution 工具，供你自己的 API 调用使用——见通过 API 使用 Claude 联网搜索与代码执行。
前往 router.one 注册或登录，开始使用。