Skip to content

Latest commit

 

History

History
103 lines (66 loc) · 5.68 KB

File metadata and controls

103 lines (66 loc) · 5.68 KB
title 跑通第一条会话
nav_title 第一条会话
description 选目录、定权限、说目标、看它改文件、逐行审阅——一轮完整流程。
order 3

跑通第一条会话

模型接好了,现在让它真的动一次手。找一个你不心疼的项目——最好是有 Git 的,改坏了能一键还原。

1. 新建会话,选好项目目录

点侧边栏的「新建会话」,或按 Cmd/Ctrl + N

空会话首屏,底部输入框里有权限模式、运行位置和模型三颗按钮

看输入框底部这一排:+ 是附件,往右依次是权限模式运行位置模型 + 推理强度,最右边是「运行」。

先点中间那颗运行位置 pill(截图里显示的是 task-board / main),选一个项目文件夹。这一步定的是 Agent 的活动边界:它读文件、搜索、跑命令、看 Git 状态,全都只在这个目录里进行。

如果这个目录是 Git 仓库,pill 里还能选分支,以及要不要开「独立工作树」。第一次先别开——直接在当前目录里跑,改了什么最直观。

2. 权限模式:从「询问权限」开始

点权限模式按钮,五个档位摊开在你面前。

五档权限模式菜单

模式 App 里的说明
询问权限 CLI 请求时确认文件编辑和高风险命令
自动接受编辑 Claude 无需询问即可写入磁盘
自动模式(需开启一次) Claude 会审查工具调用,并执行其认为安全的操作
计划模式 仅架构和推理,不操作文件
跳过权限(高风险) 对 Shell 和文件系统的完整工具访问

第一次请保持「询问权限」。 每一次写文件、每一条有风险的命令,它都会停下来问你,你能亲眼看清它想干什么。等你摸清了它的行为模式,再往上放权也不迟。

后面四档的分寸:

  • 自动接受编辑 只放开文件写入,命令仍然要问。适合"改动范围我已经想清楚了"的场景。
  • 自动模式 需要手动启用一次,之后由 Claude 自己审查每次工具调用,执行它认为安全的、拦下它认为有风险的。它会减少询问,但不保证安全——只在隔离环境里用。
  • 计划模式 完全不碰文件,只出方案。做只读调研、让它先讲清楚打算怎么改,用这个。
  • 跳过权限 关掉全部检查,Shell 和文件系统完全放开。它能删掉任何文件、跑任何命令,而且不会问你。不要在有生产密钥、个人资料,或者没有版本控制的目录里开它。

:::danger 「跳过权限」的风险跟「自动模式」不在一个量级上。自动模式至少还有一层 Claude 自己的审查,跳过权限连这层都没有。 :::

会话跑到一半时权限模式是锁住的——界面上的选择和实际生效的权限必须一致。要改就先等这一轮结束,或者按 Cmd/Ctrl + . 停下来。

3. 说出你想要什么

用大白话就行,不用装成技术需求文档。关键是目标可验证——说完你自己知道怎么检查它做没做到。

比如:

读一下这个项目,然后给任务列表加一个「按截止日期排序」的开关:
放在标题右侧,点一下就在「手动顺序」和「按截止日期」之间切换,
没有日期的排在最后。改完告诉我动了哪几个文件。

拿不准就先只读地问一句:「读一下这个项目,告诉我它是干什么的、怎么启动,不要改任何文件。」

Enter 发送(Shift + Enter 换行)。

4. 看它干活

完整一轮:工具调用折叠卡、思考、权限询问卡、内联 diff

它会先摸清情况再动手,你能看到几种不同的卡片:

  • 工具调用卡(「查找到文件, 执行了一条命令, 读取了 4 个文件」)— 折叠着的,点开看它到底读了什么、跑了什么。
  • 思考块 — 它对下一步的判断。
  • 权限询问卡(「允许 Claude Edit index.html?」)— 停在这里等你。卡片里直接带一份变更预览,绿色是新增行,红色是删除行。先把这段 diff 看完再决定

三个按钮:

  • 允许 — 只放行这一次。
  • 本次会话允许 — 同类操作在这条会话里不再问。改动范围已经清楚了就用它,能省掉一连串重复点击。
  • 拒绝 — 打回去。它会换个思路,或者反过来问你要更多信息。

想中途叫停,点输入框右下角的停止按钮或按 Cmd/Ctrl + .

5. 逐个文件审阅

每次编辑落盘后,会话里会直接展示一份内联 diff:文件路径、+8 / -3 的增删统计、左右对照的行号,语法高亮照旧。看会话流里的 diff 适合跟进单次改动。

一轮跑完,改动多起来了,就打开右侧工作区(标签栏右上角的「显示工作区」按钮)。那里把这一轮改过的文件列成一张清单,能逐个点开做完整评审,还能对着某一行写评论、把评论连同代码位置一起带回输入框继续让它改。

工作区的完整用法见 工作区

:::warning 被你拒绝掉的编辑不会落到磁盘上,但最终事实源永远是磁盘和 git diff。交付之前自己跑一遍 git statusgit diff,别只信界面。 :::

接下来