Qoder本地模型配置后必须完成模型绑定与上下文激活，否则AI无法读取项目结构、识别语言特征，导致生成代码脱离工程约束。需在Settings→Model Provider中启用Local Model并确认状态为Active；切换至Agent模式，输入含明确动词+对象+技术约束的指令；支持快捷键单文件编辑、AI Chat分步生成或CLI命令行初始化三种代码生成方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder本地模型配置完成后，必须先完成模型绑定与上下文激活，否则AI无法读取项目结构、识别语言特征，所有生成代码将脱离实际工程约束，出现路径错误、依赖缺失或语法不兼容问题。
确认本地模型已就绪并启用
打开Qoder IDE → 点击右上角用户头像 → 进入「Settings」→ 左侧选择「Model Provider」→ 在下拉菜单中找到「Local Model」选项 → 确保状态显示为 【Active】 且右侧有绿色对勾图标。若仍显示「Not connected」，说明模型服务未启动，需先运行本地推理服务进程。
这一步不能跳过：Qoder不会自动轮询本地端口，必须手动触发连接验证。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
切换至Agent模式并指定任务粒度
在右侧AI Chat面板中，点击顶部「Switch to Agent」按钮，将当前会话从Ask模式切换为Agent模式。
输入自然语言指令时，必须包含明确动词+作用对象+技术约束，例如：“在src/pages/Home.tsx中新增一个响应式轮播组件，使用React 18 hooks + framer-motion v11，适配移动端触摸滑动”。模糊表述如“写个轮播图”会导致Agent调用云端通用模型而非本地模型，失去上下文感知能力。
启动代码生成流程
方法一：直接触发单文件编辑
将光标置于目标文件（如Home.tsx）的待插入位置 → 按快捷键 Ctrl+Shift+I（Windows）或 Cmd+Shift+I（macOS）→ 输入需求描述 → 回车执行。
方法二：跨文件全流程生成（推荐用于新功能开发）
① 在AI Chat中输入完整需求，并追加关键词“请分步执行，每步生成后暂停确认”；
② Agent自动拆解为：生成类型定义 → 创建组件文件 → 注入样式 → 添加测试桩 → 更新路由配置；
③ 每个步骤完成后，右侧会出现「Accept & Continue」按钮，点击前务必检查文件路径是否落入当前workspace根目录下，【否则写入将发生在临时沙箱而非真实项目】；
④ 全部接受后，Qoder自动执行npm run format并校验TSX语法。
方法三：命令行快速初始化（适用于CLI用户）
终端进入项目根目录 → 执行 qoder agent --task "add login form with zod validation" → 等待本地模型加载完毕（首次约8–12秒）→ 自动生成src/features/auth/LoginForm.tsx及相关hook与schema。
