P.7 · 准备第 4 步 · 开工体检
客户端能打开、命令也能运行,为什么还不能马上让 Claude Code 修改文件?
因为“装上了”只能证明安装程序跑过,不代表账号已经登录、项目文件夹选对、材料真的可读。正式开工前,我们用四份看得见的证据把这些问题一次排除。
上一课已经准备好同一份练习包、正确的外层项目、4 份只读素材和验收工具。现在确认整条路线真的连通。项目文件夹还没选对?回上一课
四盏灯分别回答什么
- 01工具能不能启动,账号有没有 Claude Code 权限?
- 02当前项目是不是外层 c01-first-delivery?
- 03Claude Code 能否读取 4 份素材,并且保持零修改?
本课交付证据启动、登录、项目、只读四盏灯全部变绿
开始体检 ↓四盏灯不是装饰。每一盏都对应下一课可能失败的一种真实原因。
CLAUDE CODE · 开工体检0 / 4 通过
还不能开工选择你的入口,按下面步骤拿齐四份证据。
01启动与登录证据
启动 Claude Desktop,打开顶部 Code。能新建会话说明客户端可用;Code 没有要求升级或重新登录,说明账号权限有效。
02项目证据
环境选择 Local,项目文件夹显示 c01-first-delivery,文件列表里能看到“开放日素材”。
01启动与登录证据
claude --version claude
第一条显示版本号;第二条进入 Claude Code。首次使用会打开浏览器让你登录,完成后回到终端,能看到任务输入界面才算登录成功。
02项目证据
pwd ls
路径最后是 c01-first-delivery,并且列表中有“开放日素材”。
03共同的只读测试
客户端直接在 Code 输入;CLI 先运行 claude,再发送同一段任务:
Mac/Windows 通用禁止修改
只读取“开放日素材”子文件夹,不要修改任何文件。告诉我里面有多少个文件,并列出文件名。完成后说明你是否执行过写入、移动、改名、覆盖或删除操作。
必须同时满足数到
4 个文件明确说明没有写入、移动、改名、覆盖或删除
哪盏灯不亮,就只修对应问题
启动灯不亮
回安装课核对客户端或 claude --version,不要修改任务内容。
登录灯不亮
确认账号方案并重新登录,升级提示不是文件夹问题。
项目灯不亮
重新选择外层 c01-first-delivery,不要重装工具。
只读灯不亮
核对“开放日素材”是否完整,再把完整回答和错误原文交给老师。
MAC · DESKTOP本机已安装核对
MAC · CLI完整任务已实测
WINDOWS · DESKTOP官方流程,待真机复测
WINDOWS · CLI官方流程,待真机复测
合上上文再回答
Windows 学员使用 Claude Desktop 的 Code 本地会话,额外必须安装什么?
官方桌面快速开始明确要求:Windows 的 Code 本地会话必须安装 Git。Node.js 和 CLI 都不是客户端的前置条件。
官方依据桌面客户端首次会话 ↗CLI 验证命令来自官方安装文档
Windows 学员请保留完整截图。
课程下一轮真机复测需要:系统版本、客户端版本、Git 版本、四灯结果与只读回答。
课前准备正式完成
四盏灯全部变绿,说明工具、账号、项目和材料已经连通。现在终于可以让 Claude Code 动手创建第一份真实文件。
下一课的新问题是:它已经看得到 4 份素材,但你只说“帮我整理一下”,它仍然不知道要交什么、哪些不能碰、怎样才算完成。
进入正课第 1 课:说清任务并生成活动执行页 →最后验收