Gemini CLI 中转站配置使用教程

Gemini CLI 中文使用指南。本文介绍 Gemini CLI 的基本能力、安装方式、High Chat 中转站配置、常用命令与故障排除。

基本介绍

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 密钥 export GEMINI_API_KEY=sk-xxxxx # 设置 API 中转站地址 export GOOGLE_GEMINI_BASE_URL=https://www.high-chat.top # cmd 使用下面这个 set GEMINI_API_KEY=sk-xxxxx set GOOGLE_GEMINI_BASE_URL=https://www.high-chat.top

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

快速开始

基本使用

在当前目录启动

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 > 给我一个昨天所有更改的摘要

主要功能

代码理解与生成

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

自动化与集成

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

高级功能

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

常用命令和功能示例

探索代码库

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

处理现有代码

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

自动化工作流程

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

系统交互

> 将此目录中的所有图像转换为 png，并使用 exif 数据中的日期重命名它们 > 按支出月份整理我的 PDF 发票

GitHub 集成

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

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

故障排除

检查环境变量是否正确设置：
echo $GEMINI_API_KEY echo $GOOGLE_GEMINI_BASE_URL
检查网络连接是否稳定，中转站是否可访问：
curl -I https://www.high-chat.top
查看是否有错误信息输出，这些信息通常会指示问题所在。
如果使用 SOCKS 代理，确保代理格式正确，例如 socks5://<user>:<pass>@<proxy>:<port>。
使用内置命令报告问题：
# 在 CLI 中直接报告 bug /bug

API令牌设置和聊天界面请访问：https://www.high-chat.top。