1. AI Coding Agent的核心工作循环解析AI Coding Agent的核心工作机制是一个持续的执行循环这个循环由四个关键阶段组成接收提示阶段Agent接收用户输入的提示同时加载系统提示、工具定义和对话历史。系统会生成一个包含会话元数据的初始化消息SystemMessage。评估响应阶段AI模型分析当前状态并决定下一步行动。可能产生纯文本响应也可能请求调用一个或多个工具或者两者兼有。系统会生成包含文本和工具调用请求的AssistantMessage。工具执行阶段系统执行请求的工具并收集结果。每组工具执行结果都会反馈给AI模型用于后续决策。开发者可以通过hooks在工具执行前进行拦截、修改或阻止。循环迭代阶段步骤2和3会不断重复直到AI产生不包含工具调用的纯文本响应此时循环结束。这个循环机制使得AI Coding Agent能够处理从简单查询到复杂编码任务的各种需求。例如简单查询列出当前目录文件可能只需要1-2个循环轮次复杂任务重构认证模块并更新测试可能需要数十个轮次涉及文件读取、代码编辑和测试执行2. 消息类型与处理机制在循环执行过程中系统会产生多种类型的消息流每种消息代表循环的不同阶段2.1 核心消息类型SystemMessage表示会话生命周期事件包含以下子类型init会话初始化的第一条消息compact_boundary上下文压缩后触发informational纯文本状态信息worker_shutting_down循环即将结束AssistantMessage包含AI模型的响应内容可能是纯文本回答工具调用请求或两者组合UserMessage包含工具执行结果或用户中途输入的内容。StreamEvent可选启用流式响应时产生的部分消息事件。ResultMessage标记循环结束包含最终文本结果token使用情况成本统计会话ID2.2 消息处理策略开发者可以根据应用需求选择处理哪些消息仅需最终结果只需处理ResultMessage需要进度更新处理AssistantMessage了解每个轮次的进展实时流式传输启用部分消息处理StreamEvent处理示例Pythonasync for message in query(prompt修复auth.ts中的测试失败): if isinstance(message, AssistantMessage): print(f完成轮次: {len(message.content)}内容块) if isinstance(message, ResultMessage): if message.subtype success: print(message.result)3. 工具执行与权限控制3.1 内置工具分类AI Coding Agent提供多类内置工具文件操作Read/Edit/Write - 文件读写修改搜索工具Glob/Grep - 文件模式匹配和内容搜索执行工具Bash - 执行shell命令和脚本Web工具WebSearch/WebFetch - 网络搜索和页面获取发现工具ToolSearch - 动态查找和加载工具编排工具Agent/Skill - 创建子代理和调用技能3.2 权限控制机制系统提供多层次的工具权限控制允许工具列表(allowed_tools)自动批准列出的工具禁止工具列表(disallowed_tools)无条件阻止指定工具权限模式(permission_mode)控制未被前两者覆盖的工具default需要显式批准acceptEdits自动批准文件编辑plan仅规划不执行dontAsk拒绝所有未明确允许的bypassPermissions仅限隔离环境使用权限检查顺序禁止列表 允许列表 权限模式3.3 工具执行方式并行执行只读工具(Read/Glob等)可以并发执行顺序执行修改状态的工具(Edit/Write等)必须顺序执行自定义工具默认顺序执行可通过readOnlyHint启用并行4. 循环控制与优化策略4.1 循环控制参数轮次限制(max_turns)限制工具使用轮次数量预算限制(max_budget_usd)设置最大成本阈值努力级别(effort)控制AI推理深度low快速响应简单查询medium常规任务处理high深度代码分析xhigh复杂编码任务max最深度分析4.2 上下文管理上下文窗口包含系统提示、工具定义、对话历史等自动压缩当接近上下文限制时自动总结旧消息优化策略使用子代理分解大任务限制加载的工具数量对简单任务使用低effort级别在CLAUDE.md中添加总结指令示例CLAUDE.md总结指令# 总结指令 总结对话时请保留 - 当前任务目标和验收标准 - 已读/修改的文件路径 - 测试结果和错误信息 - 关键决策及其理由5. 会话管理与错误处理5.1 会话连续性会话ID可从ResultMessage.session_id获取恢复会话使用会话ID恢复之前的对话上下文会话分叉创建分支尝试不同方法5.2 结果处理ResultMessage的subtype字段指示循环结束原因success任务正常完成error_max_turns达到轮次限制error_max_budget_usd达到成本限制error_during_execution执行期间出错处理示例if message.subtype success: print(f结果: {message.result}) elif message.subtype error_max_turns: print(f达到轮次限制可恢复会话 {message.session_id})6. 高级控制与Hooks机制6.1 常用HooksPreToolUse工具执行前触发可验证/修改/阻止PostToolUse工具执行后触发用于审计记录UserPromptSubmit提示提交时注入额外上下文Stop代理完成时进行最终验证SubagentStart/Stop跟踪子代理执行6.2 完整示例结合所有概念的完整代理示例async def run_agent(): try: async for message in query( prompt查找并修复auth模块的测试失败问题, optionsClaudeAgentOptions( allowed_tools[Read, Edit, Bash, Glob, Grep], setting_sources[project], max_turns30, efforthigh, hooks{ PreToolUse: validate_tool, PostToolUse: log_execution } ), ): if isinstance(message, ResultMessage): if message.subtype success: print(f修复结果: {message.result}) print(f总成本: ${message.total_cost_usd:.4f}) except Exception as error: print(f会话错误: {error}) def validate_tool(tool_call): if rm -rf in tool_call.command: raise ValueError(危险命令被阻止)7. 性能优化与最佳实践工具选择仅加载必要的工具定义会话设计简短会话适合简单任务长会话压缩适合复杂任务成本控制设置预算限制简单任务使用低effort监控token使用错误处理捕获并处理ResultMessage子类型实现适当的重试机制安全实践生产环境避免使用bypassPermissions实现PreToolUse验证限制危险工具的使用