用途：在 Claude Code 工作流中调用 Google 官方 Gemini CLI（gemini 命令），获取第二意见、架构建议、调试帮助与代码审查，借助其 100 万以上上下文窗口分析代码库。
安装与验证：bun add -g @google/gemini-cli；运行 gemini 并按提示完成 Google 账号认证；用 gemini --version 验证（0.13.0+），用 gemini -p "What is 2+2?" 测试连接。
主要命令模式：非交互用 -p，例如 gemini -p "Should I use D1 or KV for session storage?"；通过管道传入文件内容，如 cat src/auth.ts | gemini -p "Review this authentication code for security vulnerabilities"；指定模型 gemini -m gemini-2.5-pro -p "..."；分析目录内所有文件 gemini --all-files -p "..."；交互追问用 gemini -i "..."。自动化脚本中必须使用 -p，否则会挂起等待输入。
模型选择：gemini-2.5-flash 较快（约 5-25 秒）、适合代码审查与调试；gemini-2.5-pro 较慢（约 15-30 秒）但分析更深入，适合架构决策、安全审计与大型重构。资料指出两者对同一问题可能给出相反建议：Flash 偏重性能，Pro 偏重一致性与正确性。
典型场景：安全审计（管道传入认证中间件代码并检查 token 校验、时序攻击、错误泄露、CSRF、限流）、架构决策（如 Cloudflare Workers 中 D1 与 KV 的取舍）、根因调试（将错误日志管道传入分析）。资料建议在重大架构决策、安全敏感改动、调试失败两次以上、五个以上文件的重构、上下文占用达 70% 以上时主动咨询 Gemini，并综合双方观点而非直接转发。
常见错误：未认证时先运行 gemini 完成认证；模型不存在时只用 gemini-2.5-flash 或 gemini-2.5-pro；命令挂起时检查是否漏加 -p。
限制：以上为资料所载内容，未提供的功能、收费、价格、平台与效果暂未提供。参考文件包括 references/models-guide.md、references/prompting-strategies.md、references/gemini-experiments.md；资料称 helper-functions.md 已过时。项目为 MIT 许可，官方仓库见 https://github.com/google-gemini/gemini-cli。