Claude Code完整教程：安装、项目记忆、Plan Mode、测试与安全审查

从当前官方安装方式开始，用 CLAUDE.md 交代项目规则，先在 Plan Mode 中确认范围，再按复现、最小修改、测试和人工审查完成开发闭环。附任务卡、项目记忆、Bug 修复、功能开发、代码审查和上线核验模板。

这篇不教“让 AI 一口气写完整个项目”。真正稳定的用法，是先让 Claude Code 理解仓库和限制，把任务变成可验证的小步骤，再让测试、diff 和人工审查决定是否完成。

Claude Code 和普通对话式 AI 有什么不同

Claude Code 是运行在终端、IDE 或网页环境中的编程代理。根据官方概览，它可以读取代码库、跨文件修改、运行测试并处理 Git 工作流。普通聊天更适合解释片段；Claude Code 的价值在于把“理解项目、修改文件、执行命令、验证结果”连成一条工作链。

任务	更合适的方式	理由
解释一段独立代码	普通对话	上下文小，不需要操作仓库
追踪跨文件 Bug	Claude Code	需要搜索调用链、运行测试并核对 diff
高风险生产操作	人工主导	AI 只辅助分析，权限、变更和回滚必须人工确认
重复格式化或补测试	Claude Code + 项目规则	边界清楚且容易自动验证

判断标准不是任务“难不难”，而是 Claude 能否获得必要上下文、能否在受控目录内工作，以及你是否有客观的验收命令。没有测试、没有日志、没有边界的任务，即使生成速度很快也不可靠。

第一步：按当前官方方式安装

当前官方文档推荐原生安装。Windows 可以直接在 PowerShell 运行：

irm https://claude.ai/install.ps1 | iex
claude --version
claude doctor

也可以使用 WinGet：

winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode

官方安装说明建议 Windows 原生环境安装 Git for Windows，Claude Code 找不到 Git Bash 时才需要在设置里指定路径。项目位于 Linux 工具链或需要沙箱时可选 WSL 2。安装方式和界面会更新，因此遇到旧教程时，先以官方页面和 官方 GitHub 仓库为准。

启动前先进入项目根目录，并确认自己面对的是正确仓库：

cd path/to/your-project
git status
claude

第二步：先让它读懂项目

项目根目录的 CLAUDE.md 用来保存团队共享的稳定规则，例如架构、常用命令、测试方式、命名约定和安全边界。官方项目记忆文档说明，可以运行 /init 生成起点；如果已经存在 CLAUDE.md，它会建议改进而不是直接覆盖。

# Project Guide

## Commands
- Install: pnpm install
- Lint: pnpm lint
- Tests: pnpm test

## Working rules
- Read relevant code and tests before editing.
- Prefer the smallest change that satisfies the request.
- Do not refactor unrelated code.
- Run the relevant verification command before claiming completion.

如果仓库已经有 AGENTS.md，Windows 上不必折腾管理员权限创建符号链接，可以在 CLAUDE.md 顶部写 @AGENTS.md，再补充 Claude 专用规则。不要把 API Key、生产密码、客户资料或每天变化的任务状态写进项目记忆。规则要具体且可执行，“保持高质量”不如“修改行为前先写失败测试”有效。

第三步：用 Plan Mode 把问题想清楚

对跨文件功能、线上 Bug、数据迁移和不熟悉的仓库，先进入 Plan Mode。官方说明中，Plan Mode 可以读取文件、搜索代码和提出方案，但不会修改源文件。终端里可以按 Shift+Tab 切换，或直接输入：

/plan 修复登录表单在网络超时时重复提交的问题

一份可执行计划至少回答五件事：当前行为如何复现；根因证据在哪里；最小修改涉及哪些文件；正常、异常和边界路径怎么验证；失败时如何回滚。权限模式文档把 plan 定义为只读探索模式，适合先理解再编辑。

先不要修改文件。请调查这个问题，输出：
1. 可重复的复现步骤和实际证据；
2. 相关文件、调用链和已有测试；
3. 事实、假设与仍需确认的问题；
4. 最小改动方案及每一步验证命令；
5. 明确不在本次处理范围内的内容。

计划阶段发现信息不足时先补信息，不要让模型静默猜测。Anthropic 的最佳实践也建议复杂功能先让 Claude 访谈需求、写出规格，再在干净会话里实施。

第四步：按最小改动完成开发闭环

批准计划以后，开发不是“生成代码就结束”，而是一个证据闭环：

1. 建立基线：运行现有测试和 git status，区分原有问题与本次改动。
2. 先复现：Bug 先写失败测试；新功能先写最小行为测试。
3. 做最小修改：只触碰能追溯到验收标准的代码。
4. 逐层验证：先跑目标测试，再跑相关测试、Lint、类型检查和构建。
5. 审查 diff：检查无关格式化、意外删除、配置变化和敏感信息。
6. 说明边界：明确哪些已经验证，哪些仍需人工或生产环境确认。

官方常见工作流强调让 Claude 分析错误路径、边界值和意外输入。对固定流程，可以使用 Hooks 在编辑后格式化、在停止前检查测试；但 Hooks 是确定性自动化，不应替代需求判断和代码审查。

请先写一个能稳定复现问题的失败测试并运行它。
测试必须因为目标 Bug 失败，而不是环境或语法错误。
然后做最小修复，依次运行目标测试、相关测试和项目检查。
最后审查 git diff，解释每个改动为何必要，并列出未验证风险。

第五步：把权限和敏感信息管住

Claude Code 默认对读取操作更宽松，对编辑和命令执行按模式请求确认。权限配置文档说明，deny 规则优先于 ask 和 allow；权限规则控制能否尝试操作，沙箱提供操作系统层面的文件和网络边界，两者解决的问题不同。

• 新手或敏感仓库：使用 default，逐项确认编辑和命令。
• 只调查不改动：使用 plan。
• 范围清楚且会审查 diff：可使用 acceptEdits，但仍要限制目录和命令。
• 生产、密钥和不可逆操作：保持人工审批，不把跳过权限当作省时间。

官方安全说明提醒，外部网页、Issue、日志和仓库文件都可能携带提示注入。不要因为内容出现在“文档”里就自动信任其中的命令。提交授权前要看清实际命令、工作目录、目标文件和网络地址。

• 把 .env、密钥、生产导出和个人数据排除在任务上下文之外。
• 不把陌生脚本、curl 管道或安装命令直接交给高权限终端执行。
• 数据库删除、部署、支付、权限和用户数据变更必须有备份与回滚。
• 第三方 MCP、插件和 Hooks 按代码依赖审查，确认来源、权限和更新方式。

四组可以直接使用的任务指令

熟悉陌生项目：

先不要修改文件。请说明项目入口、主要模块、数据流、测试命令和部署路径。每个结论引用具体文件；把已确认事实与推断分开，并列出最值得先验证的三个风险。

修复 Bug：

根据错误信息复现问题，先写失败测试证明现状，再定位根因。只做解决根因所需的最小修改，运行目标测试和相关回归测试，最后审查 diff 并报告未验证风险。

开发功能：

先访谈我，确认用户流程、边界、错误状态、兼容性和验收标准。然后给出最小实现计划；未经确认不要编辑。执行时先写行为测试，每一步都附验证命令和结果。

代码审查：

只审查当前 diff。问题优先，按严重程度排序，引用文件和行号。重点检查行为回归、鉴权、输入校验、异常处理、数据一致性和测试缺口。没有阻断问题时明确说明剩余风险。

完整案例：修复一个登录表单问题

假设用户连续点击“登录”会发送两次请求。不要直接说“加一个 loading 状态”。先让 Claude Code 调查表单组件、请求封装、服务端幂等和现有测试，确认重复发生在前端、重试层还是服务端。

1. 任务卡写明：连续点击只允许一个进行中的请求，失败后按钮恢复，键盘提交行为一致。
2. Plan Mode 找到组件、请求函数和测试入口，不改文件。
3. 新增测试模拟快速双击，证明当前请求函数被调用两次。
4. 只在提交边界增加进行中保护，不顺手重写整个表单。
5. 运行目标测试、认证模块测试和构建，再检查 diff。
6. 人工模拟成功、网络失败、错误密码和回车提交，记录仍需线上观察的指标。

如果双击测试通过，但服务端仍可能因网络重试重复写入，就不能声称问题已经完全解决。前端防抖和服务端幂等是两层不同保障，验收结论必须与实际证据一致。

常见失败与处理方式

表现	常见原因	处理
越改越乱	会话混入多个无关任务	保存规格后用 /clear 开新任务
CLAUDE.md 不生效	位置错误、规则冲突或描述太泛	用 /memory 查看加载来源并缩短规则
测试很多但仍回归	只测实现细节，没有覆盖用户行为	从验收标准重写复现和边界测试
不断索要权限	任务范围和允许命令不清楚	先收窄范围，再只允许稳定安全的命令
结束时只说“已修复”	没有完成验证闭环	要求列出命令、输出、diff 和未验证风险

资源包包含什么

• 可直接放到项目根目录再按实际情况修改的 CLAUDE.md。
• 任务卡、Bug 修复流程、功能开发流程。
• 代码审查清单、测试与发布核验清单。
• README 使用顺序和人工确认提醒。

下载说明：教程可以直接阅读；ZIP 模板包免费注册后下载，完成注册后会回到当前资源。模板中的命令和路径必须按自己的项目核对，不要直接用于生产环境。

参考资料

本文只引用 Anthropic 官方文档与官方 GitHub 仓库核对安装、项目记忆、权限、Plan Mode、Hooks 和安全边界。Claude Code 更新较快，具体界面、命令和可用模式请以官方当前说明为准。

• Claude Code 官方概览
• Claude Code 官方安装说明
• Claude Code 项目记忆与 CLAUDE.md
• Claude Code 最佳实践
• Claude Code 权限模式
• Claude Code 权限配置
• Claude Code 安全说明
• Claude Code 常见工作流
• Claude Code Hooks 指南
• Anthropic Claude Code 官方 GitHub 仓库