Qoder AI 编程指南：从安装配置到核心功能实战

2. 验证与登录

安装完成后输入以下命令检查版本：

qodercli --version 

CLI 需要登录后才能使用。推荐交互式登录：

# 启动交互界面
qodercli 
# 输入 /login 命令

选择 login with browser 按提示授权。自动化环境可通过环境变量配置 token。

核心用法实战

安装完成后，掌握这 5 个关键操作就能覆盖 80% 的使用场景。

1. 基础操作：补全与会话

日常编码中，快捷键是最常用的方式。

• 代码自动补全：输入部分代码或自然语言描述（如'初始化一个 Python 列表'），按 Alt+P (Win/Linux) 或 ⌥P (Mac) 生成建议，按 Tab 接受。
• 行间会话：遇到问题直接按 Ctrl+Shift+I (Win/Linux) 或 ⌘⇧I (Mac)，打开智能会话窗口提问（如'给这段代码加个异常处理'），AI 会直接在编辑器中给出解决方案。

2. 智能问答模式

遇到语法问题或 Bug 排查，相当于拥有一个专属编程老师。

1. 打开 Qoder 智能会话面板（快捷键 Ctrl+L 或 ⌘L）。
2. 确保下拉菜单选择 智能问答。
3. 直接输入问题或选中报错代码点击'发送到聊天'，Qoder 会快速解答并提供示例。

3. @提及上下文

普通 AI 容易'失忆'，Qoder 的 @提及功能能精准关联项目上下文。

• @file：引用单个文件（如 @file main.py）。
• @folder：引用整个目录（如 @folder src/utils）。
• @attachments：引用本地文档（md/pdf/图片）。
• @rule：引用项目编码规则。

在会话框输入 @ 即可实时搜索项目中的文件，支持组合使用（如 @file main.py @folder test）。

4. 智能体模式

这是 Qoder 最强大的功能，让 AI 自主规划步骤，你只需告诉它'做什么'。

1. 在会话面板切换为 智能体模式。
2. 用自然语言描述需求（如'创建一个 Python Flask 接口，实现用户登录，包含参数校验和密码加密'）。
3. Qoder 会生成开发计划（如创建文件、引入库、编写接口），审阅后点击 执行。
4. AI 自动完成代码生成、依赖安装甚至测试运行。

注意：执行命令前默认会确认，避免误操作。复杂任务可先用 /plan 命令显式生成规划。执行中可随时暂停补充需求。

5. CLI 终端使用

习惯黑窗口的开发者可在终端完成所有工作。

1. 进入项目目录，输入 qodercli 启动交互模式。
2. 发送自然语言指令，例如：
   • '创建一个 shell 脚本，实现文件夹备份功能'
   • '修改 main.py 中的函数，增加返回值判断'
   • '运行当前项目的测试用例，并修复报错'
3. AI 直接在终端生成代码、修改文件并执行 git/pip 等命令。

高级玩法

1. MCP 协议扩展

MCP 允许 Qoder 连接外部工具，如 GitHub、测试工具或数据库。

1. 打开设置选择 MCP。
2. 可选择连接自有服务（添加 JSON 配置）或使用 MCP 广场安装现成服务（如 GitHub、Playwright）。
3. 配置完成后，智能体模式会自动判断是否调用工具，执行前会征求确认。

2. 记忆功能

Qoder 具备长期记忆，逐步记住你的编码风格、命名规范和常用库。

• 主动记忆：在智能体模式中直接输入偏好（如'项目中所有函数都用驼峰命名'）。
• 管理记忆：按 Ctrl+Shift+, (Win/Linux) 或 ⌘⇧, (Mac) 打开设置查看/编辑。
• 优先级：若记忆内容与项目规则冲突，以规则为准。

3. Repo Wiki 生成

告别手动写文档，Qoder 能分析项目结构和代码逻辑，自动生成结构化文档。

在智能会话面板输入'生成项目 Repo Wiki'，Qoder 会扫描项目，输出包含结构、模块说明、核心函数解释的 md 文件，方便团队协作。

常见问题与避坑

Eclipse 项目迁移

Qoder 暂无 Eclipse 插件，建议迁移至 VS Code 或 JetBrains IDE。

1. 直接用 IDE 打开 Eclipse 项目根目录（含 pom.xml/build.gradle 或 .src 文件夹）。
2. Maven/Gradle 项目会自动下载依赖，纯 Eclipse 项目可通过'Import Java Projects'导入。
3. 安装插件等待索引完成，Eclipse 的 .settings/.project 文件会被自动忽略。

索引慢或识别失败

• 确保项目能在 IDE 中正常编译，无严重语法错误。
• 大型项目首次索引需几分钟，耐心等待。
• 检查根目录是否正确，不要只打开 src 文件夹，应包含构建文件。

CLI 登录失败

• 确认网络正常，CLI 需联网授权。
• 环境变量登录请确保 QODER_PERSONAL_ACCESS_TOKEN 配置正确。
• 手动升级 CLI：qodercli update。

生成代码不符合预期

• 描述需求更具体，指定框架、版本、细节（如'用 Python 3.10 + Flask 2.0 实现登录，密码用 bcrypt 加密'）。
• 利用 @提及功能关联相关文件/规则。
• 先让 AI 生成开发计划，确认无误后再执行。

参考资源

• 官方文档：https://docs.qoder.com/
• CLI 快速上手：https://docs.qoder.com/zh/cli/quick-start
• JetBrains 插件文档：https://docs.qoder.com/zh/plugins/quick-start