Claude Code 入门

给 Claude Code 一个小任务:只修正一份 FAQ 的错误说法

根据事实表只修正 FAQ 中的三处问题,明确从 Plan 转入手动审核、另存文件和同名冲突行为,并检查标题与事实没有漂移。

本文目录 · 6

“帮我优化一下文档”可能得到一份面目全非的新稿。本课练习更具体的委托:依据一份产品事实表,纠正 FAQ 中的错误,不改结构、不扩写营销文案,另存新文件后逐项核对。

先完成 Claude Code 第一个工作区,确保自己会选目录和查看模式。这里继续使用 Windows PowerShell 的 Claude Code CLI,不新增插件或付费服务。账号使用仍按自己的计划计费;全部产品、版本与日期都是本课虚构材料。

1. 准备有意包含错误的原稿

新建空目录 C:\ai-practice\claude-faq,用记事本保存两份 UTF-8 文件。第一份 产品事实.txt 是本练习唯一事实依据:

产品名:纸页笔记;当前版本:0.4。
本版支持在本机保存笔记,不支持多设备同步。
PDF导出正在开发,没有发布日期。
删除笔记后会进入回收站,保留7天,之后自动清理。
本练习没有提供价格、退款规则或客服联系方式。

第二份 FAQ原稿.md 故意写错两处、遗漏一处:

# 纸页笔记常见问题

## 1. 能否在多台设备同步?
可以,0.4版已支持多设备实时同步。

## 2. 如何导出PDF?
PDF导出将在下周上线。

## 3. 误删笔记怎么办?
删除后可以在回收站找回。

## 4. 退款怎么申请?
目前没有提供退款规则。

打开两份文件,先自己找一遍问题:同步功能未支持;PDF 没有发布日期;回收站有七天保留期限。第四问没有提供规则,应该继续保持未知,不要因为别的问题在改写就给它补上答案。

2. 把要求写成可核对的修改约定

在该目录打开 PowerShell,用 Get-Location 确认位置,然后用 claude --permission-mode plan 开始会话。按下列请求先要方案:

目标:根据产品事实.txt纠正FAQ原稿.md,另存为FAQ修订.md。
只使用这两份输入,不联网寻找产品信息。
保留产品名、四个问题的标题和顺序,保持Markdown结构。
只修改与事实冲突或遗漏必要限制的答案,不做营销扩写。
未提供的价格、退款规则、联系方式继续保持未知。
不得修改产品事实.txt和FAQ原稿.md。
如果FAQ修订.md已存在,先报告,不覆盖。
现在只读两份文件,给出逐项修改方案,等我确认再写文件。

好方案应定位到具体问答:第一问改为不支持同步,第二问撤回“下周”,第三问补七天及清理条件,第四问不变。如果方案里出现“重做官网”“查询竞争产品”“添加联系方式”,已经偏离本次任务。

让它先解释依据,是为了在写入前看清哪里要变,而不是追求长篇计划。用户不需要复述产品全部背景,只要把可信输入、允许修改位置和目标文件说准确。

3. 确认后才进入文件创建

先在文件资源管理器确认 FAQ修订.md 不存在。方案正确后,本课采用一条明确的切换路线:在 Claude Code 对话中输入 /exit 回到 PowerShell,核对仍在练习目录,再启动手动审核模式:

Get-Location
claude --permission-mode default

当前文档把这个模式称为 Manual,命令参数仍可使用 default。它不是绕过权限模式;已有工具许可与组织规则仍可能影响提示,注意每项实际动作。新会话不假定保留刚才的方案,因此重新提交完整范围与已确认的修改内容:

读取当前目录的产品事实.txt和FAQ原稿.md。
只根据产品事实.txt新建FAQ修订.md,不修改这两份输入。
保留产品名、四问标题、顺序和Markdown结构。
已确认方案:第一问改为0.4不支持同步;第二问写PDF导出正在开发且
没有发布日期;第三问补充回收站保留7天、之后自动清理;第四问不变。
不补价格、退款规则或联系方式,不做其他扩写。
不读取其他目录,不创建其他文件,不联网,不安装,不发布。
写入前如发现同名输出已存在,停止并报告。
完成后列出实际变更、文件路径,以及执行过和未执行的检查。

若出现写入批准提示,核对目标确实是当前练习目录的 FAQ修订.md,内容符合四项修改,再批准这次动作;目标不符就拒绝并纠正。若组织策略阻止写入,先按组织流程处理,不启用完全绕过权限。

本课正文给出了可复制的任务,不代表我们已经替你运行过客户端。若它只把修订文案放在聊天里,没有真的新建目标文件,就仍未满足这一步的交付约定。

4. 打开修订稿,对照人工参考

在文件资源管理器找到 FAQ修订.md,用实际编辑器打开。下面是人工教学参考,措辞可不同,但事实和结构不可变:

# 纸页笔记常见问题

## 1. 能否在多台设备同步?
不支持。0.4版支持在本机保存笔记,不支持多设备同步。

## 2. 如何导出PDF?
PDF导出正在开发,目前没有发布日期。

## 3. 误删笔记怎么办?
删除的笔记会进入回收站,保留7天,之后自动清理。

## 4. 退款怎么申请?
目前没有提供退款规则。

先检查问题标题与顺序,再检查四个答案。可以用 PowerShell 抽出标题进行比较,命令只读文件:

$before = Get-Content -LiteralPath '.\FAQ原稿.md' -Encoding UTF8 |
  Where-Object { $_ -match '^## ' }
$after = Get-Content -LiteralPath '.\FAQ修订.md' -Encoding UTF8 |
  Where-Object { $_ -match '^## ' }
Compare-Object -ReferenceObject $before -DifferenceObject $after

没有输出表示这四条标题作为集合没有差异;它不能单独证明顺序相同或答案正确。因此再目视检查编号 1、2、3、4 的顺序,以及“7天”“之后自动清理”是否同时保留。不要把一项命令检查扩大成“全文已正确”。

最后重新打开两份原文件,确认原稿中的故意错误仍在:我们要求保留原稿,修正只应出现在新文件里。

5. 用冲突场景检查它是否遵守约定

保持 FAQ修订.md 存在,发出同一个新建请求。预期行为是报告文件已存在、询问下一步,而不是悄悄覆盖。这个测试不需要再授权写入;如果它提出覆盖,拒绝即可。

另一个内容反例是“删除后七个工作日内随时恢复”。输入只说七天,没有“工作日”,也没有承诺特定恢复操作。应反馈:“第三问把7天改成了7个工作日,请只恢复原时间条件,不改其他答案。”

如果它把第二问写成“即将推出”,语气好像谨慎,实际上仍可能暗示接近上线。更稳妥的修订应直接保留“正在开发,没有发布日期”,不用营销词替代未知状态。

6. 这个小任务还会在哪些地方失败

找不到输入,先检查文件名是否多出 .txt,或者终端是否仍在上一篇的练习目录。输出与参考不符,指出哪一问和哪一句,不要用“差不多”“更高级”评价全部文字。

如果新增了价格或客服渠道,要求删除这些无来源内容,并检查是否还有其他补写;本课没有允许它联网补资料。若原稿被误改,先停止继续编辑,使用自己保留的原文内容恢复,不让它凭记忆重建。

一次性 FAQ 修订用清楚的请求就够了;如果经常需要“按事实表修订但保留结构”,才值得整理为可复用 Skill。可继续 制作第一个 Skill,学习如何把稳定流程、缺失信息规则和测试材料一起保存。完成这节课的标志不是回复很长,而是只有约定文件被创建,三处问题修正,未知信息仍然诚实保留。

文字来源:Anthropic Claude Code 官方文档;开工科技原创练习