Gemini CLI 配置使用教程

基本介绍

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

📦 安装方式

快速安装

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

使用 npm 全局安装

使用 Homebrew 安装（macOS/Linux）

系统要求

Node.js 版本 20 或更高

macOS、Linux 或 Windows

配置中转站（代理）使用

方式一：使用配置文件（推荐）

步骤 1：创建配置目录

Gemini CLI 的全局配置文件位于用户主目录下的 .gemini 文件夹中,请确保该目录存在，如果不存在请手动创建。

Windows: C:\Users\用户名文件夹\ .gemini

macOS / Linux: ~/.gemini

步骤 2：在 `.gemini` 目录下创建 `.env` 文件，添加以下内容：

参数说明：

GOOGLE_GEMINI_BASE_URL: NexusAPI 的URL API 地址

GEMINI_API_KEY: 您在 NexusAPI 控制台创建的API令牌

GEMINI_MODEL: 使用的模型

步骤 3：在 `.gemini` 目录下创建 `settings.json` 文件，内容如下：

方式二：设置环境变量

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

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

Windows (PowerShell):

快速开始

基本使用

在当前目录启动

包含多个目录

使用特定模型

脚本非交互模式

获取简单文本响应：

获取结构化 JSON 输出：

快速示例

启动新项目

分析现有代码

主要功能

代码理解与生成

查询和编辑大型代码库

使用多模态能力从 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 获取调试、解释或任务委派的帮助

自定义工作流：构建适合您团队需求的自动化、定时和按需工作流

故障排除

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

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

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

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

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

使用内置命令报告问题：

Gemini CLI 配置使用教程

基本介绍#

📦 安装方式#

快速安装#

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

使用 npm 全局安装#

使用 Homebrew 安装（macOS/Linux）#

系统要求#

配置中转站（代理）使用#

方式一：使用配置文件（推荐）#

步骤 1：创建配置目录#

步骤 2：在 .gemini 目录下创建 .env 文件，添加以下内容：#

步骤 3：在 .gemini 目录下创建 settings.json 文件，内容如下：#

方式二： 设置环境变量#

快速开始#

基本使用#

在当前目录启动#

包含多个目录#

使用特定模型#

脚本非交互模式#

快速示例#

启动新项目#

分析现有代码#

主要功能#

代码理解与生成#

自动化与集成#

高级功能#

常用命令和功能示例#

探索代码库#

处理现有代码#

自动化工作流程#

系统交互#

GitHub 集成#

故障排除#