Gemini CLI 使用手册：Google 免费终端编程助手

# 方式 A：npm 全局安装（推荐）
npm install -g @anthropic-ai/gemini-cli

# 方式 B：一行脚本安装
curl -fsSL https://gemini-cli.dev/install.sh | bash

# 验证安装
gemini --version

1. 访问 Google AI Studio
2. 点击 "Create API Key"
3. 复制生成的 API Key
4. 在终端中配置：

# 方式 A：直接登录 Google 账号（推荐）
gemini auth login

# 方式 B：设置环境变量
export GEMINI_API_KEY="AIzaSy..."

# 方式 C：写入配置文件
gemini config set apiKey "AIzaSy..."

# 进入项目目录
cd my-project

# 启动 Gemini CLI
gemini

# 直接输入问题
> 帮我分析这个项目的目录结构，看看代码组织是否合理

常用命令：

• /help — 查看帮助
• /model — 切换模型（Gemini 3 / Gemini 2.5 Pro / Gemini 2.5 Flash）
• /memory — 管理记忆（查看、搜索、清除）
• /voice — 进入语音模式（v0.41.0+）
• Ctrl+C — 中断当前生成
• Ctrl+D — 退出

Gemini CLI 的百万 Token 上下文是它的杀手锏：

# 让 AI 读取整个项目并分析架构
> 请分析整个项目的代码架构，指出潜在的性能瓶颈和改进建议

# 一次性理解超长文件
> 解释 src/core/engine.ts 的完整逻辑，这个文件有 3000 行

# 跨文件追踪 Bug
> 用户报告登录后偶尔会被踢出，请检查 auth/ 和 session/ 目录下所有相关代码

普通 AI 助手可能只能看到单个文件，Gemini CLI 的百万上下文让你一次把整个项目"喂"给它。

1. 打开 VS Code 扩展商店
2. 搜索 "Gemini Code Assist"，点击安装
3. 按 Ctrl+Shift+P，输入 Gemini: Sign In
4. 登录 Google 账号
5. 现在你可以在 VS Code 中使用 Gemini 的所有功能

VS Code 中的核心操作：

• Ctrl+Shift+G — 打开 Gemini 侧边栏
• 选中代码 → 右键 → "Explain with Gemini" — 代码解释
• 选中代码 → 右键 → "Fix with Gemini" — 自动修 Bug

# 启动语音模式
gemini --voice

# 或在会话中切换
> /voice

# 然后直接说话：
"帮我写一个计算斐波那契数列的函数"
"这段代码有什么问题"
"重构这个函数，让它更易读"

Voice Mode 支持云端和本地两种后端，云端识别更准确，本地更隐私。