Gemini CLI 安装指南

前置要求

• Gemini CLI 已安装
• 网络可访问 GitHub

安装步骤

一键安装

gemini extensions install https://github.com/obra/superpowers

验证安装

启动新会话，询问：

你有什么 superpowers？

如果 Gemini 能够列出技能并说明如何使用，说明安装成功。

配置文件位置

• 扩展配置：~/.gemini/extensions/superpowers/
• 上下文文件：~/.gemini/extensions/superpowers/GEMINI.md

更新

gemini extensions update superpowers

工具映射

Superpowers 技能使用 Claude Code 工具名称。Gemini CLI 会自动映射：

技能引用	Gemini CLI 等价
Read	read_file
Write	write_file
Edit	replace
Bash	run_shell_command
Grep	grep_search
Glob	glob
TodoWrite	write_todos
Skill	activate_skill
WebSearch	google_web_search
WebFetch	web_fetch

子代理限制

Gemini CLI 没有子代理功能（相当于 Claude Code 的 Task 工具）。依赖子代理的技能（如 subagent-driven-development、dispatching-parallel-agents）会降级为单会话执行模式，使用 executing-plans 替代。

Gemini 独有工具

Gemini CLI 有一些 Claude Code 没有的工具：

工具	用途
list_directory	列出文件和子目录
save_memory	跨会话持久化事实到 GEMINI.md
ask_user	请求用户结构化输入
tracker_create_task	丰富的任务管理
enter_plan_mode / exit_plan_mode	切换到只读研究模式

常见问题

安装后技能未生效

确保是新会话。Gemini CLI 需要重启才能加载新扩展。

扩展安装失败

检查网络连接，确保能访问 GitHub。如使用代理，配置 HTTP_PROXY 环境变量。

无法使用子代理技能

这是正常现象。Gemini CLI 不支持子代理，相关技能会自动降级为单会话执行。

卸载

gemini extensions uninstall superpowers