资料核验日期：2026-10-10。公开版保留整理正文与必要证据；原始资料通过来源链接回查。验证范围在正文中分别说明。

Claude Code 官方入门与任务流程

核验日期：2026-10-10。本机 claude --version 输出 2.1.295 (Claude Code)。此次制作没有重新安装、登录或发起 Claude 模型会话；实际运行证据来自配套 Python 示例。

1. 教程来源与使用环境

主线来自 Claude Code 101 及 官方 Quickstart。本地 中英双语教程 是转载与学习材料，标题不能单独证明官方归属。现行官方 Quickstart 明确链接 Claude Academy 的课程，可用它核对来源。

教程录制画面和本机版本有时间差。课程可保留任务方法；安装、模式和功能配置应回到当前文档。Windows 学习者可以在已安装时先运行 claude --version；未安装则按官方页面选择原生安装或 WinGet 等方式。不同安装方式的更新机制不同，本章不重装已有环境。

从 V2.0 目录进入教材的独立样例后启动：

Set-Location '示例\ClaudeCode\CC-01_asset_naming'
claude --permission-mode plan

账户认证按自己的产品入口完成，不要把 API 密钥写进教材、规则或共享报告。目录决定相对路径与项目上下文，先看界面显示的工作目录。

2. 一次会话的工作范围

Claude Code 是能读取项目、编辑文件和运行命令的编程 Agent 产品。模型、宿主工具、终端和版本管理共同完成任务；产品能处理代码库不意味着每个文件已读。

在启动后的会话内输入 /help 查看该版本入口，/permissions 查看操作规则。启动命令在 PowerShell 中运行，会话命令在 Claude Code 中输入。plan 用于读取分析并形成计划；具体可运行命令仍受权限配置约束。执行修改前应切到符合任务的模式。

权限文档 区分项目指令与执行权限。CLAUDE.md 中的“输入只读”表达任务边界，真实读取和写入限制由权限、执行器或 Hook 等机制落实。模式可用性会受版本和组织配置影响，不能照搬旧视频的默认行为。

3. 先让 Agent 解释项目

配套 命名检查器 使用 CSV 的 asset_type,name 字段。先要求读取规则、README 和样本，解释支持类型、输出与退出码，并给出文件依据。

读取规则.md、README.md 与 fixtures/assets_mixed.csv。
说明输入字段、支持类型、规则、报告格式和退出码。
按既有规则预测样本结果，指出仍缺少的信息，暂不修改。

检查回答能否回到实际文件。若模型把行业习惯当成样例规定，及时提供明确规则。该样例规定扩展名区分大小写，这是一项教学政策；它与 LLM-02 演示“允许大写 PNG”的任务条件不同。

4. 写出输入、结果和验收

混合清单有六行记录，三项有效、三项问题；问题对应 CSV 第 5、6、7 行。规则限定 StaticMesh 与 Texture，名称有规定前缀和扩展名，不修改清单或真实资产。

目标：根据规则.md 完成只读资产命名检查。
输入：fixtures/assets_mixed.csv；字段 asset_type,name。
范围：Python 标准库，不自动重命名、移动或读取引擎资产。
结果：逐行问题、汇总与 JSON 输出；补充运行说明。
验收：有效清单退出0；命名问题退出1；输入错误退出2。
先读项目；修改后运行固定答案样本，交付真实结果。

明确错误码很有帮助：退出 1 表示发现规则问题，不等于程序崩溃；退出 2 表示输入不能按合同处理。后续 Agent 据此判断是否应修复程序、修正输入或直接解释结果。

5. 从探索到修改

课程的 Explore → Plan → Code → Commit 可以落实为四项成果。探索得到实际规则与入口；计划把改动和检查对应起来；编码得到可运行工具；提交阶段检查差异并形成交付。

计划不用越长越好。输入解析、命名规则、报告和错误路径是这次需要的范围。图形面板、自动重命名和新依赖会改变任务，应有对应需求才添加。

在 Git 项目中用 git diff 查看实际修改，git status 看文件范围。最终文字不能代替差异检查；提交、推送和上线分别具有不同结果。本次教材没有创建 Git 仓库或发布项目。

6. 运行与错误反馈

在样例目录运行：

python asset_check.py fixtures/assets_mixed.csv --json
$LASTEXITCODE

应得到六项输入、三项问题与退出 1。再运行有效、边界、空表、错误表头和缺文件样本。把真实命令、完整报错与预期交给 Agent；“还是不行”缺少区分原因的信息。

配套 run_checks.py 重新运行七个 CLI 场景，同时检查扩展名故障与 Hook 脚本。结果见 ClaudeCode 示例检查。这证明样例程序与脚本合同，不证明 Claude 已在当前会话加载配置或自主完成任务。

7. 把交付写清楚

交付说明应包括问题、行为变化、修改文件、运行命令与实际结果，以及尚未验证范围。例如“混合 CSV 能逐项给出行号与原因；七类 CLI 场景与预期一致；没有读真实引擎资产”。

保存输入与报告，便于下一位学习者复查。规则变化时同步更改样本答案与说明，不要只调整测试使其通过。小任务无需加入无关的长报告或新架构。

8. 日常流程与练习

练习：在复制出的教学目录新增一项明确规则，先写新样本的预期，再让 Claude Code 完成修改。保留任务说明、差异、结果和交付记录。教材已附可运行示例；自己调用模型的记录由学习者另外保存。

验收：能够解释每处修改用途；程序输出与事先答案一致；知道退出 1 和输入错误的区别；不把示例结果当成全部生产资产验证。

来源

官方 Quickstart、权限、最佳实践 于 2026-10-10 读取。课程细节和历史案例见 V1 参考稿副本。继续阅读 CC-02。