注册
各种插件/软件使用教程 / 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

相关文档

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