# CC-01｜Claude Code 官方入门与任务流程

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

![完整任务逻辑架构图](<../../图表/CC-01_架构.svg>)

## 1. 教程来源与使用环境

主线来自 [Claude Code 101](<https://academy.claude.com/courses/claude-code-101>) 及 [官方 Quickstart](<https://code.claude.com/docs/en/quickstart>)。本地 [中英双语教程](<../../sources.html#ref-0e6f37e5b3d09b>) 是转载与学习材料，标题不能单独证明官方归属。现行官方 Quickstart 明确链接 Claude Academy 的课程，可用它核对来源。

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

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

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

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

## 2. 一次会话的工作范围

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

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

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

## 3. 先让 Agent 解释项目

配套 [命名检查器](<../../示例/ClaudeCode/CC-01_asset_naming/README.md>) 使用 CSV 的 `asset_type,name` 字段。先要求读取规则、README 和样本，解释支持类型、输出与退出码，并给出文件依据。

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

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

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

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

```text
目标：根据规则.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. 运行与错误反馈

在样例目录运行：

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

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

配套 [run_checks.py](<../../示例/ClaudeCode/CC-02-04_asset_workflow/run_checks.py>) 重新运行七个 CLI 场景，同时检查扩展名故障与 Hook 脚本。结果见 [ClaudeCode 示例检查](<../../检查记录/CC-02-04_示例检查.json>)。这证明样例程序与脚本合同，不证明 Claude 已在当前会话加载配置或自主完成任务。

## 7. 把交付写清楚

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

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

## 8. 日常流程与练习

| 阶段 | 读者要看到的结果 |
|---|---|
| 理解项目 | 入口、规则、输入与当前行为 |
| 描述任务 | 范围、结果、验收条件 |
| 检查修改 | 与任务有关的文件差异 |
| 验证 | 固定答案、实际命令与结果 |
| 记录 | 使用说明、限制与下一步 |

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

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

![本章思维导图](<../../图表/CC-01_思维导图.svg>)

## 来源

[官方 Quickstart](<https://code.claude.com/docs/en/quickstart>)、[权限](<https://code.claude.com/docs/en/permissions>)、[最佳实践](<https://code.claude.com/docs/en/best-practices>) 于 2026-10-10 读取。课程细节和历史案例见 [V1 参考稿副本](<../../sources.html#ref-f9bac0fe91f0f3>)。继续阅读 [CC-02](<CC-02_项目上下文与扩展.md>)。