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 即时运行（无需安装）

bash
 体验AI代码助手
 代码解读
复制代码
# 使用官方仓库
npx <https://github.com/google-gemini/gemini-cli>

使用 npm 全局安装

bash
 体验AI代码助手
 代码解读
复制代码
npm install -g @google/gemini-cli

使用 Homebrew 安装（macOS/Linux）

bash
 体验AI代码助手
 代码解读
复制代码
brew install gemini-cli

系统要求

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

配置中转站（代理）使用

1. 设置环境变量

在使用中转站之前，您需要配置以下环境变量：

bash
 体验AI代码助手
 代码解读
复制代码
# 设置 API 密钥
export GEMINI_API_KEY=sk-xxxxx

# 设置 API 中转站地址
export GOOGLE_GEMINI_BASE_URL=https://api.88api.chat

#cmd 使用下面这个

set GEMINI_API_KEY=sk-xxxxx
set GOOGLE_GEMINI_BASE_URL=https://api.88api.chat

注意：您也可以将这些环境变量添加到 .bashrc、.zshrc 或其他 shell 配置文件中，这样每次启动终端时都会自动设置这些变量。

🚀 快速开始

基本使用

在当前目录启动

bash
 体验AI代码助手
 代码解读
复制代码
gemini

包含多个目录

bash
 体验AI代码助手
 代码解读
复制代码
gemini --include-directories ../lib,../docs

使用特定模型

bash
 体验AI代码助手
 代码解读
复制代码
gemini -m gemini-2.5-flash

脚本非交互模式

获取简单文本响应：

bash
 体验AI代码助手
 代码解读
复制代码
gemini -p "解释这个代码库的架构"

获取结构化 JSON 输出：

bash
 体验AI代码助手
 代码解读
复制代码
gemini -p "解释这个代码库的架构" --output-format json

快速示例

启动新项目

bash
 体验AI代码助手
 代码解读
复制代码
cd new-project/
gemini
> 为我编写一个 Discord 机器人，使用我提供的 FAQ.md 文件回答问题

分析现有代码

bash
 体验AI代码助手
 代码解读
复制代码
git clone <https://github.com/google-gemini/gemini-cli>
cd gemini-cli
gemini
> 给我一个昨天所有更改的摘要

📋 主要功能

代码理解与生成

• 查询和编辑大型代码库
• 使用多模态能力从 PDF、图片或草图生成新应用
• 使用自然语言调试问题和故障排除

自动化与集成

• 自动化操作任务，如查询拉取请求或处理复杂的变基操作
• 使用 MCP 服务器连接新功能
• 在脚本中非交互式运行以实现工作流自动化

高级功能

• 使用内置 Google 搜索获取实时信息
• 对话检查点以保存和恢复复杂会话
• 自定义上下文文件（GEMINI.md）为您的项目定制行为

常用命令和功能示例

探索代码库

markdown
 体验AI代码助手
 代码解读
复制代码
> 描述这个系统架构的主要组成部分
> 有哪些安全机制？
> 为新开发者提供一份分步骤的入门文档

处理现有代码

shell
 体验AI代码助手
 代码解读
复制代码
> 为 GitHub issue #123 实现一个初稿
> 帮我将这个代码库迁移到最新版本的 Java。先制定一个计划

自动化工作流程

markdown
 体验AI代码助手
 代码解读
复制代码
> 制作一个幻灯片，展示过去 7 天的 git 历史，按功能和团队成员分组
> 制作一个全屏 Web 应用用于墙上显示，展示我们互动最多的 GitHub issues

系统交互

markdown
 体验AI代码助手
 代码解读
复制代码
> 将此目录中的所有图像转换为 png，并使用 exif 数据中的日期重命名它们
> 按支出月份整理我的 PDF 发票

GitHub 集成

使用 Gemini CLI GitHub Action 将 Gemini CLI 直接集成到您的 GitHub 工作流中：

• 拉取请求审查：自动代码审查，提供上下文反馈和建议
• Issue 分类：基于内容分析自动标记和优先级排序 GitHub issues
• 按需帮助：在 issues 和拉取请求中提及 @gemini-cli 获取调试、解释或任务委派的帮助
• 自定义工作流：构建适合您团队需求的自动化、定时和按需工作流

故障排除

如果您在使用过程中遇到问题，可以参考以下几点：

1. 检查环境变量是否正确设置：

   bash
    体验AI代码助手
    代码解读
   复制代码
   echo $GEMINI_API_KEY
   echo $GOOGLE_GEMINI_BASE_URL
   

2. 检查网络连接是否稳定，中转站是否可访问：

   bash
    体验AI代码助手
    代码解读
   复制代码
   curl -I <https://api.88api.chat>
   

3. 查看是否有错误信息输出，这些信息通常会指示问题所在

4. 如果使用 SOCKS 代理，确保代理格式正确，例如 socks5://<user>:<pass>@<proxy>:<port>

5. 使用内置命令报告问题：

   bash
    体验AI代码助手
    代码解读
   复制代码
   # 在 CLI 中直接报告 bug
   /bug
   

发布版本说明

预览版（Preview）

每周二 UTC 23:59 发布新的预览版本。使用 preview 标签安装：

bash
 体验AI代码助手
 代码解读
复制代码
npm install -g @google/gemini-cli@preview

稳定版（Stable）

每周二 UTC 20:00 发布新的稳定版本。使用 latest 标签安装： 0 1 2 3 4 5 6 7 8 9

bash
 体验AI代码助手
 代码解读
复制代码
npm install -g @google/gemini-cli@latest

每夜版（Nightly）

每天 UTC 00:00 发布每夜版本。使用 nightly 标签安装：

bash
 体验AI代码助手
 代码解读
复制代码
npm install -g @google/gemini-cli@nightly

MCP 服务器使用

在 ~/.gemini/settings.json 中配置 MCP 服务器以扩展 Gemini CLI 的自定义工具：

perl
 体验AI代码助手
 代码解读
复制代码
> @github 列出我的开放拉取请求
> @slack 向 #dev 频道发送今天提交的摘要
> @database 运行查询查找不活跃用户

📚 相关资源

• 官方路线图：查看即将推出的功能
• NPM 包：包注册表
• GitHub Issues：报告 bug 或请求功能
• 安全建议：安全更新

卸载

如果您需要卸载 Gemini CLI，请参考官方的卸载指南。

本作品采用《CC 协议》，转载必须注明作者和本文链接