Agent 模式不是普通的问答对话，而是一个会自动读取文件、修改代码、甚至执行终端命令的自主工作流。提交任务前，建议先确认当前代码已 Git 提交，方便随时回滚。
1. 进入 Agent 模式
在侧边栏 AI 面板的输入框上方，将模式从 "Chat" 切换为 "Agent"（部分版本显示为 "Composer" 或类似标识）。此时输入框会出现提示，表明 AI 将获得操作文件的权限。
2. 提交任务描述
用一句话清晰描述你的目标，越具体越好。可以结合 3.4 节 的 @ 指令提供上下文，例如：
@代码库 把项目中所有使用 var 声明的变量改成 let 或 const，并确保不影响现有功能，改完后运行 npm run lint 检查。
3. 执行流程
提交后，Agent 通常按以下步骤推进：
- 分析规划：AI 先检索项目结构，列出准备修改的文件清单和执行步骤，在对话区展示给你。
- 读取与修改：按顺序读取目标文件内容，生成修改后的代码，并自动保存到磁盘。每改完一个文件，会在对话中显示变更摘要（diff）。
- 终端操作：如果任务需要运行命令（如安装依赖、执行测试、构建检查），Agent 会暂停并弹出 "Approve"（批准） 按钮，等待你点击后才会在集成终端中执行。涉及
rm、git push、修改系统配置等敏感命令时，即使开启了自动执行，也会强制要求人工确认。 - 结果汇总：全部完成后，Agent 会汇报修改了哪些文件、执行了哪些命令、是否遇到错误。
4. 权限控制建议
- 文件写入：默认自动保存，但你可在设置中关闭 "Auto-run"，让 Agent 每改一个文件都先征求同意。
- 终端自动批准：若处于可信环境且任务高度重复（如批量格式化），可在对话下方勾选 "Auto-run approved commands"，让测试、lint 等常规命令自动执行。建议新手保持手动确认，避免误删数据。
- 随时打断：执行过程中若发现方向偏离，点击对话区的 "Cancel" 或 "Stop" 即可终止，已保存的修改可通过 Git 撤销。
实用提示
Agent 擅长处理跨文件的批量重构、依赖迁移和重复性修改，但一次只聚焦一个目标。若任务过于宽泛（如"优化整个项目"），AI 容易陷入循环或改出预期外的结果，建议拆分成多个小步骤分批提交。