Qoder Agent模式需先完成登录授权、切换Quest视图、启用Experts Mode并验证运行状态。具体包括：安装v3.2.0+插件并登录qoder.com账号；点击Quest标签进入三栏界面；在Settings中开启Experts Mode并添加/epert前缀；通过阶段标识、Changed Files Tab、qoder-cli status及.qoder文件夹确认激活。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 Qoder 插件但无法进入 Agent 模式执行复杂任务，则可能是由于未正确激活 Agent 功能或未完成环境授权。以下是开启 Qoder Agent 模式的具体操作路径与配置方法：
一、确认插件安装并完成登录授权
Agent 模式依赖用户身份认证与云端调度能力，必须在 JetBrains IDE 中完成完整登录流程，否则界面中不会显示 Quest 视图或 Agent 启动入口。
1、打开 IntelliJ IDEA（或其他 JetBrains IDE），进入 File → Settings → Plugins，搜索 Qoder 并确保已安装最新版本（v3.2.0 或更高）。
2、重启 IDE 后，在右侧工具栏点击 Qoder 图标，或使用快捷键 Ctrl+Shift+L（Windows）/ ⌘⇧L（macOS） 打开面板。
3、点击面板内 Sign In，系统将自动打开默认浏览器跳转至登录页；若页面空白或加载失败，请手动复制地址粘贴至 Chrome 或 Edge 浏览器中打开。
4、使用已在 qoder.com 官网注册的企业邮箱账号登录；注意：不可直接使用公司邮箱密码直登，必须先完成官网注册与邮箱验证。
5、登录成功后，IDE 面板右上角应显示绿色在线状态及用户名，此时基础连接已就绪。
二、切换至 Agent 模式（Quest 视图）
Qoder 1.0 版本起，Agent 模式以独立的 Quest 视图呈现，需主动切换界面模式，而非在原有聊天窗口中启用。
1、在 Qoder 面板顶部导航栏，查找并点击 Quest 标签（非 Ask 或 Chat）；若该标签不可见，请检查 IDE 右下角状态栏是否提示「Switch to Quest Mode」，点击即可强制切换。
2、首次进入时，系统将引导选择默认 Workspace；建议新建专属 Workspace 并命名，避免与日常问答模式混淆。
3、进入三栏布局界面后，左栏为任务导航区，中栏为会话流，右栏为产物区；此时即已处于 Agent 模式运行环境。
4、在中栏输入框中输入自然语言需求（例如：“为当前 Spring Boot 项目添加一个 REST API，返回用户列表”），按回车提交；系统将自动进入 Plan → Code → Verify 全链路流程，无需额外触发按钮。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、启用 Experts Mode 多 Agent 协同
标准 Agent 模式为单任务流，如需调用调研员、前后端工程师等 5 类专业角色并行工作，必须显式启用 Experts Mode，并确保账户具备对应权限。
1、在 Quest 视图右上角，点击头像旁的齿轮图标进入 Settings。
2、在 Model & Mode 设置页中，找到 Execution Mode 选项，从下拉菜单中选择 Experts Mode；若该选项灰显，请确认已绑定阿里云 Coding Plan Pro 套餐或企业组织权限。
3、返回任务输入框，输入需求前添加前缀 /expert（例如：/expert 设计一个支持文件上传与预览的 React 管理后台）；此指令将强制启动全部 5 个 AI Agent 并行编排任务。
4、提交后，左栏任务卡片状态将显示为 Running，中栏自动展开多角色分工日志，右栏 Spec Tab 实时生成需求说明书。
四、验证 Agent 模式运行状态
仅界面切换不等于功能生效，需通过实际产物输出与状态流转确认 Agent 模式真正激活。
1、观察中栏会话流顶部是否出现带图标的 Plan、Code、Verify 分阶段标题；若仅有连续文本回复而无阶段标识，则仍处于 Ask 模式。
2、检查右栏 Changed Files Tab 是否可展开并显示待 Accept 的代码变更文件列表；未出现该 Tab 或为空白，说明 Agent 尚未执行写入动作。
3、在终端中执行 qoder-cli status（需已安装 CLI），查看输出中 agent_mode: active 字段是否为 true；若为 false，请重新执行 qoder-cli login 并绑定当前 Workspace。
4、打开项目根目录，确认是否存在 .qoder/ 隐藏文件夹且内含 workspace.json 与 execution_log.db；缺失任一文件表明本地 Agent 运行引擎未初始化。
