Gemini

Google Gemini CLI 配置指南

Google Gemini CLI 是 Google 官方的命令行 AI 编程工具。本页介绍如何在 CC-Switch 中配置 Gemini CLI 的 API 接入——支持直连 Google 官方端点(需开启 LinkAI Proxy)和第三方中转端点两种方式。

前提条件

  • 已下载并安装 LinkAI Proxy 客户端,且代理处于「已连接」状态
  • 已完成「环境准备」,Gemini CLI 可以正常启动
  • 已安装并打开 CC-Switch

配置步骤

1

在 CC-Switch 中切换到 Gemini 标签

打开 CC-Switch,点击顶部工具栏中的「Gemini」标签,下方将显示已保存的 Gemini 供应商列表。

2

添加供应商(官方端点)

点击右上角「+」按钮,进入「添加新供应商」界面: 1. 切换到「Gemini 供应商」标签 2. 点击预设中的「Google Official」 3. API Key 无需填写,官方供应商使用浏览器授权登录 4. 点击「+ 添加」保存 使用官方端点时,必须同时开启 LinkAI Proxy,否则国内无法连接 Google 服务器。

3

(可选)添加供应商(中转端点)

如果你购买了第三方中转服务,无需开启 LinkAI Proxy 即可使用: 1. 点击预设中的「自定义配置」 2. 填写供应商名称、API Key 和请求地址(中转服务商提供) 3. 点击「+ 添加」保存 ⚠️ LinkAI Proxy 本身不提供中转服务,中转 Token 需向第三方服务商购买。

4

启用供应商

保存后回到主界面,鼠标悬停在目标供应商上 → 点击「启用」。CC-Switch 会自动将 API Key 和请求地址写入 Gemini CLI 的配置文件。

5

验证配置

打开终端,运行 gemini 启动,能正常对话即说明配置生效。 如使用官方端点,请确认 LinkAI Proxy 处于「已连接」状态。

gemini

常见问题

Q:使用官方端点时提示连接超时?

A:请确认 LinkAI Proxy 已开启且状态为「已连接」。也可在终端手动设置代理:export HTTPS_PROXY=http://127.0.0.1:17891,再运行 gemini 重试。

Q:Gemini API Key 在哪里获取?

A:前往 Google AI Studio(aistudio.google.com)登录后,在左侧「API Keys」页面创建。需要有可用的 Google 账号,建议使用个人账号(企业 Workspace 账号可能有额外限制)。

Q:官方端点和中转端点有什么区别?

A:官方端点直连 Google 服务器,需要 LinkAI Proxy 代理。中转端点通过第三方转发,无需代理,但稳定性取决于中转服务商。