安装 Gemini CLI（Mac/Linux）

本指南将帮助你在 macOS 或 Linux 系统上安装和配置 Gemini CLI。

第一步：安装 Gemini CLI

根据你的需求选择合适的安装方法：

方法一：全局安装（推荐）

# 全局安装 Gemini CLI
npm install -g @google/gemini-cli
 
# 验证安装
gemini --version

方法二：使用 npx 直接运行

无需安装，直接使用：

# 每次使用时运行
npx @google/gemini-cli

方法三：Docker/Podman 沙箱部署

使用容器化方式获得更高的安全性：

# 使用 Docker
docker run -it gemini-cli
 
# 或使用本地 CLI 的沙箱模式
gemini --sandbox

Gemini CLI 是 Google 官方提供的命令行工具，支持 Gemini 3 Pro Preview 等最新模型，提供强大的推理和代码能力。

第二步：配置环境变量

方式一：使用 aihezu 一键配置（推荐）

使用 aihezu 工具快速配置，这是最简单的方法：

# 方式 1: 交互式安装（推荐，选择 gemini 选项）
npx aihezu install
 
# 方式 2: 直接指定服务
npx aihezu install gemini

执行后会提示输入 API Key 和 API URL（默认 https://cc.aihezu.dev/gemini），工具会自动在 ~/.gemini/.env 中配置好所有必需的环境变量。

企业用户可以在交互提示中输入独立域名（如 your-org.aihezu.dev），工具会自动补全为 https://your-org.aihezu.dev/gemini。Gemini 模式不修改 hosts，不需要 sudo。

方式二：手动配置

创建配置文件

# 创建 Gemini 配置目录
mkdir -p ~/.gemini
 
# 创建 .env 文件
cat > ~/.gemini/.env << EOF
GEMINI_API_KEY="你的API密钥"
GOOGLE_GEMINI_BASE_URL="https://cc.aihezu.dev/gemini"
EOF

临时设置（当前终端会话）

export GEMINI_API_KEY="你的API密钥"
export GOOGLE_GEMINI_BASE_URL="https://cc.aihezu.dev/gemini"

永久设置

对于 Zsh（macOS 默认）：

echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://cc.aihezu.dev/gemini"' >> ~/.zshrc
source ~/.zshrc

对于 Bash：

echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://cc.aihezu.dev/gemini"' >> ~/.bashrc
source ~/.bashrc

⚠️

重要：请将实际的 API 密钥替换到配置中。企业用户请填写自己的独立域名（例如 https://your-org.aihezu.dev/gemini）。

第三步：验证安装

检查环境变量

# 检查环境变量是否设置正确
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

测试 Gemini CLI

# 测试基本功能
gemini "Hello, Gemini!"
 
# 使用特定模型
gemini --model gemini-2.5-flash "写一个 Python Hello World 程序"

常用命令

# 查看帮助信息
gemini --help
 
# 指定模型
gemini --model gemini-2.5-flash "你的问题"
 
# 交互式对话
gemini
 
# 从文件读取输入
gemini < input.txt
 
# 沙箱模式（更安全）
gemini --sandbox "你的问题"

可用模型

我们支持以下 Gemini 模型：

gemini-2.5-flash: 快速响应的轻量级模型，适合日常使用
gemini-2.5-flash-lite: 更轻量的版本，速度更快、成本更低
gemini-2.5-pro: 专业版模型，支持更复杂的任务
gemini-3-pro-preview: 最新的预览版模型，提供最强大的能力

更多功能和使用方法请查看 Gemini CLI 官方文档 (opens in a new tab)。

系统要求

Node.js >= 14.0.0
macOS / Linux
稳定的网络连接

获取支持

遇到问题？我们提供专业技术支持：

💬 联系客服 - 一对一技术支持
🔍 清理缓存 - 清理本地缓存

恭喜！ 你已在 macOS/Linux 上成功安装 Gemini CLI，现在可以开始 AI 辅助开发了！