> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onetoken.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code 接入

> 将 Claude Code 通过 router.onetoken.sh 接入 Anthropic 兼容网关。

<Info>
  本文基于 2026 年 3 月 25 日可访问的 OpenRouter Claude Code 集成文档改写。
</Info>

## 适用场景

如果你希望在以下场景中使用 Claude Code，可以采用本文方案：

* 在本地终端中通过自定义网关使用 Claude Code
* 在同一套配置下接入不同环境，例如本地开发和 CI
* 通过 Anthropic 兼容方式将 Claude Code 指向 `router.onetoken.sh`

## 1. 安装 Claude Code

按照 Claude Code 官方方式完成安装。

### macOS、Linux、WSL

```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

### Windows PowerShell

```powershell theme={null}
irm https://claude.ai/install.ps1 | iex
```

## 2. 配置接入参数

不要直接使用 Claude Code 的默认登录流程，而是通过环境变量将其指向 `router.onetoken.sh`。

建议把以下变量写入你的 shell 配置文件，例如 `~/.zshrc` 或 `~/.bashrc`：

```bash theme={null}
export ONETOKEN_API_KEY="<your-onetoken-token>"
export ANTHROPIC_BASE_URL="https://router.onetoken.sh"
export ANTHROPIC_AUTH_TOKEN="$ONETOKEN_API_KEY"
export ANTHROPIC_API_KEY=""
```

### 写入配置文件并持久化

如果你希望每次打开终端时自动生效，可以直接将配置追加到 shell 配置文件中。

#### zsh

```bash theme={null}
cat >> ~/.zshrc <<'EOF'
export ONETOKEN_API_KEY="<your-onetoken-token>"
export ANTHROPIC_BASE_URL="https://router.onetoken.sh"
export ANTHROPIC_AUTH_TOKEN="$ONETOKEN_API_KEY"
export ANTHROPIC_API_KEY=""
EOF
```

写入后执行以下命令立即生效：

```bash theme={null}
source ~/.zshrc
```

#### bash

```bash theme={null}
cat >> ~/.bashrc <<'EOF'
export ONETOKEN_API_KEY="<your-onetoken-token>"
export ANTHROPIC_BASE_URL="https://router.onetoken.sh"
export ANTHROPIC_AUTH_TOKEN="$ONETOKEN_API_KEY"
export ANTHROPIC_API_KEY=""
EOF
```

写入后执行以下命令立即生效：

```bash theme={null}
source ~/.bashrc
```

如果你使用的是其他 shell，请将同样的环境变量写入对应的 shell 启动文件。

这些变量的作用如下：

* `ONETOKEN_API_KEY`：你本地自定义的令牌变量名，便于复用
* `ANTHROPIC_BASE_URL`：Claude Code 请求发送到的 Anthropic 兼容地址
* `ANTHROPIC_AUTH_TOKEN`：Claude Code 实际使用的认证令牌
* `ANTHROPIC_API_KEY`：必须显式置空，避免 Claude Code 回退到默认 Anthropic 登录逻辑

<Warning>
  不要把这些变量写进项目级 `.env` 文件。Claude Code 的原生安装方式不会自动读取常见的项目 `.env` 文件。
</Warning>

如果你此前已经通过 Anthropic 官方账号登录过 Claude Code，建议先在 Claude Code 会话中执行 `/logout` 清除缓存凭证，再重新启动终端。

## 3. 启动 Claude Code

进入你的项目目录后，直接启动 Claude Code：

```bash theme={null}
cd /path/to/your/project
claude
```

配置正确时，Claude Code 发出的请求会通过 `router.onetoken.sh` 转发。

## 4. 验证连接

启动后，可在 Claude Code 中执行 `/status` 检查当前连接状态：

```text theme={null}
/status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://router.onetoken.sh
```

如果 `Anthropic base URL` 仍然显示为默认地址，通常说明当前终端尚未加载新的环境变量。

## 5. 模型覆盖配置

如果你需要为不同任务指定不同模型，可以继续设置 Claude Code 的模型相关环境变量：

```bash theme={null}
export ANTHROPIC_DEFAULT_OPUS_MODEL="<opus-class-model-id>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="<sonnet-class-model-id>"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="<haiku-class-model-id>"
export CLAUDE_CODE_SUBAGENT_MODEL="<subagent-model-id>"
```

这些变量分别用于控制：

* `ANTHROPIC_DEFAULT_OPUS_MODEL`：高复杂度任务
* `ANTHROPIC_DEFAULT_SONNET_MODEL`：常规编码任务
* `ANTHROPIC_DEFAULT_HAIKU_MODEL`：轻量或快速任务
* `CLAUDE_CODE_SUBAGENT_MODEL`：子代理任务

<Note>
  模型 ID 需要使用 `router.onetoken.sh` 当前支持的名称。如果你暂时不确定可用模型，可先不设置这些变量，仅保留基础接入配置。
</Note>

## 6. GitHub Action

如果你需要在 GitHub Actions 中运行 Claude Code，可在官方 `claude-code-action` 的基础上做同样的改写：

```yaml theme={null}
- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ONETOKEN_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://router.onetoken.sh
```

建议将访问令牌保存为仓库或组织级 Secret，例如 `ONETOKEN_API_KEY`。

## 7. 常见问题

### 认证失败

优先检查以下内容：

* `ANTHROPIC_AUTH_TOKEN` 是否已正确设置
* `ANTHROPIC_API_KEY` 是否已显式设为空字符串
* 是否仍保留了之前的 Claude Code 登录缓存

### 修改配置后没有生效

通常是因为当前终端没有重新加载 shell 配置。可重新打开终端，或手动执行：

```bash theme={null}
source ~/.zshrc
```

如果你使用的是 Bash，请改为加载对应的 `~/.bashrc`。

### 项目里的 `.env` 已经写了变量，为什么 Claude Code 仍然无效

Claude Code 的原生安装方式不会自动读取常见的项目级 `.env` 文件。请优先使用 shell 配置文件或系统级环境变量。