在 Qoder CN 中选择工作方式并完成第一个可验证的任务。
本指南以“理解一个本地项目并完成一项小改动”为例，介绍从选择工作方式到验证结果的完整流程。
准备一个包含任务所需文件的本地文件夹。对于编程任务，建议从体量较小、测试命令明确的 Git 仓库开始，便于核对结果。登录 Qoder CN，并确认任务中不包含 Agent 无需使用的密钥或无关文件。
启动并登录 Qoder CN，在左上角选择编程或通用。准备修改代码、运行项目命令或使用 Git/Worktree 时选择编程；围绕普通文件夹处理资料、调研或内容时，可以选择通用。两种模式都能使用 Agent 和工具；编程按工作区组织任务并提供执行模式和分支选项，通用按文件夹组织任务。
在编程中选择已有工作区，或将本地项目添加为工作区。关联工作区后，确认输入区显示的本地模式或 Worktree 模式以及当前分支。本地模式直接使用所选工作区；Worktree 模式会为受支持的 Git 工作区创建独立副本，适合隔离任务或并行处理。在通用中选择或添加文件夹；不需要本地文件时，可以不选择文件夹。
在已经打开的输入框中描述：
开始前准备
准备一个包含任务所需文件的本地文件夹。对于编程任务，建议从体量较小、测试命令明确的 Git 仓库开始，便于核对结果。登录 Qoder CN，并确认任务中不包含 Agent 无需使用的密钥或无关文件。
1. 选择工作方式
启动并登录 Qoder CN，在左上角选择编程或通用。准备修改代码、运行项目命令或使用 Git/Worktree 时选择编程；围绕普通文件夹处理资料、调研或内容时，可以选择通用。两种模式都能使用 Agent 和工具；编程按工作区组织任务并提供执行模式和分支选项，通用按文件夹组织任务。
2. 选择任务范围
在编程中选择已有工作区，或将本地项目添加为工作区。关联工作区后，确认输入区显示的本地模式或 Worktree 模式以及当前分支。本地模式直接使用所选工作区；Worktree 模式会为受支持的 Git 工作区创建独立副本，适合隔离任务或并行处理。在通用中选择或添加文件夹；不需要本地文件时，可以不选择文件夹。
3. 创建任务
在已经打开的输入框中描述：
- 目标：要完成什么，例如“为用户列表接口补充分页参数”。
- 范围：允许查看或修改哪些目录、文件和接口。
- 结果：期望得到代码、测试、说明，还是仅分析建议。
- 约束：兼容性、编码规范、不得修改的内容和验证命令。
4. 选择模型与授权方式
- 模型：可以使用 Auto 让 Qoder CN 自动选择，也可以根据任务复杂度和成本选择模型层级。
- 访问权限：根据风险偏好选择询问审批、自动审批或完全访问。首次处理真实代码时，建议保留审批。三种方式见访问权限。
5. 审查并验证
- 查看执行过程，确认 Agent 使用了正确的工作区和文件。
- 在代码审查区域检查 diff，逐项确认修改是否符合目标。
- 运行测试、构建或静态检查，不要只以回复文本作为完成标准。
- 如有遗漏，在同一会话中补充要求；独立目标则创建新任务。