Google Developers Blog介绍Gemini CLI新增Hooks（钩子）机制，可在不改动CLI源码的情况下，于代理循环的预设节点同步运行脚本，实现注入项目上下文、拦截高风险操作、记录与优化工具调用等定制能力。示例场景包括在写入或替换文件前扫描疑似API Key、密码等敏感信息并阻止操作。
Hooks触发时CLI会等待脚本返回结构化JSON决策；配置可写入项目级.gemini/settings.json或用户级~/.gemini/settings.json，并可通过/hooks查看与开关。该能力在Gemini CLI v0.26.0及以上默认启用，且扩展支持将Hooks随扩展打包，降低安装与配置门槛。需要注意的是，Hooks以当前用户权限执行，打开不可信项目时应谨慎启用项目级Hooks并留意变更提示。
常见问题
Q：Gemini CLI的Hooks钩子机制是什么？
A：Hooks是在代理循环特定节点执行的脚本，用于改变或约束CLI行为而无需改源码。
Q：Gemini CLI的Hooks如何配置与生效？
A：可在.gemini/settings.json或~/.gemini/settings.json配置，触发事件时同步执行并返回JSON决策。
Q：Gemini CLI的Hooks有哪些常见风险？
A：Hooks以用户权限运行，不可信项目的项目级Hooks可能带来安全与合规风险。
