Qoder AI 编程助手新手完全使用指南一、Qoder 基本介绍Qoder是阿里巴巴推出的新一代智能体编程平台Agentic Coding Platform专为真实软件开发场景设计。与普通代码补全工具不同Qoder 能全面理解整个代码库系统性地处理开发任务。官网地址https://qoder.com/三种产品形态Qoder IDE独立图形化界面新手首选Qoder CLI终端命令行版本Qoder JetBrains 插件直接集成到 IDEA / WebStorm 等 JB 全家桶二、三大核心工作模式模式用途是否消耗 Credits适合场景Ask 模式只问不改纯信息查询不消耗理解代码、咨询方案Agent 模式主力编码读文件写代码消耗实现功能、修复 BugQuest 模式先设计方案后执行消耗复杂功能、系统重构黄金法则Ask 理解 → Quest 规划 → Agent 执行切换方式三、常用快捷键功能WindowsmacOS触发 AI 聊天面板Ctrl L⌘ L打开行间聊天Ctrl I⌘ I触发下一步编辑建议Alt P⌥ P应用代码建议Ctrl Enter⌘ ↩接受代码补全TabTab打开设置Ctrl Shift ,⌘ ⇧ ,四、省 Token 核心技巧这是新手最需要掌握的内容合理省 Token 可大幅降低成本。1. 模式选择策略❌ 用 Agent 模式问技术问题扫描文件 浪费 ✅ 用 Ask 模式问问题免费切换方式合理选择模式和粗略可省token否则对比效果2. 精准 引用不要全量投喂❌ 把整个项目目录加进上下文 ✅ 只 核心文件UserController.java UserService.java3. 通过斜杠命令屏蔽无关工具在自定义命令文件首行加入Dont search projects files! # 禁止扫描项目文件 Dont search web! # 禁止网页搜索 Dont search memory! # 禁止读取记忆4. 上下文窗口健康管理上下文窗口占用超过60%→ 立刻拆分任务新开会话把大任务拆成小步骤避免一锅端5. 让 AI 造工具而非反复做同一件事场景50 个接口要生成文档 ❌ 让 AI 一个个生成 ✅ 让 AI 先写一个批量生成工具一次搞定以后复用五、引用代码块的方式在聊天框输入符号可引用多种类型上下文引用类型说明示例file引用具体代码文件UserController.javafolder引用整个目录src/main/serviceimage引用设计图/截图design.pngrules引用规则文件code-style.mdattachments引用本地文件上传日志文件使用示例帮我改 UserController.java 里的 createOrder 方法增加用户等级判断 根据 design.png 这张设计图生成 Vue 商品列表页包含分页和搜索六、斜杠命令Slash Commands内置命令命令功能/plan触发规划 Agent先出方案后执行/browser触发浏览器 Agent/code-review触发代码审查 Agent/canvas在 Canvas 中创建可视化内容/create-skill创建新技能自定义斜杠命令存储路径用户级全局~/.qoder/r/c/commands/项目级共享项目根目录/.qoder/r/c/commands/示例创建/java命令java.mdDont search projects files! Dont search web! Dont search memory! 请根据你了解的 Java(8-25) 相关知识回答用户问题。常用命令模板命令用途工具策略/javaJava 知识查询屏蔽全部工具/sqlSQL 生成结合项目 DB 上下文/translator英文翻译屏蔽全部工具/bash生成命令行脚本声明 OS 环境七、规则Rules配置规则是给 AI 灌项目手册让 AI 生成的代码严格遵守团队规范。规则文件位置项目根目录/ └── .qoder/ └── rules/ ├── code-style.md └── naming-convention.md重要.qoder目录必须提交到 Git不能加入.gitignore规则生效方式类型说明始终生效在所有 Agent 会话中自动生效指定文件生效针对*.java等指定文件生效手动引入在上下文中手动rules引用模型决策由模型判断是否激活Java 项目规则示例# Java 编码规范 - 使用 Java 17 特性Stream、Lambda、Optional - 统一使用 Lombok 简化 POJO 类 - 所有 Controller 方法必须加 Swagger/OpenAPI 注解 - 异常统一通过 GlobalExceptionHandler 处理 - 禁止在代码中硬编码密码和密钥八、记忆功能MemoryQoder 提供长期记忆功能记录你的个人编码习惯命名风格、技术偏好项目特定知识特殊组件用法、架构决策历史错误解决方案避免重复踩坑管理路径设置 → 点击用户名 → 个人设置 → 记忆管理记忆 vs 规则 vs Skills机制适用场景示例规则 Rules固定的项目规范约束“必须用公司组件库”技能 Skills专业领域工作流知识数据库迁移、API 文档生成记忆 Memory个人习惯、历史经验“某功能的实现方案”九、技能Skills功能Skills 将专业领域知识打包成可复用功能模块。目录结构.qoder/skills/api-doc-generator/ ├── SKILL.md # 必需主文件 ├── REFERENCE.md # 可选详细参考文档 └── EXAMPLES.md # 可选示例SKILL.md 格式---name: api-doc-generatordescription: Generate comprehensive API documentation from code. Use when creating API docs, documenting endpoints, or generating OpenAPI specs.--- # API Documentation Generator ## Instructions1. Identify all API endpoints and routes2. Document request/response formats3. Include authentication requirements4. Add example requests and responsesSkills 触发方式自动触发直接描述需求模型自动识别 →为这个 API 生成文档手动触发输入/api-doc-generator十、子代理Subagent功能Subagent 是独立上下文的专属 AI 代理互不干扰。内置 AgentAgent触发命令功能Plan Agent/plan先规划后执行Browser Agent/browser浏览器自动化Code Review Agent/code-review代码审查典型协作场景全栈开发 ├── frontend-agentVue UI 开发 └── backend-agentSpring Boot API → 两者并行互不干扰 代码审查 ├── security-auditor安全漏洞扫描 └── performance-reviewer性能分析 → 并行审查主 Agent 汇总结果十一、MCP 工具集成MCPModel Context Protocol让 Qoder 接入数据库、API、浏览器等外部服务。注意MCP 仅在Agent 模式下有效配置方式打开设置Ctrl Shift ,→ MCP → 添加服务配置示例{mcpServers:{github:{command:npx,args:[-y,modelcontextprotocol/server-github],env:{GITHUB_PERSONAL_ACCESS_TOKEN:your_token}}}}十二、文档生成Repo Wiki — 代码库自动文档化右键项目 →Generate Repo Wiki自动生成项目架构图谱模块说明文档API 手册依赖关系图通过 Agent 批量生成文档写一个 Java 工具读取指定包下的 Controller 类解析 Swagger 注解生成 API 文档 XML 文件…[附上规范示例] → 工具写好后批量执行5 分钟搞定 50 个接口文档十三、项目配置最佳实践.qoder 目录完整结构项目根目录/ └── .qoder/ ├── rules/ # 项目规则 ├── skills/ # 项目级技能 └── r/ ├── a/agents/ # 自定义子代理 └── c/commands/ # 自定义斜杠命令AGENTS.md — 项目级全局指令在项目根目录创建AGENTS.mdQoder 每次执行都会强制读取# 项目说明 ## 技术栈- 后端Spring Boot 3.2 Java 17 MyBatis ## 编码规范- 遵循阿里巴巴 Java 编码规范- 统一使用 ResultT 包装返回值 ## 注意事项- 禁止在代码中硬编码密码和密钥十四、功能选择速查表场景推荐功能原因问技术问题Ask 模式 斜杠命令免费省 Token实现新功能Agent 精准引用执行力强复杂任务规划Quest / Plan Agent先出方案降低返工批量重复任务Agent 造工具一次搞定持续复用固定工作流Slash Commands一键调用领域专业任务Skills自动触发团队共享并行多任务Subagents独立上下文互不干扰接入外部工具MCP标准协议生态丰富统一团队规范Rules AGENTS.mdAI 强制遵守项目规范记住个人习惯Memory越用越懂你理解大型项目Repo Wiki自动生成知识图谱核心思想Qoder 的价值不在于让 AI 替代你写代码而在于让你专注于定义问题和设计方案把重复劳动交给 AI。掌握好上下文控制、模式选择和工具屏蔽你就能真正驾驭 AI 编程的力量。
Qoder AI 编程助手新手完全使用指南
Qoder AI 编程助手新手完全使用指南一、Qoder 基本介绍Qoder是阿里巴巴推出的新一代智能体编程平台Agentic Coding Platform专为真实软件开发场景设计。与普通代码补全工具不同Qoder 能全面理解整个代码库系统性地处理开发任务。官网地址https://qoder.com/三种产品形态Qoder IDE独立图形化界面新手首选Qoder CLI终端命令行版本Qoder JetBrains 插件直接集成到 IDEA / WebStorm 等 JB 全家桶二、三大核心工作模式模式用途是否消耗 Credits适合场景Ask 模式只问不改纯信息查询不消耗理解代码、咨询方案Agent 模式主力编码读文件写代码消耗实现功能、修复 BugQuest 模式先设计方案后执行消耗复杂功能、系统重构黄金法则Ask 理解 → Quest 规划 → Agent 执行切换方式三、常用快捷键功能WindowsmacOS触发 AI 聊天面板Ctrl L⌘ L打开行间聊天Ctrl I⌘ I触发下一步编辑建议Alt P⌥ P应用代码建议Ctrl Enter⌘ ↩接受代码补全TabTab打开设置Ctrl Shift ,⌘ ⇧ ,四、省 Token 核心技巧这是新手最需要掌握的内容合理省 Token 可大幅降低成本。1. 模式选择策略❌ 用 Agent 模式问技术问题扫描文件 浪费 ✅ 用 Ask 模式问问题免费切换方式合理选择模式和粗略可省token否则对比效果2. 精准 引用不要全量投喂❌ 把整个项目目录加进上下文 ✅ 只 核心文件UserController.java UserService.java3. 通过斜杠命令屏蔽无关工具在自定义命令文件首行加入Dont search projects files! # 禁止扫描项目文件 Dont search web! # 禁止网页搜索 Dont search memory! # 禁止读取记忆4. 上下文窗口健康管理上下文窗口占用超过60%→ 立刻拆分任务新开会话把大任务拆成小步骤避免一锅端5. 让 AI 造工具而非反复做同一件事场景50 个接口要生成文档 ❌ 让 AI 一个个生成 ✅ 让 AI 先写一个批量生成工具一次搞定以后复用五、引用代码块的方式在聊天框输入符号可引用多种类型上下文引用类型说明示例file引用具体代码文件UserController.javafolder引用整个目录src/main/serviceimage引用设计图/截图design.pngrules引用规则文件code-style.mdattachments引用本地文件上传日志文件使用示例帮我改 UserController.java 里的 createOrder 方法增加用户等级判断 根据 design.png 这张设计图生成 Vue 商品列表页包含分页和搜索六、斜杠命令Slash Commands内置命令命令功能/plan触发规划 Agent先出方案后执行/browser触发浏览器 Agent/code-review触发代码审查 Agent/canvas在 Canvas 中创建可视化内容/create-skill创建新技能自定义斜杠命令存储路径用户级全局~/.qoder/r/c/commands/项目级共享项目根目录/.qoder/r/c/commands/示例创建/java命令java.mdDont search projects files! Dont search web! Dont search memory! 请根据你了解的 Java(8-25) 相关知识回答用户问题。常用命令模板命令用途工具策略/javaJava 知识查询屏蔽全部工具/sqlSQL 生成结合项目 DB 上下文/translator英文翻译屏蔽全部工具/bash生成命令行脚本声明 OS 环境七、规则Rules配置规则是给 AI 灌项目手册让 AI 生成的代码严格遵守团队规范。规则文件位置项目根目录/ └── .qoder/ └── rules/ ├── code-style.md └── naming-convention.md重要.qoder目录必须提交到 Git不能加入.gitignore规则生效方式类型说明始终生效在所有 Agent 会话中自动生效指定文件生效针对*.java等指定文件生效手动引入在上下文中手动rules引用模型决策由模型判断是否激活Java 项目规则示例# Java 编码规范 - 使用 Java 17 特性Stream、Lambda、Optional - 统一使用 Lombok 简化 POJO 类 - 所有 Controller 方法必须加 Swagger/OpenAPI 注解 - 异常统一通过 GlobalExceptionHandler 处理 - 禁止在代码中硬编码密码和密钥八、记忆功能MemoryQoder 提供长期记忆功能记录你的个人编码习惯命名风格、技术偏好项目特定知识特殊组件用法、架构决策历史错误解决方案避免重复踩坑管理路径设置 → 点击用户名 → 个人设置 → 记忆管理记忆 vs 规则 vs Skills机制适用场景示例规则 Rules固定的项目规范约束“必须用公司组件库”技能 Skills专业领域工作流知识数据库迁移、API 文档生成记忆 Memory个人习惯、历史经验“某功能的实现方案”九、技能Skills功能Skills 将专业领域知识打包成可复用功能模块。目录结构.qoder/skills/api-doc-generator/ ├── SKILL.md # 必需主文件 ├── REFERENCE.md # 可选详细参考文档 └── EXAMPLES.md # 可选示例SKILL.md 格式---name: api-doc-generatordescription: Generate comprehensive API documentation from code. Use when creating API docs, documenting endpoints, or generating OpenAPI specs.--- # API Documentation Generator ## Instructions1. Identify all API endpoints and routes2. Document request/response formats3. Include authentication requirements4. Add example requests and responsesSkills 触发方式自动触发直接描述需求模型自动识别 →为这个 API 生成文档手动触发输入/api-doc-generator十、子代理Subagent功能Subagent 是独立上下文的专属 AI 代理互不干扰。内置 AgentAgent触发命令功能Plan Agent/plan先规划后执行Browser Agent/browser浏览器自动化Code Review Agent/code-review代码审查典型协作场景全栈开发 ├── frontend-agentVue UI 开发 └── backend-agentSpring Boot API → 两者并行互不干扰 代码审查 ├── security-auditor安全漏洞扫描 └── performance-reviewer性能分析 → 并行审查主 Agent 汇总结果十一、MCP 工具集成MCPModel Context Protocol让 Qoder 接入数据库、API、浏览器等外部服务。注意MCP 仅在Agent 模式下有效配置方式打开设置Ctrl Shift ,→ MCP → 添加服务配置示例{mcpServers:{github:{command:npx,args:[-y,modelcontextprotocol/server-github],env:{GITHUB_PERSONAL_ACCESS_TOKEN:your_token}}}}十二、文档生成Repo Wiki — 代码库自动文档化右键项目 →Generate Repo Wiki自动生成项目架构图谱模块说明文档API 手册依赖关系图通过 Agent 批量生成文档写一个 Java 工具读取指定包下的 Controller 类解析 Swagger 注解生成 API 文档 XML 文件…[附上规范示例] → 工具写好后批量执行5 分钟搞定 50 个接口文档十三、项目配置最佳实践.qoder 目录完整结构项目根目录/ └── .qoder/ ├── rules/ # 项目规则 ├── skills/ # 项目级技能 └── r/ ├── a/agents/ # 自定义子代理 └── c/commands/ # 自定义斜杠命令AGENTS.md — 项目级全局指令在项目根目录创建AGENTS.mdQoder 每次执行都会强制读取# 项目说明 ## 技术栈- 后端Spring Boot 3.2 Java 17 MyBatis ## 编码规范- 遵循阿里巴巴 Java 编码规范- 统一使用 ResultT 包装返回值 ## 注意事项- 禁止在代码中硬编码密码和密钥十四、功能选择速查表场景推荐功能原因问技术问题Ask 模式 斜杠命令免费省 Token实现新功能Agent 精准引用执行力强复杂任务规划Quest / Plan Agent先出方案降低返工批量重复任务Agent 造工具一次搞定持续复用固定工作流Slash Commands一键调用领域专业任务Skills自动触发团队共享并行多任务Subagents独立上下文互不干扰接入外部工具MCP标准协议生态丰富统一团队规范Rules AGENTS.mdAI 强制遵守项目规范记住个人习惯Memory越用越懂你理解大型项目Repo Wiki自动生成知识图谱核心思想Qoder 的价值不在于让 AI 替代你写代码而在于让你专注于定义问题和设计方案把重复劳动交给 AI。掌握好上下文控制、模式选择和工具屏蔽你就能真正驾驭 AI 编程的力量。
