安装

官方地址：https://geminicli.com/docs/get-started/installation/

当前环境
系统：macos26
ide：vscode

google推荐npm，但npm在mac上比较危险，我们选择使用Homebrew

使用 Homebrew 安装

直接在终端（Terminal）或 VS Code 的集成终端中运行：

brew install gemini-cli

为什么选择 Homebrew 而不是 npm？

权限管理： npm install -g 经常需要 sudo，这会污染系统级目录。Homebrew 将文件存放在 /opt/homebrew（Apple Silicon）下，无需特殊权限。
卸载干净： brew uninstall 会比 npm 移除得更彻底。
自动路径配置： 安装后 gemini 命令会自动加入你的 PATH。

在 VS Code 中配置

由于你使用的是 VS Code，建议完成以下操作以获得最佳开发体验：

验证安装： 在 VS Code 终端输入
gemini --version，确保能正确显示版本号。
环境变量： 如果你在安装后发现 command not found，请确保你的 .zshrc（或 .bash_profile）中包含 Homebrew 的路径。通常安装 Homebrew 时已配置好，但可以检查一下：
Bash
```
# 对于 Apple Silicon Mac
export PATH="/opt/homebrew/bin:$PATH"
```
Shell 推荐： 文档提到推荐 Zsh（macOS 默认），这与 VS Code 的默认终端配置是契合的

初始化登录

https://geminicli.com/docs/get-started/authentication/

它支持api和google登录，我有google ai 体验版一年（学生会员），可以直接尝试google使用
启动命令行界面：

gemini

选择“使用 Google 登录”。Gemini CLI 将使用您的 Web 浏览器打开登录提示。请按照屏幕上的说明操作。您的凭据将被缓存到本地，以便下次登录时使用。

这样我们就可以直接使用啦，但还需要做一些

命令

1. 启动与执行命令 (CLI Commands)

这些命令是在你的终端（如 Zsh 或 PowerShell）中直接输入的：

命令示例	说明
`gemini`	启动交互式对话模式（REPL）。
`gemini -p "你的问题"`	非交互模式：直接输出结果并退出（常用于脚本）。
`gemini -i "你的问题"`	混合模式：执行初始 Prompt 后保持交互状态。
`cat logs.txt \| gemini`	管道模式：处理来自其他命令的输入。
`gemini -r "latest"`	继续上一次的对话会话。
`gemini update`	更新 Gemini CLI 到最新版本。

2. 核心启动选项 (CLI Options)

选项	别名	默认值	说明
`--model`	`-m`	`auto`	指定模型（如 `pro`, `flash`）。
`--sandbox`	`-s`	`false`	在 Docker 沙箱中运行（执行代码更安全）。
`--yolo`	-	`false`	YOLO 模式：模型执行所有操作（含删改文件）无需人工确认。
`--debug`	`-d`	`false`	显示详细日志，用于排查错误。
`--version`	`-v`	-	查看当前安装版本。

3. 交互模式内的斜杠命令 (Slash Commands)

在 gemini 会话中，输入 / 触发功能指令：

系统管理

/help 或 /?: 显示所有可用命令的帮助文档。
/settings: 打开图形化设置界面（调整 UI、快捷键等）。
/auth: 管理身份验证状态或切换账号。
/quit 或 /exit: 退出当前会话。

会话与记忆管理

/memory: 查看模型当前加载的所有 GEMINI.md 记忆上下文。
/memory reload: 手动强制刷新当前目录下的上下文文件。
/clear: 清除终端屏幕，但不重置会话。
/stats: 显示 Token 使用量、工具调用次数等统计信息。
/resume: 管理、保存或列出已命名的会话存档。

开发与工具

/plan: 计划模式：让模型先提供修改步骤，经你确认后再开始写代码。
/shells: 查看后台正在运行的终端任务或进程。
/tools: 列出当前模型可以调用的所有工具（如文件读写、搜索等）。
/mcp: 配置或查看 Model Context Protocol 扩展服务器。

4. 特殊前缀快捷操作

@ 文件引用：在 Prompt 中输入 @ 触发文件搜索，快速将文件内容读入上下文。
- 示例：解释一下这个函数 @src/main.js
! 终端直通：直接在 gemini 对话框里执行本地 Shell 命令。
- 示例：! ls -la (列出文件，并将结果直接反馈给 AI 观察)

💡 快捷键提示 (macOS)

Enter: 提交 Prompt。
Shift + Enter: 换行。
Ctrl + C: 终止 AI 正在生成的响应。
Alt + M: 切换 Markdown 渲染预览。

Gemini CLI 入门指南

安装