📘 Qoder 详细使用手册

1. Qoder 是什么

Qoder（发音 /ˈkoʊdər/）是阿里云推出的 Agentic（代理式）AI 编程平台，于 2025 年 8 月发布、2026 年 5 月推出 1.0 正式版。其前身是通义灵码（Lingma），2026 年 5 月 20 日正式升级更名。

与传统的 AI 编程工具不同，Qoder 不仅能做代码补全和问答，更核心的能力在于——

三大核心设计理念

核心能力数据

• 支持 100,000+ 文件的代码库分析
• Agent 最长执行时间 26 小时
• Repo Wiki 已生成 400,000+ 个项目知识库
• 全球 100 万+用户

2. 产品矩阵

Qoder 提供全场景覆盖的产品线：

3. 安装与配置

3.1 Qoder IDE 安装（推荐新手）

3.2 登录

启动后点击右上角用户图标 → 选择登录，支持三种方式：

• 邮箱注册（支持国内邮箱）
• Google 账号直接登录
• GitHub 账号直接登录

首次登录赠送 2 周 Pro 试用 + 300 Credits。

3.3 JetBrains 插件安装

• 打开 IntelliJ IDEA / PyCharm / GoLand
• Settings → Plugins → 搜索 Qoder → 安装 → 重启 IDE

3.4 Qoder CLI 安装

# 安装 CLI 工具
npm install -g @qoder-ai/qodercli

# 登录
qoder login

# 使用
qoder chat "帮我生成一个 React 组件"

3.5 模型配置（Qoder CN 用户）

Qoder CN 版默认使用阿里云百炼大模型，支持接入自定义模型：

• 打开设置 → 选择模型 → 添加
• 提供商：阿里云百炼（国内/国际）
• 模型类型：Coding Plan（需 Pro 版本）

4. 五大交互模式

5. 键盘快捷键速查

以下为官方完整快捷键列表（按功能分组）：

通用

聊天

行间会话

Diff 视图

Quest

上下文与快捷

6. Rules 规则体系 —— 让 AI 懂你的规矩

Rules 是 Qoder 的「行为宪法」，决定了 AI 生成代码的风格、规范和边界。

6.1 三级配置体系

6.2 最小必配模板

# .qoder/rules/project.md

## 技术栈
- 后端: Spring Boot 3.4 + JDK 17
- 数据库: MySQL 8.0 + MyBatis-Plus
- 缓存: Redis 7.x
- 消息队列: RocketMQ 5.x

## 代码规范
- 使用 Lombok 简化代码（禁止手写 getter/setter）
- 分层结构: Controller → Service → Mapper
- 统一返回体: Result<T>
- 异常处理: 使用全局异常处理器，禁止 try-catch 吞异常

## 安全红线
- 禁止在代码中硬编码密钥/密码
- 必须对用户输入做参数校验
- SQL 使用参数化查询，禁止拼接

## 测试规范
- 单元测试使用 JUnit 5 + Mockito
- 测试方法命名: methodName_scenario_expectedResult
- Service 层覆盖率目标 ≥ 80%

6.3 记忆偏好（Settings → Memory）

Always use arrow functions for callbacks
Include JSDoc comments for exported functions
Prefer functional components over class components in React

7. Quest —— Spec 驱动开发（王牌功能）

7.1 工作流程

7.2 实战示例

# Quest 需求描述
实现用户登录功能：
- 后端：Spring Boot 3.4 + Spring Security 6.x
- 认证方式：JWT Token，有效期 2 小时
- 密码加密：BCrypt
- 接口路径：POST /api/v1/auth/login
- 请求体：{ "username": "string", "password": "string" }
- 响应体：Result<LoginVO> 包含 token 和 userInfo
- 异常处理：用户不存在返回 404，密码错误返回 401
- 需要单元测试：正常登录、用户不存在、密码错误三个场景
- 代码风格：遵循项目 .qoder/rules/project.md 中的规范

7.3 Quest 模式选型决策

8. Repo Wiki —— 代码库知识化

Repo Wiki 自动扫描代码仓库，生成三类结构化文档：

.qoder/repowiki/
├── architecture.md       # 项目整体模块架构
├── modules/
│   ├── auth.md           # 各模块分层数据流
│   └── payments.md
└── dependencies.md       # 全接口参数说明

• 支持 100,000 级代码文件检索
• 生成时间约 120 分钟/4,000 文件
• 可持续同步，代码变更后自动更新
• 建议将 .qoder/repowiki/ 目录加入 Git 版本控制共享给团队
• 能回答「这个项目是干嘛的」「这个接口在哪定义」等问题

9. MCP —— 模型上下文协议

MCP（Model Context Protocol）是开放协议，标准化 LLM 与外部系统（API、数据库、本地工具）的交互方式，让 Qoder Agent 能力无限扩展。

9.1 两种传输类型

9.2 配置 MCP 服务

设置 → MCP → 点击 + 添加，编辑 JSON：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxx"
      }
    },
    "mysql": {
      "command": "npx",
      "args": ["-y", "@qoder/mysql-mcp"],
      "env": {
        "MYSQL_HOST": "rm-xxx.mysql.rds.aliyuncs.com",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "readonly_user",
        "MYSQL_DATABASE": "order_db"
      }
    }
  }
}

保存后连接图标亮起即表示成功。也可从 MCP 广场（MCP Square）一键安装社区服务。

9.3 使用 MCP 工具

• 切换到 Agent 模式，直接描述需求
• Agent 自动选择合适的 MCP 工具
• 首次调用需确认，之后可勾选「自动运行全部 MCP 服务」
• 可在服务详情中设置超时时长（Request Timeout）

10. 知识引擎与记忆系统

10.1 知识引擎（Knowledge Engine）

从代码和对话中持续沉淀知识，让 Agent 越用越懂你的项目：

• RepoWiki：自动解析项目架构、模块和依赖关系
• Knowledge Cards：对话中手动/自动捕捉的知识点
• 个人知识库：云端存储，跨项目共享
• 团队知识库：企业版共享，含 Repo Wiki + 编程经验沉淀

10.2 记忆系统

• 短期记忆：基于会话历史自动总结关键信息
• 长期记忆：NEXT 模块学习项目命名规范和代码风格
• 规则记忆：通过 Rules 配置文件实现确定性约束

11. Skills 与插件系统

11.1 Skills

v1.3.0 起支持内置专家智能体自定义提示词，团队可以创建符合自身规范的 Skills：

1. 定义 Skill 触发条件（如 /code-review）
2. 编写 Skill Prompt 模板
3. 指定使用的模型和工具
4. 测试并发布到团队 Skills 市场

11.2 插件系统

统一管理和分发 Rules、MCP、Skills、Hooks，为团队提供标准化工作环境。企业版支持插件下发管控和私有能力市场。

12. 计费与 Credits

12.1 个人版（Qoder CN）

12.2 国际版

12.3 团队版

13. 企业版功能

14. CLI 与 CI/CD 集成

14.1 CLI 基础使用

# 安装
npm install -g @qoder-ai/qodercli

# 登录
qoder login

# 交互式对话
qoder chat "帮我创建 RESTful API"

# 批量任务
qoder run --file task.md

14.2 CI/CD 全自动流水线

嵌入 GitLab/GitHub Actions 流水线，实现自动化代码门禁：

# .gitlab-ci.yml
qoder-review:
  script:
    - qoder login --token $QODER_TOKEN
    - qoder review --full . --format json > review-result.json
  artifacts:
    paths:
      - review-result.json

14.3 Cloud Agent API

企业版通过 REST API 调用 Qoder Cloud Agents：

# 获取 PAT 令牌
# Qoder 设置 → 个人访问令牌 → 生成新令牌

# 创建 Agent Session
curl -X POST https://api.qoder.com.cn/v1/agents/sessions \
  -H "Authorization: Bearer pt-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "code-reviewer",
    "environment_id": "env-prod",
    "task": "对 feature/order-refactor 分支进行代码审查"
  }'

15. 最佳实践

15.1 给新手

• 从小项目开始——不要一上来就扔给 AI 一个百万行项目
• 牢记三个快捷键：Alt+P（NEXT）、Ctrl+I（行间对话）、Ctrl+L（AI 聊天）
• 先用 Ask 建立信任——让它解释你的代码，验证理解准确后再用 Agent 执行
• 写详细的需求描述——给 Quest 的 Spec 越清楚，交付质量越高

15.2 给团队管理者

• 统一配置第一步——确保团队使用一致的 Rules 和模型偏好
• 善用团队知识库——把 coding standard、架构决策沉淀到 Rules 和 Repo Wiki
• 渐进式推广 SOP：先核心技术组试用（1-2 周）→ 验证效果 → 全面铺开
• 关注数据面板——通过分析面板监控使用情况、效率提升百分比

15.3 推荐工作流

1. Ask 来规划——「我应该怎么实现这个？」
2. Agent 来执行——「按我们讨论的方案实现」
3. Quest 做大事——让专家团队处理跨模块的复杂任务

15.4 版本控制建议

• 将 .qoder/rules/ 纳入 Git，团队统一编码规范
• 将 .qoder/repowiki/ 纳入 Git，新人可以直接查阅项目架构
• 配置 .qoderignore 排除 node_modules、dist、vendor 等无关目录

# .qoderignore
node_modules/
dist/
build/
vendor/
*.min.js
*.bundle.js
.git/
package-lock.json

16. 避坑指南

17. 与竞品对比

18. 总结

核心要点

• Qoder 不是又一个代码补全工具，而是从辅助到自主的技术范式跃迁
• Quest + Repo Wiki + 记忆系统 = 越用越聪明的 AI 编程伙伴
• 三级 Rules 让 AI 真正按团队的规矩办事
• MCP 生态让 Qoder 的能力接近无限可扩展

效率量化对比

未来展望

Qoder 代表的是 AI 编程工具的下一代方向：从代码补全到 Agent 协同，从个人提效到团队赋能，从辅助开发到自主工程交付。对于正在寻求数字化转型的企业和团队来说，现在正是布局 Agentic Coding 的最佳时机。