配置 Gemini CLI

Kitcoding 支持在 Gemini CLI 中使用。

前置条件

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

💡 新手推荐：用 cc-switch 一键搞定

不想碰命令行和配置文件？推荐用图形化工具 cc-switch ——它能帮你一键安装 CLI 并自动填好配置，是最省心的方式。

下方的手动配置适合想搞清楚原理、或不想装额外工具的用户。两条路二选一即可。

一、安装

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-2.5-pro

GEMINI_MODEL 按 模型广场 实际可用模型填写。

四、验证

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

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

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