注册
各种插件/软件使用教程 / Gemini CLI 中转站配置使用教程

Gemini CLI 中转站配置使用教程

基本介绍

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

为什么选择 Gemini CLI？

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

安装方式

快速安装

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

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

使用 npm 全局安装

npm install -g @google/gemini-cli

使用 Homebrew 安装（macOS/Linux）

brew install gemini-cli

系统要求

Node.js 20+，支持 macOS、Linux、Windows

配置中转站（代理）使用

1. 设置环境变量

在终端中运行以下命令，将 API Key 和 Base URL 设置为 QuickRouter 的地址：

macOS / Linux（添加到 ~/.bashrc 或 ~/.zshrc）：

export GEMINI_API_KEY=sk-xxxxx
export GOOGLE_GEMINI_BASE_URL=https://api.quickrouter.ai

Windows CMD：

set GEMINI_API_KEY=sk-xxxxx
set GOOGLE_GEMINI_BASE_URL=https://api.quickrouter.ai

快速开始

基本使用

在当前目录启动

gemini

包含多个目录

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 文件回答问题

分析现有代码

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> 给我一个昨天所有更改的摘要

主要功能

代码理解与生成

  • 从自然语言描述生成代码
  • 解释和重构现有代码
  • 编写测试用例
  • 调试和修复 Bug

自动化与集成

  • 自动化重复性任务
  • 与 Git 工作流集成
  • 操作文件系统
  • 运行 Shell 命令

高级功能

  • Google 搜索集成
  • 对话检查点（保存和恢复对话状态）
  • 自定义 GEMINI.md 文件（项目级指令）

常用命令和功能示例

探索代码库

> 描述这个系统架构的主要组成部分
> 有哪些安全机制？
> 为新开发者提供一份分步骤的入门文档

处理现有代码

> 为 GitHub issue #123 实现一个初稿
> 帮我将这个代码库迁移到最新版本的 Java。先制定一个计划

自动化工作流程

> 制作一个幻灯片，展示过去 7 天的 git 历史，突出重要的功能变更
> 制作一个全屏 Web 应用用于墙上展示，显示 GitLab 中未解决的告警

系统交互

> 将此目录中的所有图像转换为 png 并根据 EXIF 日期重命名
> 按支出月份整理我的 PDF 发票

GitHub 集成

Gemini CLI 支持 GitHub 集成，可以：

  • PR 审查和评论
  • Issue 分类和处理
  • 通过 @gemini-cli 按需获取帮助
  • 自定义工作流

故障排除

  1. 检查环境变量： 
    echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL
  2. 检查网络连通性： curl -I https://api.quickrouter.ai
  3. 查看错误信息：根据错误消息定位问题
  4. SOCKS 代理格式：确保格式为 socks5://user:pass@proxy:port
  5. 报告 Bug： 
    # 在 CLI 中直接报告 bug
/bug

发布版本说明

预览版（Preview）

npm install -g @google/gemini-cli@preview

每周二 UTC 23:59 发布

稳定版（Stable）

npm install -g @google/gemini-cli@latest

每周二 UTC 20:00 发布

每夜版（Nightly）

npm install -g @google/gemini-cli@nightly

每日 UTC 00:00 发布

MCP 服务器使用

通过配置 ~/.gemini/settings.json 可以扩展 Gemini CLI 的功能，添加自定义工具集成。

> @github 列出我的开放拉取请求
> @slack 向 #dev 频道发送今天提交的摘要
> @database 运行查询查找不活跃用户

相关资源

  • 官方路线图
  • NPM 包：@google/gemini-cli
  • GitHub Issues
  • 安全公告

卸载

npm uninstall -g @google/gemini-cli

相关文档

Gemini CLI 配置 API 中转配置要点

如果你通过搜索“Gemini CLI 配置 配置教程”“Gemini CLI 配置 API 中转”“Gemini CLI 配置 QuickRouter”进入本页，优先检查 API Key、Base URL 和模型 ID。多数调用失败都和这三个配置有关。

配置项填写建议常见问题
API Key填写 QuickRouter 控制台创建的密钥401 通常是 Key 错误、过期或额度不足
Base URL按本页工具要求填写 QuickRouter 接口地址；OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1Claude/Anthropic 类工具不一定带 /v1
模型 ID从价格页复制完整模型名model not found 通常是模型名或分组权限问题

常见排查方向

  • 401 Unauthorized：检查 API Key 是否复制完整、是否仍有额度。
  • 404 或 model not found：检查模型 ID 是否来自 QuickRouter 价格页，确认当前分组支持该模型。
  • 连接超时：确认工具里的 Base URL 没有多写路径或空格。
  • Claude 相关工具异常：优先查看本页是否要求 Anthropic 原生地址，不要直接套用 OpenAI 兼容地址。

相关入口

常见问题

Gemini CLI 配置 可以通过 QuickRouter API 接入大模型吗？

可以。只要 Gemini CLI 配置 支持自定义 API Key、Base URL 或兼容 OpenAI/Claude 的接口，就可以按本页方式接入 QuickRouter。

Gemini CLI 配置 的 Base URL 应该怎么填？

按本页对应工具的要求填写。OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1，Claude/Anthropic 类工具可能使用 https://api.quickrouter.ai。

Gemini CLI 配置 提示 model not found 怎么办？

到 模型价格和分组 页面复制完整模型 ID，并确认 API Key 所在分组支持该模型。

← opencode 配置教程 Claude Code 安装使用教程 →