gemini cli 使用指南

引言

作为Google推出的新一代AI命令行工具，Gemini CLI凭借其100万Token上下文处理能力、多模态生成支持和免费每日1000次调用额度，成为开发者手中的利器。本文将为您呈现从安装部署到实战使用的全流程指南，覆盖Windows/macOS/Linux三大系统。

一、系统准备与环境要求

1.1 基础依赖

• Node.js 18+（下载地址）

  # 验证安装
  node -v  # 需显示v18.x.x+
  

• kx上网工具（推荐美国节点全局模式）

1.2 代理配置技巧

系统	临时配置命令	永久配置方法
Windows	set HTTPS_PROXY=http://127.0.0.1:端口	系统属性 → 环境变量 → 新建用户变量
macOS	export HTTPS_PROXY=http://127.0.0.1:端口	~/.zshrc或~/.bashrc追加配置
Linux	同macOS	同macOS

二、分步安装教程

2.1 全局安装命令

npm install -g @google/gemini-cli
# 验证安装
gemini --version

2.2 系统专属方案

Windows特别注意事项

1. 使用CMD/PowerShell（管理员权限）
2. 首次启动需设置代理：

   $env:HTTPS_PROXY="http://127.0.0.1:端口" #端口查看你的代理工具
   

macOS优化配置

1. 推荐使用Warp终端（支持AI辅助）
2. 安装后建议：

   echo 'export PATH="$PATH:/usr/local/bin/gemini"' >> ~/.zshrc
   

Linux深度配置

# Debian/Ubuntu示例
sudo apt-get install -y build-essential  # 确保编译环境

三、认证流程详解

3.1 首次启动流程

gemini
# 选择认证方式：
# 1. Google账号认证（推荐）
# 2. API Key认证（需访问https://aistudio.google.com/申请）

3.2 企业账号特别处理

当遇到GOOGLE_CLOUD_PROJECT缺失错误时：

1. 访问Google Cloud Console
2. 创建新项目 → 启用Gemini API
3. 设置环境变量：

   # 临时生效
   export GOOGLE_CLOUD_PROJECT="your-project-id"
   # 永久生效（Linux/macOS）
   echo 'export GOOGLE_CLOUD_PROJECT="your-project-id"' >> ~/.zshrc
   #“winds 使用命令：
   set GOOGLE_CLOUD_PROJECT="your-project-id"”
   

4. 访问 https://console.cloud.google.com/apis/librar
   搜索框输入 gemini 将下面三个服务都启用
   

四、核心功能实战

4.1 交互模式基础操作

gemini
# 常用指令：
# -h 查看帮助
# -d 开启调试模式
# exit 退出交互

4.2 典型应用场景

场景1：代码生成与优化

gemini "为React组件生成TypeScript类型定义"
# 高级用法：结合上下文
gemini --context "之前生成的代码需要添加错误边界处理"

场景2：多模态开发

gemini "根据design.figma文件生成React组件"
# 需配置MCP服务器（参考官方文档）

场景3：自动化运维

gemini "生成迁移旧版Django项目到Python3.12的计划"
# 支持Git操作：
gemini "将本次修改拆分为3个独立commit"

五、常见问题解决方案

5.1 认证卡死处理

# 调试模式定位问题
gemini -d
# 典型错误：ETIMEDOUT
# 解决方案：
# 1. 检查代理配置
# 2. 尝试更换VPN节点
# 3. 清除缓存：rm -rf ~/.gemini

5.2 调用限制突破

免费版限制：

• 每分钟60次调用
• 每日1000次上限

升级方案：

1. 申请Google Cloud付费计划
2. 设置API Key：

   export GEMINI_API_KEY="your_api_key"
   

六、进阶配置指南

6.1 持久化配置

# 创建配置文件
mkdir -p ~/.gemini && touch ~/.gemini/settings.json
# 示例配置：
{
  "selectedAuthType": "oauth-personal",
  "theme": "Dracula",
  "mcpServers": {
    "CustomServer": {
      "command": "node",
      "args": ["/path/to/mcp-server.js"]
    }
  }
}

6.2 集成开发环境

• VS Code：安装Gemini CLI插件
• JetBrains系列：通过Terminal插件直接调用

结语

通过本文的系统化指南，您已掌握：
✅ 三大系统差异化部署方案
✅ 完整认证流程与故障排除
✅ 核心功能实战技巧
✅ 性能优化与扩展配置

立即启动您的Gemini CLI之旅，让AI成为命令行中的得力助手！遇到具体问题可参考官方文档或留言交流。