接入教程

中转接入教程

按工具查看接入步骤和排查方法。

首页/中转接入教程/Gemini CLI 配置

Gemini CLI 配置

Gemini CLI 是 Google 的终端 AI 工具。它适合在命令行里使用 Gemini 进行问答、代码理解和项目辅助。

官方信息 下载和文档以官方站点为准
Gemini CLI 官方文档 安装、命令和配置入口 认证文档 Google 登录、Gemini API Key 和 Vertex AI GitHub 开源仓库和版本信息

这个工具是什么，用于什么

Google Gemini终端工具Google 登录Gemini API Key

先选认证方式

方式适合谁说明
Google 登录个人用户和新手运行 gemini 后按提示登录
Gemini API Key已有 Google AI Studio Key 的用户把 Key 放到 GEMINI_API_KEY
Vertex AI企业或云项目用户按 Google Cloud 项目和权限配置

API Key 怎么测试

PowerShell 临时测试
$env:GEMINI_API_KEY = "你的_Gemini_API_Key" gemini

测试成功后怎么继续

  1. 先在空目录里运行 Gemini CLI，不要直接打开重要项目。
  2. 只问一个固定短问题，确认模型能正常回复。
  3. 再让它阅读一个测试文件，并明确要求不要修改文件。
  4. 如果要长期使用 API Key，再按 Gemini CLI 官方文档把认证方式保存到本机环境或配置中。
  5. 如果切换过中转站或 CC-Switch，重新打开终端后再测。
现象优先检查处理
仍要求 Google 登录当前认证方式是否是 Google 登录流程先按 Gemini CLI 自身提示完成认证；API Key 和登录流程不要混着排查
Key 无效GEMINI_API_KEY 是否属于 Google AI Studio / Gemini不要把 OpenAI 或 Claude Key 填给 Gemini
模型不可用模型名是否来自 Gemini 列表不要把 OpenAI / Claude 模型名填到 Gemini CLI

中转站配置要注意什么

Gemini CLI 和 OpenAI 兼容中转站不是一回事。只有当服务商明确写了 Gemini CLI、Google Gemini 或 Vertex AI 的配置方法，才按它的教程操作。

不要把普通 OpenAI Base URL 填给 Gemini CLI。OpenAI、Claude、Gemini 是三套不同协议，服务商后台如果分开提供地址，就必须填对应工具的那一个。
Gemini CLI 官方文档 查看安装、命令和配置入口。
Gemini CLI 认证文档 查看 Google 登录、Gemini API Key 和 Vertex AI。