跳到主要内容
Router One
注册
跳到主要内容
Router One

CLI 配置指南

Claude Code、Codex CLI 一键接入脚本，自动写入 base URL 与 API Key；另附 OpenClaw、Hermes Agent 的手动配置步骤。

一键接入（推荐）

一条命令完成安装 CLI、写入网关配置、并用 1 token 测试请求验证 Key。已有配置文件会自动备份。

创建 API Key

Key 只在浏览器本地拼进命令，不会被上传。

bash
curl -fsSL https://router.one/install/claude-code.sh | bash -s -- sk-your-api-key

配置立即生效，运行 claude 即可开始使用。

powershell
$env:ROUTER_ONE_API_KEY = "sk-your-api-key"; irm https://router.one/install/claude-code.ps1 | iex

配置立即生效，运行 claude 即可开始使用。

运行前可先查看脚本源码： /install/claude-code.sh · /install/claude-code.ps1

bash
curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-api-key

新开的终端可直接运行 codex；当前终端先执行 source ~/.zshrc（或对应 shell 配置）。

powershell
$env:ROUTER_ONE_API_KEY = "sk-your-api-key"; irm https://router.one/install/codex.ps1 | iex

当前会话已生效，直接运行 codex 即可。

运行前可先查看脚本源码： /install/codex.sh · /install/codex.ps1

手动配置

想了解每一步做了什么、或需要自定义时，按下面的步骤手动配置。

Claude Code CLI 配置指南

配置 Claude Code CLI 使用 Router One 作为代理，享受统一路由、成本管控和完整可观测性。

开始之前，请先在 控制台 → API 密钥 页面创建你的 API Key（格式： sk-xxx）。
1

通过 Homebrew 安装 Node.js

Claude Code CLI 需要 Node.js 22 或更高版本。

bash
brew install node
bash
node --version
2

全局安装 Claude Code CLI

bash
npm install -g @anthropic-ai/claude-code
3

配置环境变量

将 Router One 设为 Claude Code 的 API 代理端点。

如果你之前使用过官方 Claude CLI，建议先清除旧配置以避免冲突： rm -rf ~/.claude

临时设置（仅当前终端会话有效）：

bash
export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_AUTH_TOKEN=sk-your-api-key

永久设置（写入 shell 配置文件）：

bash
echo 'export ANTHROPIC_BASE_URL=https://api.router.one' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-api-key' >> ~/.zshrc
source ~/.zshrc
ANTHROPIC_AUTH_TOKEN 会以 Authorization: Bearer 发送给网关，无需再设置 ANTHROPIC_API_KEY。注意：一键脚本会把同样的配置写进 ~/.claude/settings.json 的 env 块，其优先级高于 shell 环境变量；更换 Key 时优先更新 settings.json，或直接重跑一键命令。
4

启动 Claude Code

运行以下命令启动 CLI：

bash
claude
1

安装 Node.js

从 Node.js 官网下载安装，或使用 winget。

powershell
winget install OpenJS.NodeJS.LTS
powershell
node --version
2

全局安装 Claude Code CLI

powershell
npm install -g @anthropic-ai/claude-code
3

配置环境变量

将 Router One 设为 Claude Code 的 API 代理端点。

如果你之前使用过官方 Claude CLI，建议先清除旧配置以避免冲突： Remove-Item -Recurse -Force ~\.claude

临时设置（仅当前 PowerShell 会话有效）：

powershell
$env:ANTHROPIC_BASE_URL = "https://api.router.one"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-api-key"

永久设置（系统环境变量）：

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.router.one", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-your-api-key", "User")
ANTHROPIC_AUTH_TOKEN 会以 Authorization: Bearer 发送给网关，无需再设置 ANTHROPIC_API_KEY。注意：一键脚本会把同样的配置写进 ~/.claude/settings.json 的 env 块，其优先级高于 shell 环境变量；更换 Key 时优先更新 settings.json，或直接重跑一键命令。
4

启动 Claude Code

运行以下命令启动 CLI：

powershell
claude
1

安装 Node.js

使用包管理器或 nvm 安装 Node.js 22+。

通过 nvm（推荐）：

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts
node --version

或通过 apt（Debian/Ubuntu）：

bash
sudo apt update && sudo apt install -y nodejs npm
2

全局安装 Claude Code CLI

bash
npm install -g @anthropic-ai/claude-code
3

配置环境变量

将 Router One 设为 Claude Code 的 API 代理端点。

如果你之前使用过官方 Claude CLI，建议先清除旧配置以避免冲突： rm -rf ~/.claude

临时设置（仅当前终端会话有效）：

bash
export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_AUTH_TOKEN=sk-your-api-key

永久设置（写入 shell 配置文件）：

bash
echo 'export ANTHROPIC_BASE_URL=https://api.router.one' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-api-key' >> ~/.bashrc
source ~/.bashrc
ANTHROPIC_AUTH_TOKEN 会以 Authorization: Bearer 发送给网关，无需再设置 ANTHROPIC_API_KEY。注意：一键脚本会把同样的配置写进 ~/.claude/settings.json 的 env 块，其优先级高于 shell 环境变量；更换 Key 时优先更新 settings.json，或直接重跑一键命令。
4

启动 Claude Code

运行以下命令启动 CLI：

bash
claude

Codex CLI 配置指南

配置 OpenAI Codex CLI 使用 Router One 作为代理，享受统一路由、成本管控和完整可观测性。

开始之前，请先在 控制台 → API 密钥 页面创建你的 API Key（格式： sk-xxx）。
1

通过 Homebrew 安装 Node.js

Codex CLI 需要 Node.js 16 或更高版本。

bash
brew install node
bash
node --version
2

全局安装 Codex CLI

bash
npm install -g @openai/codex
3

配置环境变量

将 Router One 设为 Codex 的 API 代理端点。

临时设置（仅当前终端会话有效）：

bash
export ROUTER_ONE_API_KEY=sk-your-api-key

永久设置（写入 shell 配置文件）：

bash
echo 'export ROUTER_ONE_API_KEY=sk-your-api-key' >> ~/.zshrc
source ~/.zshrc
4

创建 Codex 配置文件

将以下内容写入 ~/.codex/config.toml，启用 Router One 作为模型 provider。

bash
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model = "gpt-5.6-sol"
model_provider = "router"
model_reasoning_effort = "high"
model_verbosity = "high"
web_search = "live"

[model_providers.router]
base_url = "https://api.router.one/v1"
env_key = "ROUTER_ONE_API_KEY"
env_key_instructions = "Create an API key at https://router.one/dashboard/api-keys and set the ROUTER_ONE_API_KEY environment variable."
name = "Router One"
wire_api = "responses"
EOF
5

启动 Codex

运行以下命令启动 CLI：

bash
codex
1

安装 Node.js

从 Node.js 官网下载安装，或使用 winget。

powershell
winget install OpenJS.NodeJS.LTS
powershell
node --version
2

全局安装 Codex CLI

powershell
npm install -g @openai/codex
3

配置环境变量

将 Router One 设为 Codex 的 API 代理端点。

临时设置（仅当前 PowerShell 会话有效）：

powershell
$env:ROUTER_ONE_API_KEY = "sk-your-api-key"

永久设置（系统环境变量）：

powershell
[System.Environment]::SetEnvironmentVariable("ROUTER_ONE_API_KEY", "sk-your-api-key", "User")
4

创建 Codex 配置文件

将以下内容写入 %USERPROFILE%\.codex\config.toml，启用 Router One 作为模型 provider。

powershell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex" | Out-Null
$config = @'
model = "gpt-5.6-sol"
model_provider = "router"
model_reasoning_effort = "high"
model_verbosity = "high"
web_search = "live"

[model_providers.router]
base_url = "https://api.router.one/v1"
env_key = "ROUTER_ONE_API_KEY"
env_key_instructions = "Create an API key at https://router.one/dashboard/api-keys and set the ROUTER_ONE_API_KEY environment variable."
name = "Router One"
wire_api = "responses"
'@
[System.IO.File]::WriteAllText("$env:USERPROFILE\.codex\config.toml", $config, (New-Object System.Text.UTF8Encoding($false)))
5

启动 Codex

运行以下命令启动 CLI：

powershell
codex
1

安装 Node.js

使用包管理器或 nvm 安装 Node.js 16+。

通过 nvm（推荐）：

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts
node --version

或通过 apt（Debian/Ubuntu）：

bash
sudo apt update && sudo apt install -y nodejs npm
2

全局安装 Codex CLI

bash
npm install -g @openai/codex
3

配置环境变量

将 Router One 设为 Codex 的 API 代理端点。

临时设置（仅当前终端会话有效）：

bash
export ROUTER_ONE_API_KEY=sk-your-api-key

永久设置（写入 shell 配置文件）：

bash
echo 'export ROUTER_ONE_API_KEY=sk-your-api-key' >> ~/.bashrc
source ~/.bashrc
4

创建 Codex 配置文件

将以下内容写入 ~/.codex/config.toml，启用 Router One 作为模型 provider。

bash
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model = "gpt-5.6-sol"
model_provider = "router"
model_reasoning_effort = "high"
model_verbosity = "high"
web_search = "live"

[model_providers.router]
base_url = "https://api.router.one/v1"
env_key = "ROUTER_ONE_API_KEY"
env_key_instructions = "Create an API key at https://router.one/dashboard/api-keys and set the ROUTER_ONE_API_KEY environment variable."
name = "Router One"
wire_api = "responses"
EOF
5

启动 Codex

运行以下命令启动 CLI：

bash
codex

OpenClaw CLI 配置指南

OpenClaw（小龙虾）是自托管的 AI 助手：在本机运行一个 Gateway 守护进程，在你常用的聊天渠道里回复你。按下面的步骤把 Router One 注册为它的自定义 OpenAI 兼容模型 provider。

开始之前，请先在 控制台 → API 密钥 页面创建你的 API Key（格式： sk-xxx）。
1

通过 Homebrew 安装 Node.js

OpenClaw 的 npm latest（2026-10-03 为 2026.9.8）要求 Node.js 24.16+ 或 26.1+，推荐 Node 26；按 2026.9.6 核对，其运行时检查会在 Node 22 或 Node 25 上提示不受支持。

bash
brew install node
bash
node --version

也可以跳过这一步：官方安装脚本会自带受支持的 Node.js、安装 OpenClaw，然后打开交互式 onboarding 向导：

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

全局安装 OpenClaw CLI

bash
# npm 12 or npm 11.16+ (check with: npm --version)
npm install -g openclaw@latest --allow-scripts=openclaw
# npm 11.15 or earlier: run the same command without --allow-scripts=openclaw
3

配置环境变量

将 Router One 设为 OpenClaw 的 API 代理端点。

临时设置（仅当前终端会话有效）：

bash
export CUSTOM_API_KEY=sk-your-api-key

永久设置（写入 shell 配置文件）：

bash
echo 'export CUSTOM_API_KEY=sk-your-api-key' >> ~/.zshrc
source ~/.zshrc
4

运行 OpenClaw onboarding

将 Router One 注册为自定义 OpenAI 兼容 provider，并安装本地 Gateway 守护进程。--non-interactive 必须同时带上 --accept-risk，表示你已知悉 OpenClaw 关于完整系统访问权限的安全提示；缺了它，onboarding 会在写入任何配置之前停止。onboarding 还会向模型发一次很小的测试请求，这条请求会出现在控制台 → 日志里。

bash
openclaw onboard --non-interactive --accept-risk \
  --auth-choice custom-api-key \
  --custom-base-url https://api.router.one/v1 \
  --custom-model-id openai/gpt-5.6-sol \
  --custom-provider-id router-one \
  --custom-compatibility openai \
  --install-daemon
5

启动 OpenClaw

onboarding 已经启动了 Gateway 守护进程。先检查它的状态，再打开 Control UI 发一条消息：

bash
openclaw gateway status
openclaw dashboard
1

安装 Node.js

OpenClaw 的 npm latest（2026-10-03 为 2026.9.8）要求 Node.js 24.16+ 或 26.1+，推荐 Node 26；按 2026.9.6 核对，其运行时检查会在 Node 22 或 Node 25 上提示不受支持。

powershell
winget install OpenJS.NodeJS.LTS
powershell
node --version

也可以跳过这一步：官方安装脚本会自带受支持的 Node.js、安装 OpenClaw，然后打开交互式 onboarding 向导：

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
2

全局安装 OpenClaw CLI

powershell
# npm 12 or npm 11.16+ (check with: npm --version)
npm install -g openclaw@latest --allow-scripts=openclaw
# npm 11.15 or earlier: run the same command without --allow-scripts=openclaw
3

配置环境变量

将 Router One 设为 OpenClaw 的 API 代理端点。

临时设置（仅当前 PowerShell 会话有效）：

powershell
$env:CUSTOM_API_KEY = "sk-your-api-key"

永久设置（系统环境变量）：

powershell
[System.Environment]::SetEnvironmentVariable("CUSTOM_API_KEY", "sk-your-api-key", "User")
4

运行 OpenClaw onboarding

将 Router One 注册为自定义 OpenAI 兼容 provider，并安装本地 Gateway 守护进程。--non-interactive 必须同时带上 --accept-risk，表示你已知悉 OpenClaw 关于完整系统访问权限的安全提示；缺了它，onboarding 会在写入任何配置之前停止。onboarding 还会向模型发一次很小的测试请求，这条请求会出现在控制台 → 日志里。

powershell
openclaw onboard --non-interactive --accept-risk `
  --auth-choice custom-api-key `
  --custom-base-url https://api.router.one/v1 `
  --custom-model-id openai/gpt-5.6-sol `
  --custom-provider-id router-one `
  --custom-compatibility openai `
  --install-daemon
5

启动 OpenClaw

onboarding 已经启动了 Gateway 守护进程。先检查它的状态，再打开 Control UI 发一条消息：

powershell
openclaw gateway status
openclaw dashboard
1

安装 Node.js

OpenClaw 的 npm latest（2026-10-03 为 2026.9.8）要求 Node.js 24.16+ 或 26.1+，推荐 Node 26；按 2026.9.6 核对，其运行时检查会在 Node 22 或 Node 25 上提示不受支持。

通过 nvm（推荐）：

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 26
node --version

也可以跳过这一步：官方安装脚本会自带受支持的 Node.js、安装 OpenClaw，然后打开交互式 onboarding 向导：

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

全局安装 OpenClaw CLI

bash
# npm 12 or npm 11.16+ (check with: npm --version)
npm install -g openclaw@latest --allow-scripts=openclaw
# npm 11.15 or earlier: run the same command without --allow-scripts=openclaw
3

配置环境变量

将 Router One 设为 OpenClaw 的 API 代理端点。

临时设置（仅当前终端会话有效）：

bash
export CUSTOM_API_KEY=sk-your-api-key

永久设置（写入 shell 配置文件）：

bash
echo 'export CUSTOM_API_KEY=sk-your-api-key' >> ~/.bashrc
source ~/.bashrc
4

运行 OpenClaw onboarding

将 Router One 注册为自定义 OpenAI 兼容 provider，并安装本地 Gateway 守护进程。--non-interactive 必须同时带上 --accept-risk，表示你已知悉 OpenClaw 关于完整系统访问权限的安全提示；缺了它，onboarding 会在写入任何配置之前停止。onboarding 还会向模型发一次很小的测试请求，这条请求会出现在控制台 → 日志里。

bash
openclaw onboard --non-interactive --accept-risk \
  --auth-choice custom-api-key \
  --custom-base-url https://api.router.one/v1 \
  --custom-model-id openai/gpt-5.6-sol \
  --custom-provider-id router-one \
  --custom-compatibility openai \
  --install-daemon
5

启动 OpenClaw

onboarding 已经启动了 Gateway 守护进程。先检查它的状态，再打开 Control UI 发一条消息：

bash
openclaw gateway status
openclaw dashboard

OpenClaw 完整接入指南 →

Hermes Agent 配置指南

用官方安装脚本安装 Hermes Agent，并把 Router One 添加为它的自定义 OpenAI 兼容端点。

开始之前，请先在 控制台 → API 密钥 页面创建你的 API Key（格式： sk-xxx）。
1

检查 git 与 curl

Hermes Agent 的官方安装脚本（2026-10-01 核对）会先检查 git 和 curl，Python、Node.js 等依赖由它自行安装。不要用 pip：PyPI 上的 hermes-agent 包仍停在 0.19.0（2026-10-01 核对）。

bash
git --version
curl --version
2

用官方安装脚本安装 Hermes Agent

运行安装脚本后重新加载 shell。在终端中运行时，安装脚本最后会启动 hermes setup，其中 Model & Provider 一步填写的值与下一步相同；也可以先完成 setup，之后再运行 hermes model。

bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc
3

把 Router One 添加为自定义端点

在任何对话会话之外运行 hermes model，选择 Custom endpoint，按下面的值填写。Hermes 会把 Key 存进它的 .env 文件，把端点写入 ~/.hermes/config.yaml。

bash
hermes model
# 选择 Custom endpoint，然后依次填写：
#   API base URL:                   https://api.router.one/v1
#   API key:                        sk-your-api-key
#   Select API compatibility mode:  2（Chat Completions）
#   Select model … or type name:    anthropic/claude-sonnet-5（直接输入精确 ID）
#   Context length in tokens:       留空（上下文长度与成本见完整指南）
#   Display name:                   Router One
OPENAI_BASE_URL 只对 Hermes 的 openai-api provider 生效，对自定义端点无效，所以请通过 hermes model 或 config.yaml 设置地址。Chat Completions 覆盖全部对话模型；命名 provider、其他 transport 与上下文长度见完整指南。按 Hermes main 分支源码（2026-10-01 核对），安装脚本所装的 main 分支自 2026-09-28 起不再给 compression.threshold_tokens 默认值：请在 config.yaml 里自行设置；完整指南用 240000，让 anthropic/claude-sonnet-5 的请求保持在 256,000 token 套餐扣次分段以下。
4

启动 Hermes Agent

运行以下命令启动 CLI：

bash
hermes
1

用官方安装脚本安装 Hermes Agent

按 Hermes Agent 的 README（2026-10-01 核对），Windows 支持原生安装：Hermes 会装在 %LOCALAPPDATA%\hermes，装完后请新开一个 PowerShell 窗口。如果想用 WSL2，请在 WSL2 中运行 Linux 命令，Hermes 会装在 ~/.hermes。

powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
2

把 Router One 添加为自定义端点

在任何对话会话之外运行 hermes model，选择 Custom endpoint，按下面的值填写。Hermes 会把 Key 存进它的 .env 文件，把端点写入 %LOCALAPPDATA%\hermes\config.yaml。

powershell
hermes model
# 选择 Custom endpoint，然后依次填写：
#   API base URL:                   https://api.router.one/v1
#   API key:                        sk-your-api-key
#   Select API compatibility mode:  2（Chat Completions）
#   Select model … or type name:    anthropic/claude-sonnet-5（直接输入精确 ID）
#   Context length in tokens:       留空（上下文长度与成本见完整指南）
#   Display name:                   Router One
OPENAI_BASE_URL 只对 Hermes 的 openai-api provider 生效，对自定义端点无效，所以请通过 hermes model 或 config.yaml 设置地址。Chat Completions 覆盖全部对话模型；命名 provider、其他 transport 与上下文长度见完整指南。按 Hermes main 分支源码（2026-10-01 核对），安装脚本所装的 main 分支自 2026-09-28 起不再给 compression.threshold_tokens 默认值：请在 config.yaml 里自行设置；完整指南用 240000，让 anthropic/claude-sonnet-5 的请求保持在 256,000 token 套餐扣次分段以下。
3

启动 Hermes Agent

运行以下命令启动 CLI：

powershell
hermes
1

检查 git 与 curl

Hermes Agent 的官方安装脚本（2026-10-01 核对）会先检查 git 和 curl，Python、Node.js 等依赖由它自行安装。不要用 pip：PyPI 上的 hermes-agent 包仍停在 0.19.0（2026-10-01 核对）。

bash
git --version
curl --version

或通过 apt（Debian/Ubuntu）：

bash
sudo apt update && sudo apt install -y git curl
2

用官方安装脚本安装 Hermes Agent

运行安装脚本后重新加载 shell。在终端中运行时，安装脚本最后会启动 hermes setup，其中 Model & Provider 一步填写的值与下一步相同；也可以先完成 setup，之后再运行 hermes model。

bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
3

把 Router One 添加为自定义端点

在任何对话会话之外运行 hermes model，选择 Custom endpoint，按下面的值填写。Hermes 会把 Key 存进它的 .env 文件，把端点写入 ~/.hermes/config.yaml。

bash
hermes model
# 选择 Custom endpoint，然后依次填写：
#   API base URL:                   https://api.router.one/v1
#   API key:                        sk-your-api-key
#   Select API compatibility mode:  2（Chat Completions）
#   Select model … or type name:    anthropic/claude-sonnet-5（直接输入精确 ID）
#   Context length in tokens:       留空（上下文长度与成本见完整指南）
#   Display name:                   Router One
OPENAI_BASE_URL 只对 Hermes 的 openai-api provider 生效，对自定义端点无效，所以请通过 hermes model 或 config.yaml 设置地址。Chat Completions 覆盖全部对话模型；命名 provider、其他 transport 与上下文长度见完整指南。按 Hermes main 分支源码（2026-10-01 核对），安装脚本所装的 main 分支自 2026-09-28 起不再给 compression.threshold_tokens 默认值：请在 config.yaml 里自行设置；完整指南用 240000，让 anthropic/claude-sonnet-5 的请求保持在 256,000 token 套餐扣次分段以下。
4

启动 Hermes Agent

运行以下命令启动 CLI：

bash
hermes

Hermes Agent 完整接入指南 →

快速开始

上一页

CC Switch 配置教程

下一页

本页目录

一键接入（推荐）手动配置