Gemini CLI 部署

Gemini CLI 适合想把 Google 系列模型接进命令行工作流的场景。接入 Token中转站时，思路和其他工具一样：装 CLI、填 Gemini 专用 Key、指定平台地址。

前置要求

已安装 Node.js 18+
已创建 Gemini 专用 Key
可选：安装 CC-Switch

CC-Switch 配置方式

打开 CC-Switch
进入 Gemini 标签页
新增配置
填写：
- 名称：token-gemini
- Base URL：https://rtai.jnrongtu.com
- API Key：Gemini 专用 Key
- 模型：按控制台可用模型选择
保存并启用
重启 Gemini CLI

手动安装

bash

npm install -g @google/gemini-cli
gemini --version

手动配置目录

Gemini CLI 常见配置目录：

Windows：%USERPROFILE%\.gemini\
macOS / Linux：~/.gemini/

`.env` 示例

txt

GOOGLE_GEMINI_BASE_URL=https://rtai.jnrongtu.com
GEMINI_API_KEY=你的专属密钥
GEMINI_MODEL=按控制台开放模型填写

`settings.json` 示例

json

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

快速验证

bash

gemini

如果命令能正常进入交互界面，且不会报 401、403 或 base URL 错误，说明配置已经基本完成。

使用建议

不同工具不要混 Key

Gemini、Claude、CodeX 最好用不同 Key，问题定位会更清楚。

模型名别硬背

Gemini 预览版、Flash、Pro 系列变化比较快，直接以控制台开放项为准。

长任务卡住怎么办

Gemini CLI 有时会在长会话里变得不稳定。遇到明显卡死：

直接开新会话
或改用桌面客户端 / VS Code 插件临时处理

常见问题

找不到配置目录

可以自己手动创建 ~/.gemini 或 %USERPROFILE%\.gemini。

明明写了 Key 但仍然失败

先看：

.env 是否真的被读到
是否有旧环境变量覆盖
Key 是否是 Gemini 令牌组

CLI 用一段时间后不响应

这是常见现象，最直接的解法是新开会话或重启 CLI。

Gemini CLI 部署 ​

前置要求 ​

CC-Switch 配置方式 ​

手动安装 ​

手动配置目录 ​

.env 示例 ​

settings.json 示例 ​

快速验证 ​

使用建议 ​

不同工具不要混 Key ​

模型名别硬背 ​

长任务卡住怎么办 ​

常见问题 ​

找不到配置目录 ​

明明写了 Key 但仍然失败 ​

CLI 用一段时间后不响应 ​

下一步 ​