Claude Code 是 Anthropic 官方的 CLI 工具，让你直接在终端中使用 Claude。默认情况下，它直连 Anthropic API——能用，但你看不到花费明细，没有预算管控，API 挂了也没有备用方案。
通过 Router One 来连接 Claude Code 只需要大约两分钟，就能获得实时用量追踪、自动预算管控，以及平台自带的完整可观测能力。下面是具体的配置步骤。
前置条件
开始之前，请确认你已经准备好：
- 已安装 Claude Code ——如果还没有，请参考官方安装指南
- 一个 Router One 账号 ——如果需要注册，前往 router.one
就这些。不需要额外的依赖或工具。
第一步：获取 Router One API Key
登录 Router One Dashboard，进入 API Keys 页面。点击 Create New Key，起一个有辨识度的名字，比如「claude-code-personal」或「claude-code-work」。
复制生成的 API key，下一步会用到。key 以 sk- 开头，且只显示一次，请妥善保存。
在 Dashboard 里顺便看一下你的可用余额。Router One 采用预充值模式，确保余额足够你的预期用量。
第二步：导出 Router One 环境变量
Claude Code 可以从 shell 环境变量中读取 Anthropic 兼容的端点和凭证。这让配置过程非常简洁，也与官方 CLI 的工作方式保持一致。
第三步：将 Claude Code 指向 Router One
在当前 shell 中导出以下变量：
export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_API_KEY=sk-your-router-one-api-key
export ANTHROPIC_AUTH_TOKEN=sk-your-router-one-api-key
将 sk-your-router-one-api-key 替换为你在第一步中复制的实际 API key。
各变量的作用：
ANTHROPIC_BASE_URL——告诉 Claude Code 将请求发送到 Router One 的 Anthropic 兼容网关，而不是直连 Anthropic。ANTHROPIC_API_KEY——提供你的 Router One API key 用于身份验证。ANTHROPIC_AUTH_TOKEN——Claude Code 的某些流程也会查找这个 token；将它设置为相同的 Router One key 可以保持环境一致。
如果你希望这些配置在终端重启后仍然生效，将同样的 export 命令添加到你的 shell 配置文件中（~/.zshrc 或 ~/.bashrc）。
第四步：验证是否生效
打开一个新的终端窗口，启动 Claude Code：
claude
发送一条简单消息，确认连接正常：
> Hello, can you confirm this is working?
如果收到正常响应，配置就完成了。所有请求现在都通过 Router One 转发。
再去 Router One Dashboard 的 Usage 页面确认一下，你应该能看到刚才发出的请求，包括使用的模型、消耗的 token 数和费用。
充分利用这套配置的建议
实时监控你的用量
Router One Dashboard 会实时展示每一个 Claude Code 请求——消耗的 token、单次请求费用、使用的模型和响应延迟。如果你重度使用 Claude Code 来做开发工作，这尤其有用，因为长时间的编码会话中 token 用量增长很快。
把 Dashboard 加个书签，定期查看，了解你的使用模式。
设置按 Key 的消费上限
进入 Dashboard → API Keys，为 Claude Code 使用的 Key 设置 maxSpend。达到上限后，这把 Key 会停止继续消费。多个开发者或项目共享一个钱包时，应分别创建独立 Key，隔离各自用量和风险。
为每个项目使用独立 API Key
如果你跨多个项目工作，请为每个项目创建单独的 API Key，并用项目名为 Key 命名。然后在 Dashboard 的按 Key 视图比较 token 用量与成本；Router One 不提供独立的项目级用量维度。
长时间会话前检查余额
针对复杂重构或大型代码库的 Claude Code 会话可能消耗大量 token。在开始重要会话前快速看一眼 Router One 余额，可以避免中途被打断。
妥善保管 API Key
在生产环境或共享机器上，将 Router One key 写入 shell 配置文件，而不是每次在终端里手动输入：
export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_API_KEY="sk-your-router-one-api-key"
export ANTHROPIC_AUTH_TOKEN="sk-your-router-one-api-key"
故障排除
「Authentication failed」错误 ——仔细检查 API key 是否正确，以及 Router One 账户余额是否为正。key 区分大小写。
「Connection refused」错误 ——确认 ANTHROPIC_BASE_URL 是 https://api.router.one，结尾没有多余的斜杠或路径。
响应缓慢 ——Router One 增加的开销极小（通常在 10ms 以内）。如果感觉响应慢了，在 Router One Dashboard 查看延迟指标。问题更可能出在上游供应商的延迟，而非网关本身。
配置没有生效 ——导出变量后请打开一个新的终端窗口，或者在启动 claude 之前在当前 shell 中重新执行 export 命令。
接下来做什么
将 Claude Code 连接到 Router One 之后，每个请求都会被追踪、计量，并受到预算管控的保护。你获得的是完全一样的 Claude 体验，外加对花费和用量的完整可见性。
探索 Router One Dashboard，查看请求分析，并为每把 Key 设置 maxSpend 与速率限制。如果你还在使用 Claude Code 之外的其他 AI 工具，请为每个工具创建独立 Key，再通过同一网关转发和追踪用量。
前往 router.one 注册或登录，开始使用。