快速上手
用一个真实项目走完一遍：建项目、派活、批计划、看 diff、提交。
这一页用一个真实的改动走完整条链路。假设你已经装好桌面端、并在「设置 → 模型」接好了一个模型来源，见在 macOS 上安装或在 Windows 上安装。
一、为项目目录建一个项目
侧栏会话列表里的「项目」那一段，或者在输入框上方那一行「运行于」里选一个真实的工作目录。项目是为一个工作目录建立的容器，项目内的会话围绕真实文件和命令展开；不挂项目的普通对话单独管理。
会话的工作目录决定了 Klaus 的文件操作和命令默认在哪里发生，所以这一步选对目录比什么都重要。
二、把目标说清楚，让它先出计划
在输入框里描述你要的结果，而不是让它做某一步。需要先确定方案时，打开输入框 + 菜单的「计划」再提交任务，例如「为这个项目增加 CSV 导出，并说明验收方法」。Klaus 先探索代码，再按需要用问题卡片询问关键取舍；选中答案后明确提交。
完整计划会单独显示。展开阅读，或打开右侧计划编辑器修改全文并保存；有冲突时先处理冲突。计划不合适就选「其他」说明需要修改的地方；认可后选「是的，实施此计划」（⌘/Ctrl+Enter）。它会使用当前完整版本开始实现，并继续遵守原来的工具权限。详见计划模式。
三、动手时按权限卡片放行
执行写文件、运行命令这类动作前会弹权限卡片，按钮是拒绝 / 允许，中间还有一档「本会话内允许」（只在引擎能从这次调用推导出一条安全规则时出现）；卡上另有一个可勾选的规则建议，勾上再放行就等于「以后同类不再问」。嫌确认太烦就去「设置 → 预授权规则」预先配好放行与拒绝的规则，或者把输入框旁边的权限档改成「自动编辑」，见计划模式与权限确认。
四、在变更视图核对改动
右侧的变更视图（界面上就叫「变更」）算的是这个仓库目前相对 HEAD 的全部未提交改动，包括未跟踪的新文件，也包括你自己手改的东西。所以它是「现在这个仓库跟 HEAD 差了什么」，不是「Klaus 改了什么」。
先看文件级统计定位范围，再展开单个文件看具体行。
五、提交
在变更视图提交。提交是整仓提交：先全量暂存再 commit，没有只提交部分文件的选项，所以提交前先在变更列表里确认没有多带东西。提交信息可以让 Klaus 读着 diff 写一句。