🚀Google AI 驱动
💎

Gemini CLI 快速开始

Google AI 命令行工具

通过命令行轻松访问 Google Gemini AI 模型，体验强大的多模态AI能力。 简单、快速、高效的AI对话工具

1
安装 Node.js
运行环境
2
安装 CLI
npm 全局安装
3
配置环境
添加 API Key
💰 立即购买API额度 🔑 获取 API Key 📚 查看安装指南

什么是 Gemini CLI？

Gemini CLI 是一个简单易用的命令行工具，让你能够直接在终端中与 Google Gemini AI 进行交互

💎

Google AI 驱动

基于 Google Gemini 模型，提供强大的多模态AI能力

⚡

简单易用

命令行界面，无需复杂配置，快速上手

🔧

多模型支持

支持 Gemini Pro、Gemini Flash 等多种模型

安装步骤

快速开始使用 Gemini CLI 命令行工具

🪟 Windows 完整安装教程

1 安装 Node.js

方法一：使用官方安装包（推荐）

  1. 访问 https://nodejs.org
  2. 下载 LTS 版本的 Windows Installer (.msi)
  3. 运行安装程序，按默认设置完成安装
  4. 安装程序会自动添加到 PATH 环境变量

方法二：使用包管理器

使用 Winget（Windows 11 或 Windows 10 自带）：

PowerShell（管理员） 
winget install OpenJS.NodeJS.LTS

使用 Chocolatey：

PowerShell（管理员） 
choco install nodejs-lts

使用 Scoop：

PowerShell 
scoop install nodejs-lts

验证安装：

CMD/PowerShell 
node --version
npm --version

提示： 建议使用 LTS（长期支持）版本以获得最佳稳定性。安装完成后需重启命令行窗口。

2 全局安装 Gemini CLI

打开命令提示符或 PowerShell，执行以下命令：

CMD/PowerShell 
npm install -g @google/gemini-cli

3 配置 Gemini CLI

重要提示：请将下方的 GEMINI_API_KEY 替换为您在 https://anthropic.edu.pl/console/token 生成的 Gemini CLI 专用 API 密钥！

3.1 创建 .gemini 文件夹

配置位置：%USERPROFILE%\.gemini\

3.2 创建 .env 文件

在 .gemini 文件夹中创建 .env 文件：

.env 
GOOGLE_GEMINI_BASE_URL=https://anthropic.edu.pl
GEMINI_API_KEY=粘贴为Gemini CLI专用分组令牌key
GEMINI_MODEL=gemini-2.5-pro
3.3 创建 settings.json 文件

在 .gemini 文件夹中创建 settings.json 文件：

settings.json 
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

注意： 配置文件更加安全且便于管理，需要重启 Gemini CLI 才生效。

4 启动 Gemini CLI

配置完成后，运行以下命令启动：

CMD/PowerShell 
gemini

开始使用 Gemini CLI！

  • • 超大上下文窗口：1M tokens
  • • Agent Mode 自动规划任务
  • • Google Search 实时联网

🍎 macOS 完整安装教程

1 安装 Node.js

使用 Homebrew 安装：

Terminal 
brew install node

2 全局安装 Gemini CLI

Terminal 
npm install -g @google/gemini-cli

3 配置 Gemini CLI

重要提示：请将下方的 GEMINI_API_KEY 替换为您在 https://anthropic.edu.pl/console/token 生成的 Gemini CLI 专用 API 密钥！

3.1 创建 .gemini 文件夹

配置位置：~/.gemini/

3.2 创建 .env 文件

在 .gemini 文件夹中创建 .env 文件：

.env 
GOOGLE_GEMINI_BASE_URL=https://anthropic.edu.pl
GEMINI_API_KEY=粘贴为Gemini CLI专用分组令牌key
GEMINI_MODEL=gemini-2.5-pro
3.3 创建 settings.json 文件

在 .gemini 文件夹中创建 settings.json 文件：

settings.json 
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

注意： 配置文件更加安全且便于管理，需要重启 Gemini CLI 才生效。

4 启动 Gemini CLI

配置完成后，运行以下命令启动：

Terminal 
gemini

开始使用 Gemini CLI！

  • • 超大上下文窗口：1M tokens
  • • Agent Mode 自动规划任务
  • • Google Search 实时联网

🐧 Linux 完整安装教程

1 安装 Node.js

Ubuntu/Debian:

Terminal 
sudo apt update && sudo apt install nodejs npm

2 全局安装 Gemini CLI

Terminal 
npm install -g @google/gemini-cli

3 配置 Gemini CLI

重要提示：请将下方的 GEMINI_API_KEY 替换为您在 https://anthropic.edu.pl/console/token 生成的 Gemini CLI 专用 API 密钥！

3.1 创建 .gemini 文件夹

配置位置：~/.gemini/

3.2 创建 .env 文件

在 .gemini 文件夹中创建 .env 文件：

.env 
GOOGLE_GEMINI_BASE_URL=https://anthropic.edu.pl
GEMINI_API_KEY=粘贴为Gemini CLI专用分组令牌key
GEMINI_MODEL=gemini-2.5-pro
3.3 创建 settings.json 文件

在 .gemini 文件夹中创建 settings.json 文件：

settings.json 
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

注意： 配置文件更加安全且便于管理，需要重启 Gemini CLI 才生效。

4 启动 Gemini CLI

配置完成后，运行以下命令启动：

Terminal 
gemini

开始使用 Gemini CLI！

  • • 超大上下文窗口：1M tokens
  • • Agent Mode 自动规划任务
  • • Google Search 实时联网

常见问题

⚠️ 提示 API Key 错误怎么办？

请确保您已正确设置环境变量 GEMINI_API_KEY，并使用 Gemini专用分组 的令牌。

💡 如何切换不同的 Gemini 模型？

在 Gemini CLI 中使用命令切换，或在代码中指定模型名称，例如 gemini-pro 或 gemini-flash。

🚀 Gemini CLI 支持哪些功能？

• 文本生成和对话
• 多模态内容理解
• 代码生成和解释
• 问题回答和总结

📚 推荐使用哪个模型？

• gemini-pro：综合能力强，适合大多数场景
• gemini-flash：速度快，适合快速响应
• gemini-2.5-pro：最新版本，性能更强

准备开始 AI 对话之旅？

立即体验 Google Gemini AI 的强大能力

🚀 获取 API Key 🎯 了解更多产品