Router One
返回博客

Claude Code 配置指南：2 分钟上手

|Router One Team
claude-codetutorialsetupanthropic

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 加个书签，定期查看，了解你的使用模式。

设置预算告警

进入 Router One Dashboard 的 Budget 页面，配置消费告警。在你期望月度预算的 80% 处设一个软警告，在 100% 处设一个硬限制。这能防止意外超支——如果你在团队中使用 Claude Code，多个开发者共享同一个组织账号时尤其有用。

使用项目级 API Key

如果你跨多个项目工作，考虑为每个项目创建单独的 API key。这样你可以在 Router One Dashboard 中按项目追踪 Claude Code 的用量，轻松看出哪些项目消耗最多 token，并据此分摊成本。

长时间会话前检查余额

针对复杂重构或大型代码库的 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，查看详细的分析报告、设置团队预算、配置告警。如果你还在使用 Claude Code 之外的其他 AI 工具，它们同样可以通过 Router One 转发——一个平台管理你所有的 LLM 用量。

前往 router.one 注册或登录，开始使用。