Gemini CLI
Gemini CLI 是在终端里使用 Gemini 的入口，适合在本地项目中完成代码理解、生成和项目协作。使用 qiuqiutoken 时，优先用 CC Switch 写入配置，需要手动处理时再按下面的步骤操作。
前置条件
- 只有手动 npm 安装时，才需要提前准备 Node.js 18+ 与
npm。
推荐路径
- 优先使用 CC Switch 写入 qiuqiutoken provider、Gemini CLI 对应分组令牌、Base URL 与模型。
- CC Switch 不适用时，再按平台手动安装 Gemini CLI。
- 需要手动处理时，再继续看下面的
.env配置。
安装与配置
先在 快速开始 准备余额和 Gemini CLI 对应 Base URL，再到 创建 API 令牌 创建 Gemini CLI 对应分组令牌。
Windows
如果 CC Switch 已经完成配置，直接进入项目目录运行 gemini 验证；需要手动处理时再继续下面的流程。
手动安装 Node.js
如果你不用已有环境，可以从 Node.js 官网 下载 LTS 安装包，或在命令提示符 / Terminal 中任选一种包管理器安装。
winget install OpenJS.NodeJS.LTS
choco install nodejs-lts
scoop install nodejs-lts检查 Node.js 和 npm
打开新的命令提示符 / Terminal，确认 Node.js 与 npm 可用。
node -v
npm -v安装 Gemini CLI
使用 npm 全局安装 Gemini CLI。
npm install -g @google/gemini-cli检查 Gemini CLI
只检查版本，不要在 API 配置前直接运行交互式 gemini。
gemini --version配置目录
Windows 配置目录是 %USERPROFILE%\.gemini。
进入项目启动验证
写完配置后，进入你的项目目录启动 Gemini CLI。
cd your-project-folder
gemini手动配置
CC Switch 没有写入配置时，按下面步骤手动补齐。
创建配置目录
- Windows：
%USERPROFILE%\.gemini - macOS / Linux：
~/.gemini
先创建并进入对应目录。
mkdir %USERPROFILE%\.gemini
cd %USERPROFILE%\.gemini创建 .env
按 创建 API 令牌 准备好 Gemini CLI 对应分组令牌，并从 快速开始 复制 Gemini CLI 对应 Base URL 后，在配置目录中创建 .env。
GEMINI_API_KEY=粘贴为Gemini CLI对应分组令牌key
GOOGLE_GEMINI_BASE_URL=https://api.qiuqiutoken.com/v1重新打开终端
关闭所有 Gemini CLI 相关终端窗口，再打开新的终端，确保新配置被读取。
提示
如果 gemini 命令不存在，通常是 npm 全局 bin 目录未加入 PATH，或终端还没重启。先重新打开终端，再用 npm config get prefix 确认全局安装目录，并检查该目录下的 bin 路径是否已加入 PATH。
验证成功
- 终端能识别
gemini命令。 .env包含 Gemini CLI 对应分组令牌和GOOGLE_GEMINI_BASE_URL。- Gemini CLI 能在项目目录中启动并完成一次简单请求。
- qiuqiutoken 控制台出现对应用量记录。
常见问题
- 终端提示
gemini不存在：确认 npm 全局 bin 目录已加入 PATH，并重新打开终端。 - 安装时权限不足：优先修复 npm 用户级目录，不建议随意使用管理员权限覆盖系统文件。
- Node.js 版本过低：安装 Node.js 18+ 后关闭并重新打开终端，再重新检查版本。
- 启动后仍连接默认服务：确认
.env中的GOOGLE_GEMINI_BASE_URL指向 qiuqiutoken，再检查是否有旧环境变量或其他本地配置覆盖。 - 请求认证失败：检查
.env，再核对 Base URL 与 Gemini CLI 对应分组令牌。