qoder ai需启用agent模式并配置五大关键步骤：一、切换至agent并明确指令结构；二、设checkpoints分阶段确认；三、启用experts mode多角色协作；四、注入项目架构规则；五、绑定mcp本地验证工具自动质检。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望 Qoder AI 自动编写代码，但发现生成结果偏离预期、执行卡顿或无法完成端到端任务，则可能是由于未正确启用或配置 Agent 模式。以下是高效使用 Qoder Agent 模式的具体操作路径：
一、启用 Agent 模式并选择合适任务粒度
Agent 模式需明确区分轻量级交互与重型任务委托，避免将模糊指令直接提交给全栈 Agent，导致规划失焦或上下文溢出。系统默认在 Ask 模式下运行，必须主动切换至 Agent 才能触发自主决策链。
1、在 Qoder IDE 右侧边栏点击 Qoder 图标，打开聊天面板。
2、点击面板顶部的 “Switch to Agent” 按钮（非 Ask 模式）。
3、输入自然语言指令时，必须包含明确的 目标动词+作用对象+约束条件，例如：“为 user-service 模块新增 JWT 鉴权拦截器，兼容 Spring Security 6.3，不修改现有 FilterChain。”
二、设置检查点（Checkpoints）控制执行节奏
Agent 模式支持分阶段确认，防止一次性生成大量不可逆变更。每个 Checkpoint 对应一个可验证的中间产物，如 Spec 文档、API 草案或测试用例骨架，开发者可在任一节点介入修正方向。
1、在 Agent 输入框中添加指令后，追加关键词 “请在生成接口定义后暂停，等待我确认”。
2、Agent 将自动拆解任务，在输出 Spec Tab 中呈现 OpenAPI v3 格式草案，并将状态置为 “Action Required”。
3、点击右栏 “Accept & Continue” 或手动编辑 Spec 后再继续，确保后续代码严格遵循已确认契约。
三、调用 Experts Mode 启动多 Agent 并行协作
单 Agent 处理全栈任务易出现角色混淆与上下文衰减，Experts Mode 通过预设专业角色分工，使前后端逻辑、测试覆盖与代码审查同步推进，显著提升交付一致性与 Token 利用效率。
1、在 Agent 模式下输入指令开头加入 “启用 Experts Mode：调研员、后端工程师、前端工程师、测试工程师、代码评审员”。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、确认左栏任务卡片显示 “Experts Mode: Active” 及五个角色图标点亮。
3、观察中栏会话流中各 Agent 的独立输出区块，例如后端工程师仅输出 Controller/Service 层代码，前端工程师仅生成 React 组件与 API 调用封装，彼此隔离不交叉干扰。
四、注入项目规则与架构约束
Agent 默认不具备团队私有规范认知，若未显式注入分层约束、命名惯例或禁止 import 规则，将按通用最佳实践生成代码，大概率违反本地 linter 或架构评审要求。
1、在项目根目录创建 .qoder/rules/architecture.md，写入：
“所有 domain 层类不得依赖 infra 层；config 包仅允许被 application 层 import；DTO 必须以 Request/Response 结尾”。
2、在 Agent 指令中引用该规则：“请严格遵循 .qoder/rules/architecture.md 中的分层约束生成代码”。
3、Agent 将自动加载该文件内容至上下文，并在 Plan 阶段校验每一步修改是否触犯任一规则，违规操作将被标记为 “Blocked by Rule #2” 并停止执行。
五、绑定本地验证工具实现自动质检
Agent 生成代码后若未经自动化验证即提交，可能引入隐性缺陷。通过 MCP 协议连接本地 linter、单元测试框架与启动脚本，可让 Agent 在交付前自主触发校验流程，失败则回滚至上一 Checkpoint。
1、在项目中配置 .qoder/mcp.yaml，声明：
tools:
- name: "mvn-test"
command: "mvn test -Dtest=UserServiceTest"
- name: "eslint-check"
command: "npx eslint src/frontend/"
2、在 Agent 指令末尾添加：“生成完成后，依次运行 mvn-test 和 eslint-check，仅当全部通过才标记为 Ready”。
3、Agent 将在 Changed Files Tab 底部显示 “Verifying via MCP tools…”，并在 Preview Tab 实时渲染测试日志与 ESLint 报错详情。
