配置 Gemini CLI

Kitcoding 支持在 Gemini CLI 中使用。

前置条件

1. 已创建令牌，推荐分组：Default。
2. 安装 Gemini CLI 需要 Node.js（npm 方式），详见 环境检查。

一、安装

npm

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

Homebrew

brew install gemini-cli

二、生成配置目录

安装后先运行一次 gemini 生成 .gemini 配置目录。

三、配置 .env

打开 Gemini CLI 配置目录：

• Windows：Win + R 输入 %userprofile%\.gemini
• macOS：访达 Command + Shift + G 输入 ~/.gemini

若没有 .env 文件，新建一个，写入：

GOOGLE_GEMINI_BASE_URL=https://kitcoding.com
GEMINI_API_KEY=你的-kitcoding-令牌
GEMINI_MODEL=gemini-3.1-pro

GEMINI_MODEL 按 模型广场 实际可用模型填写。default 分组当前可用的对话模型：

模型 ID	适用
gemini-3.1-pro	主力，复杂推理（另有 -high / -low 变体）
gemini-3.6-flash	最新快速档
gemini-3.5-flash	快速档
gemini-3.1-flash-lite	最省，简单任务
gemini-2.5-pro	老版本，仅在需要兼容旧行为时使用

四、验证

终端运行 gemini，能正常进入对话并收到回复即配置成功。

用 cc-switch 配置（可选捷径）

不想手动改 .env？cc-switch 可在图形界面里一键安装 Gemini CLI 并填好配置，自动写入上面的 .env，因此选这条路就无需手动执行第一～三步。详见 cc-switch 文档。