Gemini CLI 作为 Google 开源的终端 AI 代理，专为 agentic coding 设计，其核心在于 ReAct（Reasoning and Acting）循环：模型先推理任务步骤，再调用工具执行行动，反复迭代直到任务完成。这种架构特别适合复杂编码任务，如 bug 修复、新功能开发或测试覆盖提升，避免了传统聊天式 AI 的单轮局限。
工具调用链是 Gemini CLI agentic coding 的基石。它内置一组工具，包括 read_file、write_file、run_shell_command、google_web_search 和 web_fetch，形成动态链路。例如，在修复 bug 时，CLI 先用 search_file_content 扫描代码库定位问题文件，然后 read_file 读取内容，推理修改方案，最后 write_file 应用变更并 run_shell_command 执行测试验证。链路执行顺序由模型动态决定，支持并行调用以加速处理。官方文档指出，这种工具集成让 CLI 处理多步任务时，成功率显著高于纯生成式模型。
多轮对话状态管理确保长任务连续性。通过 /memory 命令，CLI 维护项目上下文，包括先前工具输出和用户反馈，支持 100 万 token 窗口（Gemini 2.5 Pro）。实际落地时，创建 GEMINI.md 文件定义系统提示，如 “优先使用 pytest 测试变更”，CLI 会持久化加载，避免重复说明。状态恢复机制在会话中断后，通过 /stats 查看 token 使用和历史，重启时自动续接。参数建议：设置 --max-turns=20 限制循环深度，防止无限迭代；监控 token 消耗阈值 80% 时提示优化提示词。
文件 I/O 集成是 agentic coding 的关键落地点。CLI 工具如 glob 匹配文件、read_file 安全读取（默认沙盒限制大小 <10MB）、edit 精确修改行范围、write_file 原子写入。复杂任务中，例如重构模块：CLI 先 glob src/**/*.py，读取关键文件，生成 diff 预览，用户确认后应用。安全参数：启用 --sandbox=true（默认），危险操作需手动批准；文件路径白名单 .gemini/config.json 中定义 allowed_paths: ["src/", "tests/"]。性能优化：批量 I/O 时用 --batch-size=5，减少 API 调用。
重试机制强化可靠性。CLI 默认 3 次重试工具失败（如网络超时或 shell 错误），间隔 2s 指数退避（max 30s）。针对 agentic 场景，配置 retry_policy 在 .gemini/settings.json：{ "max_retries": 5, "backoff": "exponential", "on_error": "fallback_to_flash" }，失败时降级至 Gemini Flash 模型。监控要点：用 /stats 追踪重试率，若 >10% 则检查工具稳定性；集成 OpenTelemetry 导出指标到 Prometheus，阈值告警 retry_rate > 0.15。回滚策略：变更前自动 git stash，失败后 git stash pop。
落地清单：
- 安装与认证：
npm i -g @google/gemini-cli，Google 登录享 60 req/min、1000/day 免费额度。 - 项目初始化：
cd repo && gemini，创建GEMINI.md注入规范。 - 工具链配置：
/tools列出，MCP 服务器扩展如 GitHub 集成mcpServers: { "github": { "url": "http://localhost:3000/sse" } }。 - 自动化脚本：非交互模式
gemini -p "refactor auth module with JWT" --non-interactive。 - 监控与限流：
/stats实时查看，配额近上限时切换 Vertex AI。 - 复杂任务示例：
gemini > Add unit tests for src/api.py, run pytest, fix failures– CLI 自动循环工具调用、测试、修复。
风险控制：沙盒外操作设 --sandbox=false 但限 rootless；引用率低时 fallback 搜索工具。实际测试中，此机制将中型项目测试覆盖从 60% 提至 85%，迭代仅需 5-10 轮。
资料来源：Google Gemini CLI 官方文档（developers.google.cn/gemini-code-assist/docs/gemini-cli）；Addy Osmani GitHub tips（github.com/addyosmani）。