选择使用方式

不使用 CC Switch

Windows / macOS 手动配置

先从 R讯复制对应工具的连接信息，再按系统修改配置文件。下面示例中的地址、密钥和模型名全部是占位符。

配置前先准备 4 项信息

R讯 API 密钥、接口地址、模型 ID、接口协议类型。进入「API 密钥」→ 右侧「…」→「复制连接信息」。

不要自行给地址添加或删除 /v1。Claude、Codex、Gemini 使用的协议不同，必须使用 R讯为对应工具生成的连接信息。

Windows 10 / 11

Windows 手动配置

以下命令在 PowerShell 中运行。修改后请关闭并重新打开终端。

Claude Code

配置文件：%USERPROFILE%\.claude\settings.json

1
先在 PowerShell 临时测试
使用 R讯提供的 Claude Base URL 和密钥启动 Claude Code。

$env:ANTHROPIC_BASE_URL = "<R讯提供的 Claude Base URL>"
$env:ANTHROPIC_AUTH_TOKEN = "<R讯 API 密钥>"
$env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1"
claude

2
确认可用后长期保存
把下面的 env 合并进用户配置，不要覆盖文件里原有设置。

{
  "env": {
    "ANTHROPIC_BASE_URL": "<R讯提供的 Claude Base URL>",
    "ANTHROPIC_AUTH_TOKEN": "<R讯 API 密钥>",
    "ANTHROPIC_MODEL": "<R讯提供的模型 ID>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<同一模型 ID>",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "<同一模型 ID>",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "<同一模型 ID>",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

运行 /status 检查地址和认证来源，再用 /model 选择 R讯模型。DeepSeek 订阅只提供一个模型时，可将四个模型字段都映射到同一模型 ID。

如果 R讯连接信息明确注明使用 x-api-key，请把 ANTHROPIC_AUTH_TOKEN 改成 ANTHROPIC_API_KEY，两者不要同时配置。

Codex CLI

配置文件：%USERPROFILE%\.codex\config.toml

model = "<R讯提供的模型 ID>"
model_provider = "rxun"

[model_providers.rxun]
name = "R讯"
base_url = "<R讯提供的 Codex API Base URL>"
env_key = "R_XUN_API_KEY"
wire_api = "responses"

在 PowerShell 保存用户级密钥：

[Environment]::SetEnvironmentVariable(
  "R_XUN_API_KEY",
  "<R讯 API 密钥>",
  "User"
)

关闭并重新打开 PowerShell，运行 codex，发送“只回复：连接成功”验证。

当前 Codex 自定义供应商只支持 Responses API。只有 /v1/chat/completions 的地址不能直接使用，必须选择 R讯明确标注为 Codex / Responses 的连接信息。

Gemini CLI

配置文件：%USERPROFILE%\.env

创建用户目录下的 .env 文件：

New-Item -ItemType File -Force "$env:USERPROFILE\.env" | Out-Null
notepad "$env:USERPROFILE\.env"

填写 R讯提供的 Gemini 原生兼容信息：

GEMINI_API_KEY=<R讯 API 密钥>
GOOGLE_GEMINI_BASE_URL=<R讯提供的 Gemini Base URL>
GEMINI_MODEL=<R讯提供的模型 ID>

重新打开终端并运行 gemini，认证方式选择「Use Gemini API key」。

这里必须使用 R讯提供的 Gemini 原生协议兼容地址，普通 OpenAI /v1 地址不能代替。如果 R讯未提供该地址，请使用 CC Switch。

macOS

macOS 手动配置

以下命令以系统默认的 Zsh 为例。配置文件均位于当前用户主目录。

Claude Code

配置文件：~/.claude/settings.json

创建目录并打开配置文件；文件已有内容时，只合并 env，不要覆盖其他设置：

mkdir -p ~/.claude
open -e ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "<R讯提供的 Claude Base URL>",
    "ANTHROPIC_AUTH_TOKEN": "<R讯 API 密钥>",
    "ANTHROPIC_MODEL": "<R讯提供的模型 ID>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<同一模型 ID>",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "<同一模型 ID>",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "<同一模型 ID>"
  }
}

完全退出旧会话后验证：

claude doctor
claude -p --model "<模型 ID>" "只回复：连接成功"

DeepSeek 订阅只提供一个模型时，将主模型、Haiku、Sonnet、Opus 都映射到同一模型 ID，可避免辅助调用落到不存在的官方模型。

第三方网关通常使用 ANTHROPIC_AUTH_TOKEN；只有 R讯明确要求 x-api-key 时才改用 ANTHROPIC_API_KEY，两者不要同时配置。

Codex CLI

配置文件：~/.codex/config.toml

model = "<R讯提供的模型 ID>"
model_provider = "r-xun"

[model_providers.r-xun]
name = "R讯中转"
base_url = "<R讯提供的 Responses 兼容 Base URL>"
env_key = "R_XUN_API_KEY"
wire_api = "responses"

打开 ~/.zshrc，加入密钥后重新加载：

open -e ~/.zshrc
# 在文件中加入：export R_XUN_API_KEY="<R讯 API 密钥>"
source ~/.zshrc

完全退出旧 Codex 进程后验证：

codex --strict-config doctor --summary --ascii
codex exec -m "<模型 ID>" "只回复：连接成功"

Codex 必须使用 R讯提供的 Responses 兼容地址。不要把普通 OpenAI Chat Completions 地址直接填入。

Gemini CLI

配置文件：~/.gemini/.env

创建用户级环境文件并打开：

mkdir -p ~/.gemini
open -e ~/.gemini/.env

GEMINI_API_KEY="<R讯 API 密钥>"
GOOGLE_GEMINI_BASE_URL="<R讯提供的 Gemini 原生兼容地址>"
GEMINI_MODEL="<R讯提供的模型 ID>"

保存后限制文件权限，再启动 Gemini CLI：

chmod 600 ~/.gemini/.env
gemini

输入 /auth 选择「Use Gemini API key」，再用 /model 检查模型并发送“只回复：连接成功”。

GOOGLE_GEMINI_BASE_URL 必须是 R讯提供的 Gemini 原生协议 HTTPS 地址。若 R讯未提供，请使用 CC Switch。

排查问题

常见错误

401: 密钥无效，或 Claude 的 AUTH_TOKEN / API_KEY 类型选错。
404: 接口地址不正确，或手动重复添加了 /v1。
Unknown model: 模型 ID 与 R讯提供的模型列表不一致。
修改后无变化: 完全退出对应 CLI，再从新开的 PowerShell 或终端启动。

官方配置参考

Claude Code 网关配置 Claude Code 模型配置 Codex 配置字段参考 Codex 自定义供应商 Gemini CLI 配置参考