词驿 WordRelay

主题

接入指南 ​

拿到词驿令牌后，把客户端指向网关只需一步。词驿提供三种接入方式，从「管理多家供应商配置」到「零依赖纯手动」各有侧重——写入的配置内容三轨完全一致，选顺手的即可：

方式适合谁一条命令
CC Switch（推荐）同时用多家供应商、需要一键切换npx wordrelay-setup cc-switch
npx 脚本只想快速写好本机配置npx wordrelay-setup
手动配置零依赖、完全掌控每一步见客户端配置各页

另有一键脚本（curl | bash / PowerShell）作为 npx 的等价形态，见下方。

CC Switch（推荐） ​

CC Switch 是开源的供应商切换器，统一管理 Claude Code、Codex、Gemini CLI 等多个工具的多家供应商配置，点一下完成切换。词驿官方物料已适配其导入协议：

bash
# 生成一键导入链接并尝试拉起 cc-switch
npx wordrelay-setup cc-switch

# 指定导入目标应用（claude | codex | gemini）
npx wordrelay-setup cc-switch claude

深链不含令牌——导入确认后在 cc-switch 里填入你的词驿令牌即可。完整步骤（含手动添加路径）见 CC Switch 配置。

npx 脚本 ​

bash
# 交互式：选客户端 → 输令牌 → 确认写入
npx wordrelay-setup

# 直接传参（脚本化 / CI）
npx wordrelay-setup claude-code sk-你的令牌
npx wordrelay-setup codex sk-你的令牌

# 预览将写入的内容，不落盘
npx wordrelay-setup claude-code sk-你的令牌 --dry-run

# 查看本机接入状态 / 还原最近一次备份
npx wordrelay-setup --list
npx wordrelay-setup claude-code --remove

要求 Node 18+。整个包只有一个文件、零依赖、零网络行为——npx 拉下来即可人工审完，不存在安装脚本或埋在依赖里的行为。安全特性：

  • 写前自动备份：原配置保存为 *.bak.时间戳，可重复执行（幂等）
  • 合并不覆盖：JSON 深合并保留你已有的其他配置项（如 theme、模型映射）
  • 写后校验：落盘后回读确认写入生效，失败即报错并提示备份位置

一键脚本 ​

curl | bash 与 PowerShell 形态，功能与 npx 脚本一致（适合无 Node 环境的机器）：

bash
# 交互向导 / 非交互带参
bash <(curl -fsSL https://docs.wordrelay.chat/setup.sh)
bash <(curl -fsSL https://docs.wordrelay.chat/setup.sh) claude-code sk-你的令牌
powershell
# Windows PowerShell 5.1+ / 7（交互向导）
iex (irm https://docs.wordrelay.chat/setup.ps1)

# 非交互带参 / 卸载
& ([scriptblock]::Create((irm https://docs.wordrelay.chat/setup.ps1))) claude-code sk-你的令牌
& ([scriptblock]::Create((irm https://docs.wordrelay.chat/setup.ps1))) claude-code -Remove
中文显示乱码时（PowerShell）

iex (irm ...) 依赖响应头 charset=utf-8（文档站已配置）。若经代理等中间层仍出现乱码，改用显式 UTF-8 读取：

powershell
irm https://docs.wordrelay.chat/setup.ps1 -OutFile $env:TEMP\ciyi-setup.ps1
iex (Get-Content -Raw -Encoding UTF8 $env:TEMP\ciyi-setup.ps1)

脚本需要 jq 或 python3（二选一）解析 JSON，绝大多数系统已内置。Windows 原生用 PowerShell 版；bash 版在 WSL 或 Git Bash 中运行。

写入了什么 ​

客户端写入文件内容
Claude Code~/.claude/settings.jsonANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN
Codex~/.codex/auth.json、~/.codex/config.tomlOPENAI_API_KEY 与 model_provider 指向词驿
Gemini CLI~/.gemini/settings.jsonGOOGLE_GEMINI_BASE_URL 与 GEMINI_API_KEY

Gemini CLI 现状

词驿网关的 Gemini 原生端点（/v1beta）开发中，上线前 Gemini CLI 接入暂不可用（工具可以写配置，但调用不会成功）。

端点域总览 ​

三轨写入的地址遵循同一口径：

端点渠道池适用
https://wordrelay.chat/cccoding（CLI 订阅渠道）Claude Code 等 CLI 编程工具
https://wordrelay.chat/agent/v1agentagent 工作负载
https://wordrelay.chat/v1default普通 OpenAI 兼容调用

任意令牌可调任意端点（域与池正交）；coding 端点的隔离语义见 Claude Code 配置。

令牌安全三原则 ​

  1. 自助签发：在词驿门户自助签发令牌（挂分组、限额、可吊销），不要共用他人令牌
  2. 最小权限：按用途建令牌——一台机器一枚，废弃即吊销
  3. 不入库房：真实 API Key 不提交到 dotfiles 仓库、不进分享的配置片段

进阶：client-config 端点 ​

网关提供机器可读的配置端点，一条 curl 拿到即贴即用的配置片段（脚本与文档的单一口径源）：

bash
curl -s -H "Authorization: Bearer sk-你的令牌" \
  "https://wordrelay.chat/v1/client-config?tool=claude-code&substitute_token=true"

tool 可选 claude-code / codex / gemini-cli / cc-switch；substitute_token=true 把你请求用的令牌代入响应（同一连接回显自身，无泄漏面）。

© 2026 词驿 WordRelay