Skip to main content

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.

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

​
适用场景

如果你希望在以下场景中使用 Claude Code，可以采用本文方案：
  • 在本地终端中通过自定义网关使用 Claude Code
  • 在同一套配置下接入不同环境，例如本地开发和 CI
  • 通过 Anthropic 兼容方式将 Claude Code 指向 router.onetoken.sh

​
1. 安装 Claude Code

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

​
macOS、Linux、WSL

curl -fsSL https://claude.ai/install.sh | bash

​
Windows PowerShell

irm https://claude.ai/install.ps1 | iex

​
2. 配置接入参数

不要直接使用 Claude Code 的默认登录流程，而是通过环境变量将其指向 router.onetoken.sh。 建议把以下变量写入你的 shell 配置文件，例如 ~/.zshrc 或 ~/.bashrc： 
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

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
写入后执行以下命令立即生效： 
source ~/.zshrc

​
bash

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
写入后执行以下命令立即生效： 
source ~/.bashrc
如果你使用的是其他 shell，请将同样的环境变量写入对应的 shell 启动文件。 这些变量的作用如下：
  • ONETOKEN_API_KEY：你本地自定义的令牌变量名，便于复用
  • ANTHROPIC_BASE_URL：Claude Code 请求发送到的 Anthropic 兼容地址
  • ANTHROPIC_AUTH_TOKEN：Claude Code 实际使用的认证令牌
  • ANTHROPIC_API_KEY：必须显式置空，避免 Claude Code 回退到默认 Anthropic 登录逻辑
不要把这些变量写进项目级 .env 文件。Claude Code 的原生安装方式不会自动读取常见的项目 .env 文件。
如果你此前已经通过 Anthropic 官方账号登录过 Claude Code，建议先在 Claude Code 会话中执行 /logout 清除缓存凭证，再重新启动终端。

​
3. 启动 Claude Code

进入你的项目目录后，直接启动 Claude Code： 
cd /path/to/your/project
claude
配置正确时，Claude Code 发出的请求会通过 router.onetoken.sh 转发。

​
4. 验证连接

启动后，可在 Claude Code 中执行 /status 检查当前连接状态： 
/status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://router.onetoken.sh
如果 Anthropic base URL 仍然显示为默认地址，通常说明当前终端尚未加载新的环境变量。

​
5. 模型覆盖配置

如果你需要为不同任务指定不同模型，可以继续设置 Claude Code 的模型相关环境变量： 
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：子代理任务
模型 ID 需要使用 router.onetoken.sh 当前支持的名称。如果你暂时不确定可用模型，可先不设置这些变量，仅保留基础接入配置。

​
6. GitHub Action

如果你需要在 GitHub Actions 中运行 Claude Code，可在官方 claude-code-action 的基础上做同样的改写： 
- 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 配置。可重新打开终端，或手动执行： 
source ~/.zshrc
如果你使用的是 Bash，请改为加载对应的 ~/.bashrc。

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

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