词驿 WordRelay

主题

Gemini CLI 配置 ​

Gemini CLI 是 Google 的命令行 AI 工具，通过 Gemini 兼容接口对接词驿。

端点开发中

词驿网关的 Gemini 原生端点（/v1beta）尚未开放：配置可以写入（脚本/手动均可），但上线前 Gemini CLI 调用不会成功。其余客户端（Claude Code、Codex）不受影响。

一键配置 ​

npx 方式（Node 18+，零依赖单文件可审计）：直接传参一步到位，脚本会自动写入 ~/.gemini/settings.json（写入前自动备份，可重复执行）：

bash
npx wordrelay-setup gemini-cli sk-你的令牌

省略令牌参数时进入交互向导（选客户端 -> 输令牌 -> 确认）。卸载配置：

bash
npx wordrelay-setup gemini-cli --remove

若配置文件由脚本首次创建（无原配置可还原），卸载时会明确列出仍写有令牌的文件，请按提示手动删除对应键或整个文件。

一键脚本（无 Node 环境时）：

bash
bash <(curl -fsSL https://docs.wordrelay.chat/setup.sh) gemini-cli sk-你的令牌

Windows 用户

Windows 原生请用 PowerShell 版一键配置；本页命令需在 WSL 或 Git Bash 中运行，或按下方手动配置。

手动配置步骤 ​

在 ~/.gemini/settings.json 中写入 env 段（Gemini CLI 启动时会读取这些环境变量）：

json
{
  "env": {
    "GOOGLE_GEMINI_BASE_URL": "https://wordrelay.chat",
    "GEMINI_API_KEY": "sk-你的令牌"
  }
}

词驿兼容 Gemini 原生协议（/v1beta/models/{model}:generateContent 等），Gemini CLI 会自动拼接该前缀。也可用 OpenAI Chat 协议调用 gemini-* 模型（词驿自动转译）。

分组 ​

Gemini CLI 不支持自定义请求头，通过令牌绑定分组控制上游渠道：在控制台新建令牌并绑定目标分组，把该令牌填入 GEMINI_API_KEY。

© 2026 词驿 WordRelay