Gemini CLI 安装与配置完整教程：从安装到认证的实用指南
很多人会搜 Gemini CLI，真正想解决的问题其实只有两个：怎么装，怎么认证。
如果你后面还要把模型接进自己的客户端、脚本或统一网关，也可以顺手对照这两个入口：
但要先把边界说清楚：Gemini CLI 官方认证链路和第三方 API 中转不是一回事。先把官方安装和认证搞清楚，再看第三方兼容方案，才不会一直在错误的方向上排错。
Gemini CLI 是什么
Gemini CLI 是 Google 提供的命令行工具，用来在终端里直接调用 Gemini 能力。它适合：
- 在本地仓库里快速问代码问题
- 在终端里做文本和脚本辅助
- 把 Gemini 接进开发者工作流
如果你只是要在代码里调用模型，其实直接用 SDK 更直白；如果你想在终端里长期使用，Gemini CLI 会更顺手。
第一步：安装 Gemini CLI
Gemini CLI 官方文档当前的安装方式以其安装文档为准。安装完成后，先确认命令能正常执行：
bash
gemini --help如果系统提示 command not found，先不要急着配 Key，先检查：
- 安装命令是否执行完成
- 可执行文件是否已加入
PATH - 当前 shell 配置是否已刷新
第二步：先走官方认证链路
根据 Gemini CLI 官方认证文档，最直接的方式之一是使用 Gemini API Key。你可以先在 Google AI Studio 获取 Key，然后配置环境变量：
bash
export GEMINI_API_KEY="your-gemini-api-key"然后启动 CLI：
bash
gemini如果 CLI 提示选择认证方式，按官方文档选择 Use Gemini API key。
这里的好处是链路最清晰，排错最简单。你至少可以先确认：
- CLI 自己没装坏
- 当前环境变量是生效的
- API Key 本身是可用的
国内使用 Gemini CLI 时最容易误解的地方
1. 以为第三方 API 能直接替代官方登录
并不是所有第三方入口都能直接给 Gemini CLI 用。Gemini CLI 依赖的认证流程和普通 OpenAI 兼容接口不完全一样，很多“能调 Gemini 模型”的代理，不一定“能给 Gemini CLI 直接登录或认证”。
2. 把中转站当成 Gemini CLI 的官方认证入口
api.clawsocket.com 和 ai-api-proxy.com 更适合做统一 API 入口、SDK 接入、客户端配置或多模型路由。
如果你的目标只是让 Gemini CLI 本身先跑起来，优先走官方认证会省掉大量无效排错。
3. 认证没过就开始排模型问题
只要认证没完全打通，后面的模型名、功能开关、长上下文表现都不值得排。
第三步：怎么验证 Gemini CLI 已经能用
先从最小请求开始：
bash
gemini "用一句话介绍 Gemini CLI 的作用"如果返回正常，再测一个稍复杂的：
bash
gemini "读取当前目录的项目结构，并总结主要技术栈"先小后大，原因很简单：你要先区分“CLI 根本没通”还是“复杂任务才出问题”。
第四步：什么时候该结合 API 中转站
如果你后面的目标不是只用 CLI，而是：
- 在自己的程序里调 Gemini
- 在 LobeChat、Chatbox 里切模型
- 想统一接 Claude、OpenAI、Gemini
那么这时候再看 api.clawsocket.com 和 ai-api-proxy.com 就很合理。
这类入口更适合 SDK、客户端、聚合网关场景，而不是拿来替代 Gemini CLI 所有官方认证逻辑。
常见问题
GEMINI_API_KEY 已经配了，还是报认证错误
先检查：
bash
env | grep GEMINI_API_KEY很多时候不是 Key 无效，而是：
- 当前终端没刷新
- 写进了另一个 shell 配置文件
- 复制时带了空格或换行
安装成功了，但 gemini 命令找不到
先看可执行文件路径，再把对应目录补进 PATH。
第三方入口能不能直接给 Gemini CLI 用
这取决于该平台当前是否明确提供 Gemini CLI 兼容方案。没有明确写支持，就不要默认能用。更稳的做法是把第三方入口用于 SDK 和客户端，把 CLI 走官方认证。
结论
Gemini CLI 安装与配置这件事，最稳的路线其实很简单：
- 先按官方文档装好
- 先用官方 API Key 认证跑通
- 再决定哪些场景要接 API 中转站
如果你后面要做统一接入、多模型切换和客户端配置，再去研究 api.clawsocket.com 与 ai-api-proxy.com 会更合适。先把 Gemini CLI 自身跑通，后面所有事情都会简单很多。