跳到主要内容

Gemini CLI

Gemini CLI 官方未确认第三方 Base URL；当前只把 CC Switch 路径记录为已实现兼容入口。

配置前先确认​

  • 本页只写占位符；实际 Key 从 PopGo API 密钥页复制，模型从模型与价格页复制。
  • 一键配置适合已安装并注册协议的软件；浏览器提示打开外部应用时，需要允许一次。
  • 手动配置时先保存一个最小 Provider，首个请求成功后再启用流式、工具调用或多模型路由。

官方来源与核验​

本页于 2026-07-13 根据官方来源核验 Gemini CLI 0.50.0。 官方来源. 兼容性为 partial，不把未获确认的直接环境变量写成官方能力。

一键配置​

登录 PopGo API 密钥页，在目标 Key 所在行打开操作菜单。公开文档不会生成或展示任何带 Key 的跳转链接。 依次选择 CC Switch 和 Gemini。 完成 CC Switch 的 Gemini 导入后，不要寻找本文档未列出的直接变量。

手动配置​

没有经过官方确认的第三方 Base URL 手动方案。本页不提供虚构的环境变量。

  • 先确认 gemini --version 能运行；本页只记录 CC Switch 路径，不写未经确认的 Base URL 变量。
  • 导入后从新终端启动 Gemini CLI，并确认当前会话实际使用的是导入配置。

安装与验证​

Gemini CLI 的第三方 Base URL 手动变量没有在本页核验为稳定能力，因此这里不写本地环境文件方案，也不写未确认变量名。你可以先只完成 CLI 安装，再通过 CC Switch 导入 PopGo 配置。

Windows / macOS / Linux​

  1. 安装 Node.js 22 或更高版本。
  2. 按 Gemini CLI 官方安装方式完成安装，并确认命令可用：
gemini --version
  1. 如果命令找不到，重新打开终端；仍失败时检查 npm 全局安装路径是否在 PATH。
  2. 回到 PopGo API 密钥页，选择目标 Key 的操作菜单，依次选择 CC Switch 和 Gemini。
  3. 导入完成后从新终端启动 Gemini CLI，用 YOUR_MODEL 做一次短请求。

为什么不写直接 .env 配置​

来源文档里有直接写入本地环境文件的方案，但那里面包含其他中转站域名、固定模型名和未核验变量。为了避免新手照抄后连到错误服务，本页只保留已实现的一键兼容入口。后续如果官方确认稳定的第三方 Base URL 配置方式，再补充手动步骤。

常见现象​

  • gemini: command not found：重新打开终端，或重新安装官方包。
  • 导入后仍请求默认服务：确认从新终端启动，并检查 CC Switch 当前目标是否切换到 Gemini。
  • API key invalid：不要继续改未核验的本地环境文件，先回到 Key 页重新导入或重新复制 Key。

成功判断​

CC Switch 导入后从新终端启动 Gemini CLI；能用 YOUR_MODEL 完成请求才算成功。

常见错误和恢复​

  • CC Switch 导入失败时按其教程恢复，不要改用来源不明的变量名。
  • 出现 401 时，重新粘贴 YOUR_API_KEY 并检查是否带有首尾空格。
  • 出现 404 时，核对 Base URL 层级，避免客户端重复追加 /v1。