如何通过第三方API使用Gemini CLI

基本介绍

Gemini CLI 是谷歌提供的开源命令行 AI 工具，将 Gemini 的强大功能直接带入您的终端。它提供轻量级的 Gemini 访问方式，为您提供从提示到模型的最直接路径。通过设置中转站（代理），您可以在网络受限的情况下正常使用 Gemini CLI 服务。

🚀 为什么选择 Gemini CLI？

• 🧠 强大的 Gemini 3：访问 100 万 token 上下文窗口
• 🔧 内置工具：Google 搜索基础功能、文件操作、Shell 命令、网页抓取
• 🔌 可扩展：支持 MCP（模型上下文协议）进行自定义集成
• 💻 终端优先：专为在命令行中工作的开发者设计
• 🛡️ 开源：Apache 2.0 许可证

📦 安装方式

快速安装

使用 npx 即时运行（无需安装）

# 使用官方仓库
npx https://github.com/google-gemini/gemini-cli

# 没有梯子可以使用国内源：
npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com

使用 npm 全局安装

npm install -g @google/gemini-cli

使用 Homebrew 安装（macOS/Linux）

brew install gemini-cli

系统要求

• Node.js 版本 20 或更高
• macOS、Linux 或 Windows

完成上面的安装，我们已经可以在终端中运行 Gemini CLI 了，首先会进行论证，默认是登录谷歌账号，但我们现在要使用第三方API进行访问，所以现在先不启动，而是配置第三方API的地址和密钥。

配置中转站（代理）使用

1. 设置环境变量

一劳永逸的方式是在配置文件中进行配置 ，这样后面任何时间，任何目录配置都能生效。 配置文件路径都是在当前用户目录下的 .gemini 目录下面。
如Windows系统：

C:\Users\user-xxx\.gemini

Linux:

/home/user-xxx/.gemini

涉及到两个文件：

将 settings.json 文件修改成下面内容：

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

如果环境变量文件 .env 不存在，则手动创建，然后将内容修改为下面内容：

GOOGLE_GEMINI_BASE_URL=https://fluxaihub.com
GEMINI_API_KEY=sk-xxxxxx
GEMINI_MODEL=gemini-3-flash-preview

本例中使用 流光AI部署的API 作为中转站，提供API转发服务。 流光AI致力于为开发者提供快速、便捷的 Web API 接口调用方案，打造稳定且易于使用的 API 接口平台，一站式集成几乎所有AI大模型。

🚀 快速开始

基本使用

在当前目录启动

gemini

启动 Gemini CLI，并开始与您的代码库进行交互。Ubuntu使用示例：

包含多个目录

gemini --include-directories ../lib,../docs

使用特定模型

gemini -m gemini-2.5-flash

脚本非交互模式

获取简单文本响应：

gemini -p "解释这个代码库的架构"

获取结构化 JSON 输出：

gemini -p "解释这个代码库的架构" --output-format json

快速示例

启动新项目

cd new-project/
gemini
> 为我编写一个 Discord 机器人，使用我提供的 FAQ.md 文件回答问题

分析现有代码

Microsoft Terminal使用示例:

gemini
> 这是一个使用astro和astrowind的项目，先了解一下

至此，你可以快乐地使用Gemini CLI了。