Gemini 基本介绍

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

Gemini CLI 安装方式

快速安装 Gemini CLI

检查

系统安装要求

Node.js 版本 20 或更高

macOS、Linux 或 Windows

使用 npx 即时运行

使用 npm 全局安装

使用 Homebrew 安装（MacOS/Linux）

Gemini CLI 配置使用

1. 配置 Gemini CLI 环境变量

在使用第三方 API 之前，您需要配置以下环境变量：

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

Gemini CLI 快速开始

基本使用

在当前目录启动

包含多个目录

使用特定模型

脚本非交互模式

获取简单文本响应：

获取结构化 JSON 输出：

快速示例

启动新项目

分析现有代码

故障排除

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

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

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

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

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

使用内置命令报告问题：

MCP 服务器使用

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

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

卸载

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

Gemini CLI 配置使用 API 教程

Gemini 基本介绍#

Gemini CLI 安装方式#

快速安装 Gemini CLI#

Gemini CLI 配置使用#

1. 配置 Gemini CLI 环境变量#

Gemini CLI 快速开始#

基本使用#

在当前目录启动#

包含多个目录#

使用特定模型#

脚本非交互模式#

快速示例#

启动新项目#

分析现有代码#

故障排除#

MCP 服务器使用#

卸载#

Gemini 基本介绍

Gemini CLI 安装方式

快速安装 Gemini CLI

Gemini CLI 配置使用

1. 配置 Gemini CLI 环境变量

Gemini CLI 快速开始

基本使用

在当前目录启动

包含多个目录

使用特定模型

脚本非交互模式

快速示例

启动新项目

分析现有代码

故障排除

MCP 服务器使用

卸载