Qoder 快速上手指南：从安装到 Agent 模式完成任务

Qoder 是一个面向真实工作的智能体平台，它把 AI 能力带进软件开发、终端工作流、托管云端执行、日常生产力任务以及长期运行的数字化角色中。它并不停留在给出一条建议或一段聊天回复，而是围绕一个端到端的循环来设计：理解任务及其上下文、规划工作、调用工具执行、验证结果，并朝着目标反复迭代。如果你希望把「描述目标、让智能体自己拆解并落地」这套流程用起来，可以从 Qoder 入手，先选一个符合自己目标的产品形态，再完成第一次有用的任务。

需要说明的是，Qoder 不是单一产品，而是一个产品家族。不同形态的能力边界不一样，具体体验取决于你使用的是哪一个产品。本教程以 JetBrains 插件为主线，因为它的前置条件最少、最容易在现有工程里验证效果；同时也会说明其他形态各自适合什么场景，方便你判断该从哪里开始。

准备工作

先确定你要用哪一种形态

在动手安装之前，先对照自己的目标选形态，可以少走弯路：

Qoder IDE：使用编辑器进行 AI 辅助编码、规划以及多文件修改。适合希望在一个完整编辑器里完成日常开发的人。
JetBrains 插件：把代码建议、Ask、Agent、MCP 和项目规则带进受支持的 JetBrains IDE。适合已经深度使用 IntelliJ IDEA、PyCharm、GoLand 等工具、不想换编辑器的开发者。
Qoder CLI：在终端里使用编码智能体，并可将其扩展到脚本、自动化和开发工作流中。适合偏好命令行、需要把智能体嵌进流水线的人。
Cloud Agents：通过 API 运行托管智能体，需要配置 Agent 与 Environment、启动 Session 并流式接收结果。适合要把智能体能力集成进自有系统的团队。
QoderWork：把文档、表格、调研、浏览器和桌面任务委派出去，拿回可用的本地交付物。适合非编码类的日常工作任务。
QoderWake：创建被称为 Waker 的数字员工，承担持续性职责、对话、自动化和多阶段流程。适合需要长期运行角色的场景。
Mobile & Web：在离开电脑时监控受支持的 IDE 与 CLI 任务、审阅计划并处理审批。
Enterprise：集中采购、成员、身份、策略、知识、模型、市场、审计等治理控制。适合需要统一管理的组织。

下面以 JetBrains 插件为例展开，其余形态的操作入口不同，但「描述目标—规划—执行—验证」这条主线是一致的。

检查 IDE 版本

插件要求 JetBrains IDE 版本为 2020.3 或更高。低于这个版本需要先升级 IDE，否则插件无法正常安装或运行。

受支持的 IDE 包括 IntelliJ IDEA、Android Studio、PyCharm、GoLand、CLion，以及其他 JetBrains 系列 IDE。插件在本地和远程开发环境中都完全兼容，在 JetBrains Remote Development 工作流中也能完整使用，包括 SSH、WSL 和 Dev Containers 三种方式。如果你的代码跑在远程容器或 WSL 里，不需要为此另找方案。

注册账号并了解 Credits

使用前需要注册一个 Qoder 账号。每位开发者都可以注册免费账号，注册成功后会获得 300 Credits。如果后续用量不够，可以随时购买套餐。个人版与企业版的具体方案、Credits 的计费方式以及当前价格，请以官网当前信息为准，本教程不代为承诺任何数字。

建议在正式投入工作前先确认两件事：一是账号是否已经成功登录到 IDE 中，二是当前套餐的 Credits 余额是否足够支撑你打算做的任务规模。Agent 模式会执行多步操作，消耗通常高于单次补全。

操作步骤

第一步：安装并登录插件

在受支持的 JetBrains IDE 中安装 Qoder 插件，安装完成后使用刚注册的账号登录。登录成功后，插件会在 IDE 内提供代码建议、Ask 模式与 Agent 模式等入口。由于不同 IDE 版本的界面布局存在差异，具体菜单位置请以你所用 IDE 的实际显示为准。

登录后建议先打开一个真实项目，而不是空目录。Qoder 的补全与问答都依赖对代码库、依赖和既有模式的分析，空项目里几乎看不出效果。

第二步：体验代码建议

Qoder 的代码补全引擎不止分析单个文件，而是理解整个项目的上下文。它会分析你的代码库、依赖关系以及既有模式，给出在语法上正确、在架构上也一致的智能建议。核心能力包括：

整函数生成：生成完整的函数和代码块，而不只是单行补全。
预测式建议：基于更广的工作上下文，预判你的下一步编码动作。
架构一致性：建议与项目现有的设计模式和编码风格保持一致，减少后续重构。

这一能力的目标是让你保持在心流状态，减少重复性编码，把精力留给更高层次的问题求解。实际使用时，可以在已有同类实现的文件里开始写新函数，观察建议是否沿用了项目里的命名习惯与调用方式——这是判断上下文是否生效最直接的方式。

第三步：用 Ask 模式排查问题

Ask 模式相当于一个集成在 IDE 内的 AI 专家，可以直接咨询。它会综合大量技术文档知识，并结合对你项目代码的实时理解，给出准确的、带上下文的回答。典型用法有四种：

调试代码：粘贴代码片段和错误信息，获得分步的调试指引。
排查运行时错误：理解晦涩报错的根本原因，并拿到可执行的解决方案。
解释概念：请它解释不熟悉的 API、库或编程概念。
探索方案：在写代码之前，先讨论实现策略和架构取舍。

Ask 模式的价值在于省掉切换到浏览器的动作，让开发过程保持连贯。提问时把相关代码片段、完整报错栈以及你期望的行为一并给出，回答的针对性会明显提高。

第四步：用 Agent 模式完成多步任务

Agent 模式允许你把复杂的、多步骤的开发任务交给 Qoder。你只需用自然语言描述目标，智能体就会自主制定计划并从头到尾执行。它的工作方式分为三段：

目标：你给出一个高层次的目标，例如「把 UserService 重构为使用 async/await」。
规划：智能体把目标拆解成一系列有逻辑的步骤。
执行：它调用一整套集成工具来落实计划。

集成工具包括代码库搜索与导航、文件读取与编辑，以及用于执行命令的集成终端，例如 npm install、git commit 这类操作。因此 Agent 模式适合端到端任务：实现新功能、编写单元测试、执行大规模重构。

使用 Agent 模式时，目标描述越具体，计划质量越高。与其说「优化一下这个模块」，不如说清楚要改哪个类、改成什么形态、哪些行为必须保持不变。智能体在执行过程中会保留必要的审阅节点，你应当在它给出计划后先确认方向，再让它继续落地。

第五步：配置项目规则与 MCP

Qoder 可以通过两种机制精确适配具体项目需求和团队规范。

项目专属规则：在 .qoder/rules 目录下创建配置文件，即可告诉 Qoder 本项目的具体约定。这样它的建议和动作会与团队偏好的框架、编码风格和架构模式保持一致。规则文件适合沉淀那些「新人必须被口头交代」的内容，例如目录分层约定、异常处理方式、日志规范。

Model Context Protocol（MCP）：MCP 是一个集成层，让 Qoder 能够连接外部数据源。你可以用它补充额外上下文，例如公司内部文档、私有 API 或数据库 schema，从而让 Qoder 生成完全符合自有系统的代码。当项目依赖大量内部系统、而这些信息不在代码库里时，MCP 是补齐上下文的关键手段。

一个完整示例

下面用一个最小但完整的流程，把前面几步串起来。假设你有一个已有的服务层代码，其中某个服务类的方法仍是回调风格，你希望改成 async/await，并补上测试。

1. 打开项目并确认上下文

在受支持的 JetBrains IDE 中打开该项目，确认 Qoder 插件已登录。先让 Ask 模式读一遍相关文件，确认它理解当前的调用链：

请阅读 src/services/UserService 及其调用方，说明当前的数据获取方式、
错误处理方式，以及哪些地方依赖回调风格。

这一步的目的是验证上下文是否真的生效。如果回答里能准确指出调用方文件和错误处理位置，说明代码库索引正常，可以继续。

2. 建立项目规则

在项目根目录创建规则文件，把团队约定写进去。目录结构如下：

.qoder/
  rules/
    conventions.md

在 conventions.md 中写明本次重构必须遵守的约束，例如统一使用 async/await、错误统一向上抛出、不改变对外方法签名。规则写好后，后续的建议与 Agent 动作都会参考这些约定。

3. 交给 Agent 模式执行

切换到 Agent 模式，给出一个明确的目标：

把 UserService 中所有基于回调的数据获取方法重构为 async/await，
保持对外方法签名不变，同步更新所有调用方，并为改造后的方法补充单元测试。

智能体会先给出计划，通常包括：定位目标方法、识别调用方、改写实现、更新调用点、补充测试、运行测试。确认计划无误后让它执行。执行过程中它会使用代码库搜索定位文件、读取并编辑文件，必要时通过集成终端运行测试命令。

4. 验证结果

执行结束后，不要只看它说「完成」。逐项核对：对外方法签名是否保持不变、调用方是否全部更新、测试是否真的跑过并通过。如果测试失败，把失败输出交回给 Agent 模式继续迭代，或者切到 Ask 模式分析根因。这个「执行—验证—迭代」的循环正是 Qoder 设计的核心，不要跳过验证环节。

5. 沉淀可复用上下文

如果项目依赖内部 API 文档或数据库 schema，可以在这一步接入 MCP，把这些外部信息作为上下文提供给 Qoder。之后再让它生成涉及这些系统的代码时，输出会更贴合实际约束，减少返工。

注意事项

IDE 版本门槛：插件要求 JetBrains IDE 2020.3 或更高版本，版本不足时需先升级。
体验因产品而异：多智能体协作、Memory 与 Rules、Skills 与插件、完整上下文、Repo Wiki 等能力的具体表现，取决于你使用的是 Qoder 家族中的哪一个产品，不要假设所有形态功能完全一致。
Credits 会消耗：注册赠送 300 Credits，超出后需购买套餐。Agent 模式执行多步任务时消耗高于单次补全，做大规模重构前先评估余额。价格与配额以官网当前信息为准。
规则目录位置固定：项目规则需放在 .qoder/rules 目录下才会被读取，放错位置不会生效。
远程开发同样可用：插件在 SSH、WSL、Dev Containers 等远程开发工作流中功能完整，无需为远程环境另寻替代方案。
保留审阅节点：Agent 模式虽然自主执行，但仍保留必要的审阅点。在计划阶段确认方向，比在执行完成后返工成本低得多。