Skip to main content
开始使用

快速上手

10 分钟完成第一次任务:启动 Qoder CLI,理解项目、完成一个小改动并提交

前提条件

  • 已安装 Qoder CLI:运行 qodercli --version 能打印版本号即可。尚未安装见 安装与升级
  • 已完成登录:首次运行 qodercli 时会自动引导登录。登录方式详见 登录与认证

启动

进入你的项目根目录,启动默认的交互式(TUI)模式:
cd /path/to/your-project
qodercli
看到对话提示符 > 后,直接用自然语言描述你想做的事情即可。

完成第一次任务

第一步:让 Qoder 理解项目

从一个了解型的问题开始:
帮我梳理这个项目的整体架构和主要模块
Qoder 会自主搜索和读取相关文件,给出带文件位置的解释。你可以顺着它的回答继续追问,逐步深入。
建议顺手输入 /init,在项目中生成 AGENTS.md 记忆文件,让 Qoder 在后续会话中记住项目约定。详见 记忆

第二步:做一个小改动

用自然语言描述一个具体的小任务,例如:
给 <某个函数> 补一个单元测试,并运行验证
Qoder 在执行有副作用的操作(如写文件、运行命令)前,会根据权限设置向你确认。确认机制与放行规则见 权限与目录信任

第三步:审查并提交

改动完成后,输入 /review 让 Qoder 评审本地代码改动;确认无误后,直接让它提交:
帮我生成提交信息并提交这次改动
更多日常任务的提示词示例(探索代码、修复缺陷、重构、处理 PR 等),见 常见开发任务

常用操作速查

输入作用
!Bash 模式,直接运行 shell 命令
/打开斜杠命令列表
/help显示 TUI 帮助
/status查看版本、模型、账号与 API 连通性
/usage查看 Credits 使用情况
/resume查看并恢复历史会话
/quit退出 TUI
完整的输入模式、斜杠命令与启动参数,见 运行任务

下一步