Gemini CLI 速查表

快速开始

``bash # 安装 npm install -g @google/gemini-cli

# 或直接运行（无需安装） npx @google/gemini-cli

# 启动交互式会话 gemini

# 非交互模式 gemini -p "日本的 capital 是什么？"

# 指定模型 gemini -m gemini-2.5-flash -p "写一个 Python 脚本"

# 管道输入 cat README.md | gemini `

安装方式

添加到 ~/.bashrc 或 ~/.zshrc： `bash export GEMINI_API_KEY="你的密钥" # 或 Vertex AI： export GOOGLE_CLOUD_PROJECT="你的项目ID" export GOOGLE_CLOUD_LOCATION="us-central1" `

也可以在 ~/.gemini/.env（全局）或 ./.gemini/.env（项目）中创建 .env 文件。

命令行参数

1. 命令行参数 2. 环境变量（包括 .env 文件） 3. 系统设置文件 — /etc/gemini-cli/settings.json 4. 项目设置文件 — .gemini/settings.json 5. 用户设置文件 — ~/.gemini/settings.json 6. 系统默认文件 — /etc/gemini-cli/system-defaults.json

### 常用设置

`json { "theme": "GitHub", "vimMode": true, "autoAccept": false, "sandbox": "docker", "checkpointing": { "enabled": true }, "general": { "preferredEditor": "vscode", "defaultApprovalMode": "default", "plan": { "enabled": true } } } `

### 上下文文件（GEMINI.md）

GEMINI.md 文件按层级加载，越具体的文件优先级越高： 1. 全局：~/.gemini/GEMINI.md 2. 项目：<项目>/.gemini/GEMINI.md 3. 子目录：自动扫描组件级指令

使用 /init 生成初始文件，@file.md 语法实现模块化导入。 使用 /memory show 查看组合后的完整上下文。

### 忽略文件（.geminiignore）

在项目根目录创建（语法类似 .gitignore）： `gitignore # .geminiignore /backups/ *.log secret-config.json `

斜杠命令速查

### 会话与聊天

### 最小化 .gemini/settings.json

`json { "theme": "GitHub Dark", "vimMode": false, "autoAccept": true, "general": { "preferredEditor": "cursor" }, "checkpointing": { "enabled": true } } `

### MCP 服务器配置

`json { "mcpServers": { "my-tools": { "command": "node", "args": ["path/to/mcp-server.js"], "env": { "API_KEY": "$MY_API_TOKEN" } } } } `

内置工具

Gemini CLI 包含以下内置能力：

- 多目录项目：使用 --include-directories 参数或 CLI 中的 /directory add 命令。 - 节省 Token：对话过长时运行 /compress 压缩上下文。 - 子代理：在 ~/.gemini/agents/ 中创建子目录，配置专用子代理。 - 风险操作前检查点：启用 checkpointing，用 /resume save 操作前 保存状态。 - 危险命令沙箱：使用 --sandbox 参数在 Docker/Podman 中隔离工具执行。 - 自定义命令：在 ~/.gemini/commands/ 中创建 .toml 文件，定义可复用的斜杠命令。 - JSON 脚本化：使用 --output-format json` 以编程方式解析 Gemini CLI 输出。