词驿 WordRelay

主题

CC Switch 配置 ​

CC Switch 是开源的供应商切换器（MIT 协议，Tauri + React + Rust）：把 Claude Code、Codex、Gemini CLI 等多个工具的多家供应商配置收进一处，点一下完成切换与同步。如果你的机器上同时有官方直连、词驿、其他中转，用它可以免来回改配置文件。

词驿与 CC Switch 的分工：词驿管网关侧（渠道池、路由、切流——在词驿切换路由零客户端操作），CC Switch 管客户端侧（本机配置的保存与切换）。

前置 ​

  1. 安装 CC Switch（macOS / Windows / Linux）
  2. 一枚词驿令牌（接入指南）

方式一：一键导入（推荐） ​

点击对应应用的导入链接，CC Switch 会弹出导入确认对话框（可预览全部配置内容），确认即完成添加：

Claude Code

ccswitch://v1/import?resource=provider&app=claude&name=WordRelay&endpoint=https%3A%2F%2Fwordrelay.chat%2Fcc&config=eyJlbnYiOnsiQU5USFJPUElDX0JBU0VfVVJMIjoiaHR0cHM6Ly93b3JkcmVsYXkuY2hhdC9jYyIsIkFOVEhST1BJQ19BVVRIX1RPS0VOIjoiIn19&configFormat=json

Codex

ccswitch://v1/import?resource=provider&app=codex&name=WordRelay&endpoint=https%3A%2F%2Fwordrelay.chat%2Fv1&config=bW9kZWxfcHJvdmlkZXIgPSAid29yZHJlbGF5IgoKW21vZGVsX3Byb3ZpZGVycy53b3JkcmVsYXldCm5hbWUgPSAid29yZHJlbGF5IgpiYXNlX3VybCA9ICJodHRwczovL3dvcmRyZWxheS5jaGF0L3YxIgp3aXJlX2FwaSA9ICJjaGF0Igo%3D&configFormat=toml

Gemini CLI

ccswitch://v1/import?resource=provider&app=gemini&name=WordRelay&endpoint=https%3A%2F%2Fwordrelay.chat&config=eyJlbnYiOnsiR09PR0xFX0dFTUlOSV9CQVNFX1VSTCI6Imh0dHBzOi8vd29yZHJlbGF5LmNoYXQiLCJHRU1JTklfQVBJX0tFWSI6IiJ9fQ%3D%3D&configFormat=json

深链不含令牌

导入链接出于安全不携带 API Key（含 key 的链接易被分享/记录）。确认导入后，在 CC Switch 的该供应商配置里填入你的词驿令牌。

Gemini CLI 现状

词驿网关的 Gemini 原生端点（/v1beta）开发中，上线前 Gemini 导入暂不可用。

也可以用脚本生成链接并直接拉起（免手动复制）：

bash
npx wordrelay-setup cc-switch claude

方式二：手动添加 ​

以 Claude Code 为例：

  1. 打开 CC Switch，切到 Claude 应用页，点 + 添加供应商
  2. 预设下拉选 Custom（自定义）
  3. 粘贴以下配置 JSON：
json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://wordrelay.chat/cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
  }
}
  1. 保存后在供应商列表里点击 WordRelay 激活——CC Switch 会把它写入 Claude Code 的 ~/.claude/settings.json

Codex 的 Custom 配置形状不同（auth.json + config.toml），建议直接用方式一的导入链接。

添加后：拉取模型列表 ​

CC Switch 支持 Auto-Fetch Models：添加供应商后用它调一次模型端点，自动发现可用模型。词驿的 Claude 端点已支持该功能——填入令牌后点击拉取即可（打的是 GET /cc/v1/models，与数据面同源）。

故障排查 ​

点击链接没反应：CC Switch 安装时自动注册 ccswitch:// 协议，注册失败时：

  • macOS：重装应用，或运行 /usr/bin/open -a "CC Switch" --args --register-protocol
  • Windows：重装应用，或检查注册表 HKEY_CLASSES_ROOT\ccswitch
  • Linux：检查 .desktop 文件中的 MimeType 配置

导入失败：升级 CC Switch 到最新版再试（v1 导入协议需要较新版本）；或改用方式二手动添加。

切换后不生效：确认在 CC Switch 里点击了 WordRelay 行激活（高亮态），并在新终端里运行客户端。

© 2026 词驿 WordRelay