🧰 什么是 Gemini CLI

Gemini CLI 是 Google 推出的开源命令行 AI 助手，内置 Gemini 2.5 Pro 模型，支持 100 万 Token 的上下文窗口，免费配额为 60 次请求/分钟、1000 次请求/天 。它可以通过自然语言完成：

• 编写、解释、重构代码
• 修复 Bug、生成测试
• 执行 shell 命令
• 读取/修改文件
• 网络检索、内容生成等多种任务

---

🚀 安装与启动

前提条件

确保系统安装了 Node.js ≥ 18（推荐 v22）。可以通过 NVM 安装：

curl -o‑ https://.../install.sh | bash
. "$HOME/.nvm/nvm.sh"
nvm install 22

验证：

node -v   # v22.x
npm -v
```

### 安装方式

- **使用 npm 安装**  
  ```bash
  npm install -g @google/gemini-cli
  gemini

• 或用 npx 即装即用

  npx https://github.com/google-gemini/gemini-cli
  

• macOS 可用 Homebrew 安装

  brew install gemini-cli
  gemini
  

登录认证

启动后需登录 Google 账号以获取免费许可（Gemini 2.5 Pro），也支持使用 AI Studio 或 Vertex AI 的 API Key：

export GEMINI_API_KEY="YOUR_API_KEY"

---

🛠 基本用法

进入项目目录后运行 gemini，你将看到一个交互式提示：

• 执行 /tools 查看可用的工具，如 edit, read_file, run_shell_command, google_web_search 等 :contentReference[oaicite:15]{index=15}
• 输入 JavaScript、Python 等问题或任务指令，例如：

> 解释一下 index.js 文件在做什么
> 给 index.js 添加错误处理

Gemini CLI 会读文件、分析上下文，给出详细解释甚至代码修复

示例：创建 To‑Do Web 应用

你可以让 Gemini CLI 帮你生成完整项目骨架：

> 创建一个使用 HTML+CSS+JS 的简单待办事项应用

CLI 将自动生成文件结构、基础代码，若有 bug，还能继续修复、增加测试

---

📁 进阶技巧

1. 加载现有项目

git clone <repo>
cd repo
gemini

提示类似：

> 总结一下今天对代码库所做修改

它会快速扫描改动并生成总结 ([DataCamp][3], [Medium][2])

2. 调用 Shell 和测试

Gemini 可执行 shell 命令，例如运行构建、测试脚本：

> 运行 cargo test

默认有沙盒保护，若要完全访问，可用 --sandbox=false 关闭沙盒

3. 利用工具链

工具包括：

• glob, read_file, search_file_content, write_file：用于文件操作
• run_shell_command：执行命令
• google_web_search, web_fetch：联网查资料
• save_memory：记忆项目上下文

执行时 Gemini 会提示询问确认，保护系统安全。

---

🌟 多代理与扩展

Gemini CLI 支持 MCP（Model Context Protocol），你可通过配置连接如 GitHub、Figma、数据库等外部代理 ([Medium][5])。例如配置 Figma MCP 后，可以请求获取设计文件并转化为代码。

配置示例（.gemini/settings.json）：

{
  "mcpServers": {
    "figma-developer": {
      "type": "sse",
      "url": "http://localhost:3001/sse"
    }
  }
}

启动后输入 /mcp 可列出已连接 MCP 服务。

---

✅ 总结

优点	说明
即装即用	支持 npm、npx、Homebrew 安装
强大的模型	Gemini 2.5 Pro + 1M Token + 免费配额
深入本地项目	能读写文件、执行命令
可扩展	支持多代理、工具链集成
隐私友好	沙盒 + 本地执行减小风险

Gemini CLI 是一个划时代的终端 AI 工具，适合写代码、修 Bug、生成测试甚至多媒体创作。无论是个人开发者还是团队协作，都能通过它大幅提升效率。