Claude Code 第一次打开项目：从安装到读懂一个下载包

你下载了一个开源资源，里面有 README、说明和模板，却不知道先打开哪一个。本课先用我们自己编写的模拟包练习：让 Claude Code 说明各文件的用途，判断哪些是可用材料、哪些只是尚未实现的计划。完成后，再把同一方法用于本站真实资源。

本课选择 Windows PowerShell 中的 Claude Code CLI，不是 Claude 普通网页聊天、网页上传 Skill 或 Cowork。无需编程基础，也不要求使用真实公司代码。

1. 安装前先确认账号与系统入口

需要允许安装软件的电脑、正常可用的网络和自己的账号。当前免费 Claude 网页账户不包含 Claude Code；需要账号对应的 Pro、Max、Team、Enterprise 计划，或 Console 等受支持入口。订阅用户先看当前计划与额度；Console API 是另一套计费，不因为下载开源文件而免费。

没有账号权益或所在环境不能正常使用时，先处理账号和组织规则。本课不要求购买第三方 Key，也不指导绕过访问限制。能阅读官方文档不等于账号已经可以运行 Claude Code。

从 Anthropic 官方产品页面进入 Claude Code 文档，打开 Quickstart—Install Claude Code。本文用官方列出的 Windows WinGet 安装方式。在 PowerShell 运行：

winget install Anthropic.ClaudeCode

安装完成后重开终端，运行 claude --version。应显示版本号和 Claude Code 标识。WinGet 安装的版本不会由这一安装路线自动更新，需要按同一工具的升级流程维护；初次练习先确认能正常启动，不必反复升级。

如果系统找不到 WinGet，回到官方安装章节选择适合设备的方式，不照抄陌生脚本。当前官方文档推荐在原生 Windows 安装 Git for Windows 以便使用 Bash；未安装时可使用 PowerShell 工具。本课没有 Git 操作，也不把安装 Git 或启用 WSL 当成必须前提。

本课编辑环境没有可调用的 Claude CLI，因此这里是按当前官方文档编写的操作路线，不是声称已在所有 Windows 版本实测。

2. 手动建立一个模拟下载包

在文件资源管理器新建 C:\ai-practice\claude-package。打开“查看—显示—文件扩展名”，用记事本保存 UTF-8 文本。文件结构如下：

claude-package/
├─ README.md
├─ docs/
│  └─ format.txt
└─ templates/
   └─ reading-note.md

README.md 完整内容：

# 阅读笔记练习包

这是开工科技为教学编写的模拟包，不是可安装的软件。
用途：提供一个手工填写阅读笔记的模板。
先读 docs/format.txt，再复制 templates/reading-note.md 后填写。
当前没有自动提取PDF正文的功能。
计划功能：以后考虑增加批量导出，但没有发布时间。
本包没有执行脚本，也没有提供许可证结论。

在 docs 文件夹创建 format.txt：

标题：使用材料原有标题，不重新取营销标题。
核心观点：记录原文支持的观点，不补充外部事实。
待查问题：只列问题，不把猜测写成答案。
没有原文材料时，应请用户提供材料，不能填写完整笔记。

在 templates 文件夹创建 reading-note.md：

# 阅读笔记

材料标题：待填写
核心观点：待填写
待查问题：待填写

三个文件各有角色：README 给阅读顺序，format 给填写规则，template 给结构。模板里“待填写”不是内容缺失错误，也不意味着 AI 可以凭空写一篇笔记。

3. 从正确位置启动，而不是让 AI 找整个磁盘

在练习目录的地址栏输入 powershell。执行：

Get-Location
Get-ChildItem -Recurse -File | Select-Object FullName
claude --permission-mode plan

递归列文件的命令只应在刚建立的练习目录运行；先确认位置，再执行。路径和三份文件正确后启动 Claude Code。首次按提示选账号，在浏览器完成认证，回到终端核对工作目录、当前账号与 Plan 模式。

Plan 用于阅读、分析并提出方案，通常在批准方案前阻止源码编辑；它不是系统隔离，也不是离线模式。不要启用绕过权限的模式。本课不需要批准实施计划、写文件或额外命令。

若你已经在另一个项目里开着会话，退出后从练习目录启动新的会话更清楚，不要让旧项目材料混进本课。使用 /help 可查看当前可用命令；不要把记得的网页按钮名当成 CLI 命令。

4. 先画出文件关系，再问能做什么

把以下文字放进 Claude Code 对话区：

只读取当前练习目录中的README.md、docs/format.txt、
templates/reading-note.md。
先报告实际读取的文件路径，再说明每个文件的角色和阅读顺序。
最后分开回答：这个包现在能做什么、不能做什么、哪些信息未知。
每个结论指出来自哪个文件，不把模板占位符当成已有文章。
只在对话里回答，不修改、不安装、不联网检索，不读取其他目录。

观察读取记录，再与文件管理器里的内容对照。下面是人工教学参考，不是本课现场模型输出：

README.md：说明用途和阅读顺序。
docs/format.txt：规定怎样填写笔记。
templates/reading-note.md：提供待填写的结构。
顺序：先README，再format，最后使用模板。

现在能做：提供手工笔记模板。
不能做：自动提取PDF正文；README明确当前没有该功能。
未知：批量导出发布时间、许可情况；材料没有给出结论。

不要要求它为“未知”填一个乐观答案。README 说“以后考虑”，不是已经排期，更不是已发布；没有许可证结论，不等于可以自行宣布商用授权。

5. 用一个追问检测它是否理解了项目

继续发送：

只凭当前三份文件，你能不能直接生成一篇完整的读书笔记？
如果不能，准确说还缺什么，不写文件。

正确方向是“缺少要阅读的原文材料；现有文件只给规则与模板”。如果它直接编出书名和观点，即使格式完全符合模板，仍是错误结果。

另一个反例是“运行安装命令后就能自动总结 PDF”。本包根本没有程序或脚本，任务也没有要求安装；应要求它指出所谓安装步骤来自哪个文件。如果没有依据，就撤回该建议。

6. 卡住时先判断在哪一层

客户端不能启动，先检查安装与 claude --version；能启动却不能登录，检查账号和网络提示。两者与文件夹结构无关，不要通过移动 README 来修复登录。

提示找不到文件，先看当前路径及扩展名。例如 README.md.txt 会让精确文件名不匹配；docs 建错到项目旁边，也会导致相对路径不存在。先在资源管理器纠正自己的练习文件，再重新提问。

文件都读到了却把“计划”说成“已有”，则是内容理解问题。反馈应是：“README 的批量导出属于计划功能，尚未提供发布时间，请只修正能力与未知信息两部分。”不要泛泛要求“更专业”。

结束后，检查仍只有三份原文件，没有生成笔记或安装其他资源。保留当前版本、练习输入和本次答案，用于以后遇到同类问题时比较。

用到真实资源时，增加哪一步

打开本站 如何使用免费资源，取得你选择的真实包后，先确认来源、文件类型与许可，再用类似的只读请求建立文件地图。不要默认每个包都有相同目录，也不要让模拟包的功能说明变成真实项目介绍。

本课练的是读懂项目。下一课 给 Claude Code 一个小修改任务 才会允许创建文件；要安装 Skill 则进入 Claude Code Skill 实操。这样你知道每次扩大操作范围是在做什么，而不是因为看到新按钮就全部打开。