> https://router.one/zh/blog/claude-code-setup-guide 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 发布：2026-04-05 · 修订：2026-08-26 · 作者：Router One Team

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

_Claude Code 通用接入指南：设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN、配置永久生效、/status 验证、按 Key 设消费上限；国内网络与充值见国内配置教程。_

人在国内？先看 [Claude Code 国内稳定接入](https://router.one/zh/claude-code-china)（国内直连、支付宝或银行卡充值）和[国内配置教程](https://router.one/zh/blog/claude-code-china-guide)（429/DNS 排查）。本文是与地区无关的通用接入步骤。

Claude Code 是 Anthropic 官方的 CLI 工具，让你直接在终端中使用 Claude。默认情况下，它直连 Anthropic API——能用，但你看不到花费明细，没有预算管控，API 挂了也没有备用方案。

通过 Router One 来连接 Claude Code 只需要大约两分钟，就能获得实时用量追踪、自动预算管控，以及平台自带的完整可观测能力。下面是具体的配置步骤。

## 前置条件

开始之前，请确认你已经准备好：

- **已安装 Claude Code** ——如果还没有，请参考[官方安装指南](https://docs.anthropic.com/en/docs/claude-code)
- **一个 Router One 账号** ——如果需要注册，前往 [router.one](https://router.one/zh)

就这些。不需要额外的依赖或工具。

## 第一步：获取 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 采用预充值模式，确保余额足够你的预期用量。

## 第二步：将 Claude Code 指向 Router One

Claude Code 从 shell 环境变量中读取 Anthropic 兼容的端点和凭证。这让配置过程非常简洁，也与官方 CLI 的工作方式保持一致。

在当前 shell 中导出这两个变量：

```bash
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：

```bash
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 配置文件，而不是每次在终端里手动输入：

```bash
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 排查页](https://router.one/zh/claude-code-403)。

**「Connection refused」错误** ——确认 `ANTHROPIC_BASE_URL` 是 `https://api.router.one`，结尾没有多余的斜杠或路径。

**响应缓慢** ——Router One 增加的开销极小（通常在 10ms 以内）。如果感觉响应慢了，在 Router One Dashboard 查看延迟指标。问题更可能出在上游供应商的延迟，而非网关本身。

**配置没有生效** ——导出变量后请打开一个新的终端窗口，或者在启动 `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 Dashboard 的 **Usage** 页面查看——你应该能看到刚才发出的请求，包括使用的模型、消耗的 token 数和费用。

**Claude Code 报「Authentication failed」错误怎么办？**
仔细检查 API key 是否正确、Router One 账户余额是否为正，key 区分大小写；并确认当前 shell 里没有残留的 `ANTHROPIC_API_KEY`（有就 unset 掉），完整清单见 [Claude Code 403 排查页](https://router.one/zh/claude-code-403)。

**通过 Router One 调用会让 Claude Code 变慢吗？**
Router One 增加的开销极小，通常在 10ms 以内。如果感觉响应慢了，可在 Router One Dashboard 查看延迟指标——问题更可能出在上游供应商的延迟，而非网关本身。

## 接下来做什么

将 Claude Code 连接到 Router One 之后，每个请求都会被追踪、计量，并受到预算管控的保护。你获得的是完全一样的 Claude 体验，外加对花费和用量的完整可见性。

探索 Router One Dashboard，查看请求分析，并为每把 Key 设置 maxSpend 与速率限制。如果你还在使用 Claude Code 之外的其他 AI 工具，请为每个工具创建独立 Key，再通过同一网关转发和追踪用量。

前往 [router.one](https://router.one/zh) 注册或登录，开始使用。

## 相关页面

- 本页规范地址：https://router.one/zh/blog/claude-code-setup-guide
- Claude Code 中国：https://router.one/zh/claude-code-china
- 全部博客文章：https://router.one/zh/blog
- 模型与每模型 token 价格：https://router.one/zh/models（markdown：https://router.one/zh/models.md）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md