Claude Code 第一次任务：从练习文件开始

📍 文件与编程进阶：Claude Code

终端前的人正在思考第一条任务指令，插画示意

第一次任务的目标，是看清 AI 如何使用一份材料，生成一个你能检查的文件。 不必先交给它整个桌面，也不必一开始就写完整应用。

本文适合已经安装 Claude Code，并有可用模型服务的读者。还没有配置，先看安装教程；只想免费练习对话，可以直接做第一条消息练习，不用安装本页工具。

核验日期：2026 年 9 月 26 日。下面是可复做的教学任务和验收条件，未调用付费 API 作本轮运行实测，也不保证固定几分钟完成。

先准备一个独立练习目录

在自己的用户文件夹中新建一个空文件夹，例如 ai-first-task-01。不要把真实工作资料、账号文件或照片原件放进去。

Mac／Linux 可以在终端逐行运行：

mkdir ~/ai-first-task-01
cd ~/ai-first-task-01

Windows PowerShell 对应为：

New-Item -ItemType Directory "$HOME\ai-first-task-01"
Set-Location "$HOME\ai-first-task-01"

如果第一行提示目录已存在，先停下，换一个未用过的名字，并同步修改第二行；不要直接进入一个不清楚内容的旧文件夹。

用 DeepSeek 临时变量的读者注意：那些变量只在当时的终端里有效。隔天新开终端来做这一篇，先在同一个终端里按 DeepSeek 配置篇重新设置一遍，再运行 claude；否则会进入 Anthropic 的登录界面，或者报认证错误。

接着在这个空目录启动：

claude --permission-mode default

这里显式选择手动确认模式，当前界面通常标作 Manual。新版 Claude Code 不加这个参数时默认是 auto 模式，大多数改文件、跑命令都不再逐条问你，所以第一次练习要自己指定。确认界面显示的工作目录和模型服务符合预期；已有权限规则仍可能允许某些动作自动执行。参数和模式以 CLI 说明及权限说明为准。

普通文件夹不是安全沙箱。我们把任务限制在这里，是为了容易检查和恢复；它不能取代权限控制。

任务一：生成并读取一份练习材料

机器人整理少量文件的插画，用于表示本页的练习目录，不代表整理真实桌面

复制以下指令。活动信息全部虚构，可以用于教学：

只在当前练习目录内操作，不读取其他目录，不浏览网页、不下载文件、不安装软件。
先检查当前目录中是否已有 draft.txt。
如果已有，停止并告诉我，不覆盖它。
如果没有，新建 draft.txt，逐字写入以下内容：

周六下午三点，线上读书会讨论《小王子》。
参加者不超过八人，每人准备一个想讨论的问题。
报名截止周五晚上八点，在群内回复“参加”。
会议链接还没确定。

写完后重新读取 draft.txt，告诉我实际读到的内容。

如果出现权限提示，先看是不是在当前目录新建 draft.txt，有没有额外读写、删除或安装动作，再决定是否允许。

这一轮的成功标准：目录里有 draft.txt，打开后四条事实都在，会议链接仍是“未确定”。仅仅在对话中显示文字，还不算生成了文件。

任务二：改成通知，保存新文件

文稿上标出修改痕迹的插画，表示保留原文并检查改写

接着输入：

读取当前目录的 draft.txt，把它改成一条可发到读书群的通知。
保留时间、人数、准备事项和报名截止时间。
“会议链接未确定”要明确写出来，不编造链接、日期或联系人。
先在对话里给我通知草稿，不修改任何文件。

先对照材料检查它的草稿。满意后再说：

请把刚才确认的通知保存为当前目录中的 notice.txt。
如果 notice.txt 已存在，停止并告诉我，不覆盖。
不要改动 draft.txt；保存后重新读取 notice.txt，让我核对。

验收时逐项检查：

原材料	通知里应该保留什么
周六下午三点	活动时间；没有具体日历日期，不擅自补日期
线上讨论《小王子》	活动方式和书名
不超过八人	人数限制
每人一个问题	准备事项
周五晚上八点，群内回复“参加”	截止时间和报名办法
链接未定	明确待补充，没有虚构地址

再打开两个文件：draft.txt 应保持原样，notice.txt 应与确认的版本一致。想调语气，可以让它先提供新草稿，确认后再保存为另一个文件名。

这一步的意义是区分“回答得像完成了”和“文件真的符合要求”。同一种核对方式也适用于报告、表格和程序。

看懂执行过程：别只看最后一句

终端、工具调用和文件编辑气泡的插画，不代表某个版本的真实截图

界面会随版本变化，重点看这几类信息：

正在处理或思考：表示任务还在进行，不能仅凭持续了多少秒判断故障。
读取文件或列目录：看目标路径是不是本次练习范围。
运行命令：看它要做什么；不理解时先暂停，让它说明输入、输出和副作用。
编辑或写入文件：看文件名、改动内容，以及是否覆盖了已有材料。
错误信息：保留错误文字、工具版本和所选服务，求助前遮住 Key 等凭据。

执行方向不对时，可按 Esc 中断当前回复或工具调用。已经完成的操作不会因为中断自动撤销，之后先检查文件，再继续。当前官方说明中 Ctrl+C 也能中断运行；空闲时连续按键可能退出会话，不要把它当作回滚键。交互与快捷键说明

任务三：可选，先预览一个小脚本

照片转换成统一格式的插画，表示下一阶段的小批量练习

只有前两个任务已经做顺，且你确实有批量处理图片的需求，再试这一步。准备三张有权使用、不含敏感信息的照片副本，放到练习目录的 photos-test 子目录中。不要用唯一原件。

例如，在 macOS 上可以这样提问：

我使用 macOS。当前练习目录的 photos-test 中有三张 HEIC 照片副本。
我想转成 JPG，原件保留，输出放入 photos-test/jpg。
先只检查文件名和本机工具是否可用，然后给出转换方案。
不要安装软件，不执行转换，不删除或覆盖任何文件。
列出计划读取和生成的文件；如果有同名输出，停止并说明。

读过方案后，先允许转换一张，打开结果检查能否显示、方向和尺寸是否符合需要；通过后再处理其余两张。输入格式和工具不同，方案也会不同，不能保证任意电脑都会出现同一段脚本。

普通文字改写不需要为此学习脚本。只有工作确实涉及重复文件操作时，这一步才有意义。

遇到问题，先缩小范围

人物遇到缠线和疑问的插画，表示逐项排查

现象	下一步
找不到 `claude`	回到安装教程，检查安装结果和终端环境
启动后认证、余额或模型报错	核对实际服务提供方、模型名与账户状态
回答已经保存，却找不到文件	核对工作目录，要求给出实际写入路径并重新读取
想处理整个桌面或安装额外工具	中断，重申本轮只处理练习目录内的指定文件
通知补了不存在的地址、日期	指出对应事实未提供，要求保留“待定”并重新核对
等待较久	查看最新工具输出、权限提示和服务状态；不要只用计时器判断卡死

DeepSeek 用户可继续查配置与报错排查，其他认证与安装问题见 Claude Code 官方排障。API 用量应以实际提供方后台为准。

第一次完成后，留下什么

通往下一阶段练习的门口插画

你应该得到原始材料 draft.txt、通知 notice.txt，以及一次自己完成的内容核对。还可以记下用了哪个服务、哪里出错、怎么修正，方便下次比较。

接下来读让 Claude 读文件、改文件。把范围逐步扩大到几份副本，每次仍然明确输入、输出和验收办法；并不需要马上把所有工作交给它。