命令
| 命令 | 说明 | 示例 |
|---|
gemini | 启动交互式 REPL | gemini |
gemini -p "query" | 非交互式查询 | gemini -p "summarize README.md" |
gemini "query" | 查询并继续交互 | gemini "explain this project" |
cat file | gemini | 处理管道内容 | cat logs.txt | gemini |
gemini -i "query" | 执行后继续交互 | gemini -i "What is the purpose of this project?" |
gemini -r "latest" | 继续最近的会话 | gemini -r "latest" |
gemini -r "latest" "query" | 用新提示继续会话 | gemini -r "latest" "Check for type errors" |
gemini -r "<session-id>" "query" | 按 ID 恢复会话 | gemini -r "abc123" "Finish this PR" |
gemini update | 更新到最新版本 | gemini update |
gemini extensions | 管理扩展 | 见下文 |
gemini mcp | 配置 MCP 服务器 | 见下文 |
位置参数 query 是（可变长的）字符串，作为位置提示词；在 TTY 里默认进入交互模式，非交互执行要用 -p/--prompt。
交互命令
在交互式 REPL 里可用：/skills reload（从磁盘重新加载发现的 skills）、/agents reload（重新加载智能体注册表）、/commands list（列出可用的自定义斜杠命令）、/commands reload（重新加载自定义斜杠命令）、/memory reload（重新加载上下文文件，如 GEMINI.md）、/mcp reload（重启并重新加载 MCP 服务器）、/extensions reload（重新加载所有活动的扩展）、/help（显示所有命令的帮助）、/quit（退出交互会话）。
命令行选项
| 选项 | 别名 | 类型 | 默认 | 说明 |
|---|
--debug | -d | 布尔 | false | 以详细日志的调试模式运行 |
--version | -v | — | — | 显示 CLI 版本并退出 |
--help | -h | — | — | 显示帮助 |
--model | -m | 字符串 | auto | 使用的模型，见模型选择 |
--prompt | -p | 字符串 | — | 提示文本，如果有标准输入则追加其后；强制非交互模式 |
--prompt-interactive | -i | 字符串 | — | 执行提示后继续在交互模式 |
--worktree | -w | 字符串 | — | 在新的 git worktree 里启动；不给名字则自动生成；需要设置里 experimental.worktrees: true |
--sandbox | -s | 布尔 | false | 在沙箱环境里运行以更安全地执行 |
--skip-trust | — | 布尔 | false | 本次会话信任当前工作区，跳过文件夹信任检查 |
--approval-mode | — | 字符串 | default | 工具执行的审批模式：default、auto_edit、yolo、plan |
--yolo | -y | 布尔 | false | 已弃用，自动批准所有动作，改用 --approval-mode=yolo |
--allowed-mcp-server-names | — | 数组 | — | 允许的 MCP 服务器名（逗号分隔或多个标志） |
--allowed-tools | — | 数组 | — | 已弃用，改用策略引擎 |
--extensions | -e | 数组 | — | 要使用的扩展列表；不提供时启用所有扩展 |
--list-extensions | -l | 布尔 | — | 列出所有可用扩展并退出 |
--resume | -r | 字符串 | — | 恢复之前的会话，"latest" 为最近的，或用序号（如 --resume 5） |
--list-sessions | — | 布尔 | — | 列出当前项目的可用会话并退出 |
--delete-session | — | 字符串 | — | 按序号删除会话（先用 --list-sessions 查看） |
--include-directories | — | 数组 | — | 加入工作区的额外目录 |
--screen-reader | — | 布尔 | — | 启用屏幕阅读器模式 |
--output-format | -o | 字符串 | text | 输出格式：text、json、stream-json |
--experimental-acp | — | 布尔 | — | 以 ACP 模式启动（实验性） |
模型别名
--model（-m）可以用别名或具体模型名：
| 别名 | 解析为 | 说明 |
|---|
auto | gemini-2.5-pro 或 gemini-3-pro-preview | 默认；启用预览功能时解析为预览模型，否则解析为标准 pro 模型 |
pro | 同上 | 复杂推理任务，启用预览时用预览模型 |
flash | gemini-2.5-flash | 快速、均衡，适合多数任务 |
flash-lite | gemini-2.5-flash-lite | 最快，适合简单任务 |
模型名称随版本变化很快，请以官方「Model selection」页和 /model 选择器为准。
管理扩展
| 命令 | 说明 |
|---|
gemini extensions install <source> | 从 Git URL 或本地路径安装扩展（可加 --ref <ref> 指定分支/标签/提交，--auto-update 启用自动更新） |
gemini extensions uninstall <name> | 卸载一个或多个扩展 |
gemini extensions list | 列出所有已安装的扩展 |
gemini extensions update <name> / --all | 更新指定扩展 / 全部 |
gemini extensions enable <name> / disable <name> | 启用 / 禁用扩展 |
gemini extensions link <path> | 链接本地扩展用于开发 |
gemini extensions new <path> | 从模板创建新扩展 |
gemini extensions validate <path> | 验证扩展结构 |
管理 MCP 服务器
| 命令 | 说明 |
|---|
gemini mcp add <name> <command> | 添加基于 stdio 的 MCP 服务器，如 gemini mcp add github npx -y @modelcontextprotocol/server-github |
gemini mcp add <name> <url> --transport http | 添加基于 HTTP 的 MCP 服务器 |
gemini mcp add <name> <command> --env KEY=value | 带环境变量添加 |
gemini mcp add <name> <command> --scope user | 以用户范围添加 |
gemini mcp add <name> <command> --include-tools tool1,tool2 | 只包含指定工具 |
gemini mcp remove <name> | 移除 MCP 服务器 |
gemini mcp list | 列出所有已配置的 MCP 服务器 |
管理 skills
| 命令 | 说明 |
|---|
gemini skills list | 列出所有发现的 agent skills |
gemini skills install <source> | 从 Git、路径或文件安装 skill |
gemini skills link <path> | 通过符号链接链接本地 skills |
gemini skills uninstall <name> | 卸载 skill |
gemini skills enable <name> / disable <name> | 启用 / 禁用 skill（加 --all 对全部生效） |