Appearance
本页是 Gemini CLI 的 5 分钟入门教程。先装好 Node.js，一行命令安装 Gemini CLI，登录 Google 账号，然后在终端里开始第一次对话。核心功能：分析代码、执行 Shell、Google 搜索接地气，全部内置。
Gemini CLI 快速开始
1. 安装
确保已安装 Node.js 20+，然后：
bash
# 无需安装，立即体验
npx @google/gemini-cli
# 或全局安装（推荐）
npm install -g @google/gemini-cli更多安装方式见安装指南。
2. 启动和认证
bash
gemini首次运行会引导你选择认证方式：
- Sign in with Google — 用个人 Google 账号，免费每天 1000 次请求（推荐）
- Use Gemini API Key — 已有 API Key 时使用
认证详情见认证配置。
3. 第一次对话
启动后进入交互式 REPL：
> 你好，帮我解释一下这个目录里有什么Gemini CLI 会自动读取当前目录的文件结构和关键文件，给出项目概览。
4. 核心使用场景
分析代码
bash
# 解释整个项目
gemini "解释这个项目的架构"
# 查找 Bug
gemini "帮我在 src/ 目录里找潜在的内存泄漏"
# 代码审查
cat src/api.ts | gemini "审查这段代码的安全性"执行任务
> 帮我把 src/ 下所有 .js 文件的 console.log 找出来并列个清单Gemini CLI 会列出计划，需要你确认后执行 Shell 命令。
非交互模式（脚本自动化）
bash
# -p 参数：执行后退出
gemini -p "总结 README.md 的内容"
# 管道输入
cat error.log | gemini "分析这些错误，找出根本原因"
# 继续上次会话
gemini -r "latest" "继续刚才的任务"5. 常用交互命令
在 REPL 中可用的斜杠命令：
| 命令 | 功能 |
|---|---|
/help | 显示帮助 |
/settings | 打开设置面板 |
/memory reload | 重新加载 GEMINI.md 上下文 |
/mcp reload | 重启 MCP 服务器 |
/clear | 清空当前对话 |
下一步
- CLI 命令速查表 — 所有参数一览
- 认证配置 — 企业账号和 API Key 配置
- GEMINI.md 上下文文件 — 为项目配置 AI 上下文
常见问题
Q: 启动后卡住不动
A: 通常是网络问题。Gemini CLI 需要访问 Google 服务，国内需要代理。检查终端是否设置了 HTTP_PROXY / HTTPS_PROXY 环境变量。
Q: 提示 "quota exceeded"
A: 免费额度（60次/分钟，1000次/天）已用尽。稍等片刻重试，或升级到 Google AI Pro 套餐。
Q: 怎么退出 REPL？
A: 输入 /exit 或按 Ctrl+C 两次，或 Ctrl+D。