免费使用 Gemini CLI 完整教程：借助 OMini Router 配置全流程

前言：为什么选择 Gemini CLI

Gemini CLI 是可以在终端环境中直接调用 Gemini 模型能力的命令行工具，适合开发者在编码、脚本处理和自动化场景中快速接入大模型。相比在网页端反复切换窗口，命令行方式更贴近开发工作流。

这篇教程基于 B站 UP 主的实操演示整理，介绍如何通过 OMini Router 这一中转方案，在本地电脑上免费跑通 Gemini CLI。此前该作者已经分享过 Claude Code、Kimi Code、PyAgent 等工具的类似配置方法，Gemini CLI 的思路一脉相承，但配置细节略有不同，值得单独说明。

前置条件：安装 Node.js

Gemini CLI 依赖 Node.js 运行环境，因此第一步必须确认本地已经安装 Node.js。如果尚未安装，可前往 Node.js 官网下载对应操作系统的安装包，建议选择 LTS 长期支持版本以保证稳定性。

环境就绪后，打开浏览器进入 Gemini CLI 官网，页面上会提供官方的安装命令。直接复制该命令到终端执行即可完成工具安装，整个过程无需额外的复杂操作。

进入Gemini CLI的官网

启动 OMini Router

实现免费使用的关键在于 OMini Router。它相当于一个本地运行的请求中转服务，负责把 Gemini CLI 发出的请求转发到实际的模型接口。安装好 Gemini CLI 之后，需要先把 OMini Router 启动起来，后续的所有配置都会指向它提供的本地地址。

对于不熟悉 OMini Router 的读者，作者提到可以参考其之前发布的相关视频，那里对 OMini Router 的安装和基本使用有更详细的讲解。本文默认你已经完成了 OMini Router 的部署，这里只聚焦它与 Gemini CLI 的对接。

可以看一下我之前的视频

OMini Router 本质上是一个本地反向代理服务，遵循 OpenAI API 兼容接口规范，能够将符合该格式的请求统一转发到多种后端模型。这种设计使它可以作为通用中间层，让 Gemini CLI、Claude Code、Kimi Code 等不同工具只需指向同一个本地地址即可工作，无需为每个工具单独维护鉴权信息。OMini Router 通常以 http://localhost:端口号 的形式在本机监听请求，Gemini CLI 的 Base URL 配置就指向该地址。中转方案的优势在于隐藏了真实 API Key 的分发逻辑，并可在 Router 侧统一做限流、日志或模型路由，但可用性也因此依赖本地服务持续运行，一旦 OMini Router 进程退出，CLI 工具将立即失去响应。

配置环境变量

Gemini CLI 的配置方式与作者此前介绍的其他工具略有差异，需要先设置两个环境变量。

第一个：OMini Router 地址

打开一个新的终端窗口，配置指向 OMini Router 的地址。这里有一个容易踩坑的细节——该地址不带 v1 路径。很多配置失败的情况正是因为在地址后面多加了版本路径，导致请求无法正确转发。

不带 v1 路径的原因在于 Gemini CLI 内部会自行拼接 API 版本路径。大多数 OpenAI 兼容客户端在构造请求时会在 Base URL 后追加 /v1/chat/completions 或类似路径，若 Base URL 本身已包含 /v1，最终请求路径会变成 /v1/v1/...，导致 404 或路由匹配失败。正确做法是只填写根地址，例如 http://localhost:10086，让客户端自己完成路径拼接。这一行为与 OpenAI 官方 SDK 的约定一致，但不同工具的处理逻辑可能存在细微差异，遇到连接失败时检查完整请求路径是最直接的排查手段。

第二个：API Token

第二个环境变量是 API Token，这个 Token 来自 OMini Router 内部创建的 API Token。如果你看过作者之前的视频，应该对如何在 OMini Router 里生成 Token 已经比较熟悉。把创建好的 Token 填入对应的环境变量即可。

记得这个地址不带 v1 路径

修改配置文件

环境变量设置完成后，还需要修改 Gemini CLI 的配置文件。核心是三个字段：

Base URL：填写 OMini Router 提供的接口地址
API Key：填入前面创建的 API Token
Model：指定要调用的模型名称

这三项配置构成了 Gemini CLI 与中转服务之间通信的完整链路。只要三个字段填写正确、彼此对应，工具就能顺利把请求发送到正确的目标。作者在演示中提到自己已经提前配置好了这份文件，因此没有逐字段演示，但从字段结构上看，与常见的 OpenAI 兼容接口配置逻辑基本一致。

配置文件已提前配置好

运行验证

完成上述所有步骤后，直接运行 Gemini CLI。如果配置无误，工具会正常启动并进入可交互状态，说明整条链路已经打通。作者在实测中确认运行完整、没有出现问题。

遇到运行报错时，建议按以下顺序排查：确认 OMini Router 是否处于启动状态、检查 Base URL 是否误加了 v1 路径、核对 API Token 是否与 OMini Router 中的一致、确认 Model 名称是否被中转服务支持。这几项是配置类问题最常见的来源。

小结

通过 OMini Router 中转，Gemini CLI 的免费本地使用流程可以概括为四步：安装 Node.js 与 Gemini CLI、启动 OMini Router、配置两个环境变量、修改配置文件的三个字段。整套方案与 Claude Code、Kimi Code 等工具的思路相通，掌握一种即可举一反三。

需要提醒的是，此类中转方案的可用性依赖第三方服务的持续运行，实际使用前建议关注 OMini Router 的最新状态与合规要求，理性评估是否符合自身的使用场景。