使用手册 · 本站原创整理 · 独立阅读版
Claude Code 使用手册
在终端读懂项目，限定修改范围，用差异和检查结果验收。
入门步骤
1. 准备终端和可用账号
Claude Code 可用于终端、IDE、桌面和网页。本手册只演示终端工作方式，需要能访问相关服务的网络，以及适用的订阅、Console 或组织提供的访问方式。
- 打开本节官方快速开始，选择自己的操作系统及终端对应的安装方式。
- 安装完成后，在终端检查 Claude Code 的版本。
- 准备一个练习项目副本，避免第一次操作就使用重要项目。
- 进入练习目录后运行 claude，按提示完成登录或组织规定的认证。
claude --version入门步骤
2. 进入项目后，先了解结构
把终端切换到练习项目目录，再运行 claude。第一次任务先让它解释项目，不急着改代码。不要把聊天中的建议命令当作已经执行成功的结果。
- 核对回答中的项目目录是否正确。
- 查看它引用的说明文件或配置，确认命令确实存在。
- 如果项目没有测试，记录缺口，不要求它声称测试已经通过。
请只阅读当前项目，说明项目用途、入口文件、目录结构，以及现有的启动和测试命令。每个判断给出文件依据。不修改文件，也不要安装依赖。找不到的信息请明确写出来。入门步骤
3. 把修改范围控制在一个目标内
选择一个能检查的小变化，例如改正一处标题或修复一个布局问题。描述现象、预期结果、允许修改的位置和不能改变的行为。
请定位首页主标题的来源，说明把它改成“我的阅读角”需要修改哪个文件。只列计划，先不要修改。保持其他文案、链接、页面结构和依赖不变；同时说明修改后怎么验证。入门步骤
4. 执行修改，检查差异与结果
确认计划后继续执行。不同账号或组织可能采用不同权限模式；在当前界面核对实际设置，出现操作确认时先阅读范围。任务最终是否成功，以文件和运行结果为依据。
- 确认刚才的修改计划，让 Claude 完成限定变化。
- 查看修改文件和差异，检查是否包含无关变化。
- 执行项目已有的相关检查；页面变化还需要打开浏览器查看。
- 检查失败时保留错误，继续定位原因，避免用跳过检查来结束任务。
现在按确认的计划修改。完成后列出改动文件、实际运行的检查及其结果。未执行的验证单独说明，不要自动提交或推送。入门步骤
5. 继续任务，或在结束前留下交接
在 Claude Code 会话中，/help 可以查看可用命令，/resume 可以继续之前的对话。重新开始前先检查工作目录，避免把另一项目的要求带入当前任务。
- 同一修改尚未结束时，继续提供失败信息和明确的下一步要求。
- 需要离开时，让它总结已改文件、检查结果和剩余事项。
- 回来后使用 /resume 选择对应会话，再核对文件的实际状态。
- 遇到陌生命令用 /help 查询；不要把会话命令输入到系统 Shell 中。
请给这次任务留一份简短交接：目标、已修改文件、已完成检查、尚未验证的部分和下一步。只总结实际发生的事情，不新增修改。功能用法
6. 用 Plan Mode 和文件引用限定范围
不熟悉项目或改动涉及多个文件时，先进入 Plan Mode，检查方案再执行。下面的启动命令输入系统终端；@ 文件引用和后续自然语言任务输入 Claude Code 会话，不要把两种输入位置混淆。
- 先进入练习项目目录，用下方命令启动；已有会话可按 Shift+Tab，直到状态栏明确显示 plan mode on。
- 用 @ 选择需要分析的文件，要求说明影响范围与验证方法。目录引用提供文件列表，不等于每份正文都已阅读。
- 检查计划中的文件、预期行为和测试；确认后按当前界面批准计划或切换出 Plan Mode，再执行修改。
- 完成后查看差异与实际检查输出，确认没有顺带修改无关文件。
claude --permission-mode plan功能用法
7. 用 CLAUDE.md 保存项目约定
CLAUDE.md 适合记录构建命令、代码约定和反复强调的工作规则；自动记忆则保存从交互中学到的偏好。两者都是上下文，不能代替实际权限控制。
- 在项目中运行 /init 生成起始建议，逐项核对文件里的命令是否真实存在，再保留必要约定。已有文件时先查看建议和差异。
- 保持说明简短；把仅适用于少量文件的规则分到 .claude/rules/，复杂的可复用流程再考虑 Skill。
- 在会话中运行 /context，检查 Memory files 是否包含目标文件；用 /memory 查看或编辑已保存的记忆。
- 已有 AGENTS.md 的项目可在 CLAUDE.md 中用 @AGENTS.md 导入。Claude Code 不会仅因文件叫 AGENTS.md 就自动采用它。
# 项目工作约定
- 修改前先阅读相关文件，只处理当前任务。
- 使用项目已有的验证命令；没有命令时说明缺口，不编造成功结果。
- 保留其他人的未提交改动。
- 修改后列出文件、验证结果和未测项。
- 不自动提交、推送或部署。进阶技巧
8. 压缩、恢复与回退：先分清要保留什么
同一任务变长时，可压缩对话并保留关键决定；切换不相关任务时再清理上下文。对话恢复、上下文压缩和文件回退解决的是不同问题，不能互相替代。
- 用 /rename 给会话起明确名字；离开后在同一目录用 claude --continue 继续最近任务，或 claude --resume 选择历史会话。
- 压缩前保存改动文件、关键决定和未通过的检查，再用 /compact 附带保留要求。压缩后重新读取实际文件。
- 不相关任务使用 /clear 前，先留好交接；清空上下文不会把文件变回原样。
- 需要回看检查点时打开 /rewind，仔细选择要恢复的范围。它只覆盖 Claude 文件编辑工具记录的改动，不能撤销所有 Shell 或外部程序操作，也不能代替 Git 和备份。
/compact 保留本次目标、允许修改的文件、已确认的原因、实际测试命令与结果、尚未解决的问题和下一步。不要把未执行的检查写成已通过。常见问题
9. 常见问题：规则未加载、跑偏与验证失败
下面集中处理学习 Claude Code 时容易混淆的几类情况。把复现命令、错误与目标放在一起，比反复要求“再试一次”更便于定位。
写了 CLAUDE.md，为什么还是没有按要求做？
先用 /context 检查是否加载，再核对启动目录和文件作用范围。删除矛盾、过时或太笼统的规则。指令文件是上下文，不是能保证每次执行的权限开关。
它一直读文件，却没有开始解决问题？
缩小调查范围，给出目标文件、具体症状和判断标准；先要求说明已发现什么、还缺什么。对话已有大量无关信息时，先保存交接，再压缩或新开会话。
测试失败后，它建议跳过测试怎么办？
提供原始复现命令、错误和预期结果，要求定位根因。依赖或环境不齐时单独记录；不能把删除断言、屏蔽错误或没运行测试当作修复成功。
退出后如何继续？/rewind 能撤销所有操作吗？
在正确目录使用 claude --continue 或 claude --resume，运行中的会话也可用 /resume。/rewind 的检查点只跟踪指定文件编辑工具的变化，Shell 命令和外部程序的变化需要另外核对与恢复。
案例与练习
10. 实战练习：修复数量汇总的类型错误
下面提供实现与测试两个文件，使用 Node.js 24 即可运行，不需要安装依赖。起始实现故意把数字字符串直接相加，用来练习“复现 → 定位 → 最小修复 → 回归检查”。
- 下载练习 ZIP 并解压到独立目录，确认其中有 claude-total.mjs 和 claude-total.test.mjs；在该目录的系统终端运行 node --test claude-total.test.mjs，先阅读失败位置。
- 在此目录启动 Claude Code，引用实现与测试，让它先解释字符串参与加法的原因及输入约定，再确认修改计划。
- 只修改 claude-total.mjs。不得改掉测试预期或安装依赖；重新运行同一命令，并核对数字结果与非法输入。
- 保存修改前后的差异、实际测试结果和未测项，形成自己的练习记录。
请读取 @claude-total.mjs 和 @claude-total.test.mjs。先运行 node --test claude-total.test.mjs，说明失败原因与输入约定，再给出最小修复计划。确认后只修改实现文件，不修改测试、不跳过断言、不安装依赖。再次执行同一命令并报告实际结果，不自动提交。来源与核对范围
已核对 Claude Code 官方快速开始、工作流程、项目指令与最佳实践。本篇限定终端入口；新增代码和测试为本站教学材料，未让 Claude Code 执行修复，不代表产品账号实测。
本文为本站整理，不是官方译本。示例任务与完成标准用于学习，不代表产品承诺。