Qoder Editor

基于 AI 驱动的智能代码编辑器，让编程更高效、更自然。

常用功能

快速上手

安装 Qoder 编辑器并完成首次配置，几分钟即可开始使用 AI 辅助编程。

从官网下载对应系统的安装包（macOS / Windows / Linux）
安装并启动，使用账号登录完成认证
打开或创建一个项目文件夹
开始编码，AI 会自动提供智能建议

提示：首次启动时，编辑器会自动检测项目类型并配置对应的语言支持。

智能补全与内联建议

Qoder 会根据上下文实时提供代码补全建议，按 Tab 即可接受。支持多行补全、函数体生成、注释驱动编码等。

核心操作：

输入代码时，灰色文字为 AI 建议，按 Tab 接受
按 Esc 忽略当前建议
写注释描述功能，AI 会自动生成对应实现
支持逐词接受：按 Cmd+Right 接受部分建议

内联编辑 (Cmd+K)

选中代码后按 Cmd+K，在原位直接描述修改意图，AI 会生成 diff 预览供你确认。

典型用法：

选中函数 → Cmd+K → "添加错误处理"
选中代码块 → Cmd+K → "重构为 async/await"
不选中代码 → Cmd+K → 在光标位置生成新代码

提示：生成的修改会以 diff 形式展示，按 Cmd+Enter 接受，Esc 取消。

聊天面板

通过侧边聊天面板与 AI 进行对话，可以提问、请求代码修改、调试帮助等。AI 能直接修改项目中的文件。

使用方式：

按 Cmd+L 打开聊天面板
输入自然语言描述你的需求
AI 会分析代码并给出建议或直接修改文件
你可以审查变更并决定是否接受

文件上下文引用

在聊天中使用 @ 符号引用文件、符号等上下文，让 AI 更精准地理解你的意图。

@file src/utils/auth.ts     -- 引用整个文件
@symbol UserService        -- 引用特定类/函数
@folder src/components/    -- 引用整个目录
@web https://docs.example  -- 引用网页内容

进阶功能

自定义 Rules 配置

通过 Rules 文件（项目级或全局级），你可以为 AI 设定编码规范、项目背景、行为约束等，让 AI 的输出更贴合团队标准。

Rules 可以定义在以下位置：

项目根目录的 .qoder/rules/ 文件夹（项目级）
全局配置目录（对所有项目生效）
支持 glob 匹配规则，针对特定文件类型生效

# .qoder/rules/coding-style.md
---
description: "TypeScript 编码规范"
globs: ["**/*.ts", "**/*.tsx"]
---

- 使用函数式组件，不使用 class 组件
- 所有导出函数必须有 JSDoc 注释
- 优先使用 const 声明

MCP Server 接入

MCP（Model Context Protocol）允许 AI 连接外部工具和数据源，如数据库、API、浏览器等，扩展 AI 的能力边界。

配置方式：

在设置中打开 MCP Server 管理面板
添加 MCP Server 的连接配置（stdio/sse）
AI 将自动发现并使用可用的 MCP 工具

// .qoder/mcp.json
{
  "servers": {
    "supabase": {
      "command": "npx",
      "args": ["supabase-mcp-server"],
      "env": { "SUPABASE_URL": "..." }
    }
  }
}

Agent / Subagent 自定义

创建自定义 Agent 来处理特定类型的任务，如代码审查、测试生成、文档编写等。每个 Agent 有独立的系统提示和工具集。

在 .qoder/agents/ 目录下创建 Agent 定义文件
定义 Agent 的描述、触发条件和专用提示
Agent 可以配置独立的工具权限和行为约束

Skills 使用与编写

Skills 是可复用的任务模板，通过 /skill-name 斜杠命令快速调用。可以编写自定义 Skill 来封装团队常用流程。

在聊天中输入 / 查看可用 Skills 列表
输入 /skill-name + 参数调用具体 Skill
自定义 Skill 放置在 .qoder/skills/ 目录下
每个 Skill 包含 SKILL.md 定义和可选的 UI 模板

多窗口/多项目管理

支持同时打开多个项目窗口，每个窗口拥有独立的 AI 上下文和对话历史。

通过 File → New Window 打开新窗口
每个窗口可以关联不同的项目目录
AI 上下文在窗口间隔离，不会互相干扰

主题与外观定制

完全兼容 VS Code 主题生态，支持自定义字体、字号、图标等外观配置。

设置 → 主题 → 浏览并安装主题
支持 JSON 格式的自定义主题文件
字体、行高、缩进等可独立配置

快捷键全览

高效使用 Qoder 的核心快捷键：

              Cmd+K          内联编辑（选中代码后）
Cmd+L          打开/聚焦聊天面板
Cmd+Shift+L    将选中代码发送到聊天
Cmd+I          新建对话
Tab            接受补全建议
Esc            取消建议/关闭面板
Cmd+.          快速修复建议
            

插件与扩展

Qoder 兼容 VS Code 插件生态，你可以安装大部分 VS Code 扩展来增强编辑器功能。

通过扩展面板搜索和安装插件
支持 .vsix 离线安装
部分 AI 相关插件可能与内置功能冲突，建议禁用

Quest

自主开发代理，描述需求后全自动完成编码任务。

常用功能

启动 Quest 任务

将开发需求描述给 Quest，它会自主规划、编码、测试，完成整个开发流程。

在 Quest 面板中输入任务描述（越详细越好）
Quest 会分析项目结构，制定实施计划
自动创建/修改文件、运行命令、执行测试
完成后等待你的审查和确认

提示：描述需求时，明确说明技术约束、文件位置等信息，能显著提升 Quest 的输出质量。

查看进度与审批变更

Quest 执行过程中，你可以实时查看它的操作进度、思考过程和产生的变更。

任务列表展示当前所有 Quest 任务状态
点击任务查看详细的执行日志和 diff
可以接受或拒绝特定变更
支持部分接受（cherry-pick 特定文件的修改）

追加需求与修正方向

在 Quest 执行过程中或完成后，你可以通过对话补充需求或纠正方向，Quest 会相应调整。

在任务对话中直接发送补充说明
Quest 会暂停当前工作，理解新需求后继续
如果方向偏离，明确指出问题，Quest 会回退并重新规划

进阶功能

并行任务管理

同时运行多个 Quest 任务，适合将大需求拆分为独立子任务并行推进。

在 Quest 面板中创建多个独立任务
每个任务在独立分支上工作，互不干扰
完成后可以分别审查并合并

Git 工作流集成

Quest 可以自动创建分支、提交代码、创建 Pull Request，完整融入团队的 Git 工作流。

任务启动时自动创建 feature 分支
每个逻辑步骤产生独立的 commit
完成后可自动创建 PR 并填写描述
支持配置 commit message 规范

上下文管理与记忆

Quest 拥有持久化的项目记忆，能记住项目架构、技术栈、编码规范等信息，随着使用积累变得更智能。

自动学习项目的技术栈和架构模式
记住过往任务中的偏好和决策
通过 Memory 面板查看和管理已记忆的内容

工具权限控制

精细控制 Quest 可以使用的工具和操作权限，确保安全性。

配置文件系统访问范围（可读/可写目录）
控制 Shell 命令执行权限
设置是否需要人工确认危险操作

错误恢复策略

当 Quest 遇到错误时，支持多种恢复策略：重试、回退到上一步骤、请求人工介入等。

构建/测试失败时自动分析错误并修复
多次失败后暂停并请求人工指导
支持回退到任意历史状态重新开始

CI/CD 集成

将 Quest 集成到 CI/CD 流水线中，实现自动化代码修复、PR 审查等工作流。

通过 API 触发 Quest 任务
CI 失败时自动创建修复任务
代码审查中自动响应评论并修改代码

Qoder CLI

命令行中的 AI 编程助手，终端工作流无缝集成。

常用功能

安装与认证登录

通过包管理器安装 Qoder CLI，完成认证后即可在终端中使用。

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

# 认证登录
qoder auth login

# 验证安装
qoder --version

对话模式

启动交互式对话，在终端中与 AI 进行持续的编程对话，AI 可以读取、修改文件并执行命令。

# 在当前项目目录启动对话
qoder chat

# 指定项目目录
qoder chat --project /path/to/project

# 带初始提示启动
qoder chat "帮我看看这个项目的结构"

提示：对话模式下，AI 拥有完整的文件系统访问和命令执行能力，与编辑器中的聊天面板功能一致。

单次任务执行

一次性执行任务，适合脚本化和自动化场景。任务完成后自动退出。

# 执行单次任务
qoder run "为 src/utils/auth.ts 添加单元测试"

# 从文件读取任务描述
qoder run --file task.md

# 指定输出格式
qoder run "列出所有 TODO 注释" --format json

进阶功能

配置文件

通过 .qoder/ 目录下的配置文件管理 CLI 的行为。支持项目级和全局级配置。

// .qoder/settings.json
{
  "model": "default",
  "permissions": {
    "allow_shell": true,
    "allow_write": ["src/**", "tests/**"],
    "deny_write": ["node_modules/**", ".env"]
  }
}

Hooks 钩子配置

在 AI 操作的特定时机执行自定义 Shell 命令，实现自动化工作流。

// .qoder/hooks.json
{
  "on_file_save": "npm run lint --fix ${file}",
  "on_task_complete": "npm test",
  "on_prompt_submit": "echo 'Task started'"
}

非交互模式与管道操作

在脚本和管道中使用 Qoder CLI，实现自动化批处理。

# 管道输入
cat error.log | qoder run "分析这个错误日志并给出修复建议"

# 非交互模式（跳过确认）
qoder run --yes "修复所有 lint 错误"

# 输出到文件
qoder run "生成 API 文档" --output docs/api.md

MCP Server 配置

在 CLI 中配置 MCP Server，扩展 AI 可访问的工具和数据源。

# 列出已配置的 MCP Servers
qoder mcp list

# 添加 MCP Server
qoder mcp add --name "database" --command "npx db-mcp-server"

# 测试连接
qoder mcp test database

CI/CD 集成

将 Qoder CLI 集成到 CI/CD 流水线中，实现自动代码审查、修复等。

# GitHub Actions 示例
- name: Auto-fix lint errors
  run: |
    qoder run --yes "修复所有 lint 和类型错误"
  env:
    QODER_API_KEY: ${{ secrets.QODER_API_KEY }}

自定义 Agent 类型

在 CLI 中使用或创建自定义 Agent，为特定场景定制 AI 行为。

# 使用指定 Agent
qoder chat --agent code-reviewer

# 列出可用 Agents
qoder agents list

环境变量与调试

通过环境变量控制 CLI 行为，使用调试模式排查问题。

# 环境变量
QODER_API_KEY=xxx         # API 密钥
QODER_MODEL=default       # 模型选择
QODER_LOG_LEVEL=debug     # 日志级别
QODER_CONFIG_DIR=~/.qoder # 配置目录

# 调试模式
qoder chat --verbose
qoder run --debug "任务描述"