不少开发者在使用 Claude Code 一段时间后，都会产生一种“不过如此”的感受：生成的代码对错不稳、优化过程中误改动无关文件、会话时长增加后回答逐渐跑偏。事实上，这些问题并非工具本身存在缺陷，而是使用者缺少一套规范、科学的使用框架。

这份《Claude Code 完全新手指南》总计12个章节，从入门安装、环境配置开始，逐层深入讲解 Agent Loop 运行逻辑、上下文管控方案、CLAUDE.md 项目记忆设定；同时详解子代理Subagents、自动化触发器Hooks、Worktree 任务隔离等高阶能力。教程末尾配套三套可直接复用的实战标准流程：老旧项目如何在不影响线上业务的前提下完成迭代重构、零散需求如何打磨为规范文档并实现并行开发交付、全新项目如何敲定架构并一次性完成 CI/CD 部署。手册内含30+高质量提示词模板，全部内容适配2026年最新软件版本。

【文末福利不可错过】

Claude Code

完全新手指南

从 0 到真正用好 AI 编程 Agent

安装 · 配置 · 实战 SOP · Subagents · Hooks · 最佳实践  ·  2026

图片

第一章  认识 Claude Code

1.1  一句话理解

图片

核心认知——你的角色转变

Claude Code 带来最核心的思维转变：使用者的身份不再是代码编写者，而是需求定义者、边界划定者、结果审核者。AI 的能力越强，人为约束就越关键。明确的使用边界与校验标准，是用好这款工具的核心。倘若缺少边界限制，它会擅自生成不符合预期的代码；没有判定标准，AI 便无法辨别结果是否合规准确。

1.2  与 AI IDE 的核心区别

工具

本质

使用方式

最适场

💡 两者互补，不是替代

Cursor 适合精细的逐行操作，Claude Code 适合大任务自动化。很多高阶开发者同时使用两者：Claude Code 负责大块任务，Cursor 负责精细打磨。

1.3  Claude Code 能力全景

能力类别

具体能力

代码开发

读懂整个 repo → 按需求写代码 → 跨多文件实现功能 → 安装依赖

调试修复

复现 bug → 追踪根因 → 修改代码 → 运行测试验证

重构升级

JS→TS 迁移、框架版本升级、模块化拆分、架构调整

测试自动化

为现有代码补写单元测试、集成测试，修复失败用例

Git 工作流

生成 commit message、解决冲突、创建 PR、代码审查

文档生成

README、API 文档、CHANGELOG、架构说明

外部集成

通过 MCP 查询数据库、调用 API、控制浏览器

CI/CD 自动化

配合 GitHub Actions 做自动代码审查和流水线生成

第二章  安装与账号配置

2.1  订阅要求

第三章  核心概念

3.1  Agent Loop（代理循环）

Claude Code 采用循环代理模式——不是一问一答，而是持续执行直到任务完成：

步骤

说明

① 收集上下文

读取相关文件、搜索代码、运行命令了解现状

② 规划任务

分析要做什么、按什么顺序、影响哪些文件

③ 执行操作

编辑文件、执行 Shell 命令、调用 MCP 工具

④ 验证结果

运行测试、检查错误、对比预期行为

⑤ 自我纠正

验证失败则分析原因，重新执行 ③④

循环重复，直到任务完成或你按 Ctrl+C 中断。你可以在任何时候暂停并重新引导方向。

3.2  上下文是有限资源

这是使用 Claude Code 最重要的认知之一。上下文窗口（约 20 万 token）会消耗你说的每一句话、Claude 读取的每个文件、每个命令的输出，以及压缩后的历史摘要。上下文一旦过长，Claude 就会开始「遗忘」前面的指令，输出质量明显下降。

命

重要原则

同一个问题修正超过两次，直接 /clear 用更精确的提示重新开始。新会话 + 好提示 > 长会话 + 累积修正。

3.3  三种权限模式

模式

图片

第四章  快速入门——30 分钟第一个任务

4.1  启动与基本对话

图片

4.2  四种基础输入方式

方

图片

核心体验

整个过程 Claude 自主规划、编写、验证，你只需要描述需求和审查结果。这就是 Agentic 编程的本质——你是工程师，Claude 是执行者。

第五章  CLAUDE.md——给 Claude 持久记忆

5.1  什么是 CLAUDE.md？

CLAUDE.md 是 Claude Code 每次启动时自动读取的配置文件，让 Claude 始终了解你的规范，无需每次重新解释。

文

图片

6.4  键盘快捷键

快

第七章  进阶技巧

7.1  Plan Mode 的正确姿势

5.按 Shift+Tab 两次进入 Plan Mode（提示符会变化）

6.描述你要做的事，让 Claude 分析影响面和执行步骤

7.仔细审查输出的规划，可以继续追问某个步骤

8.确认无误后，按 Shift+Tab 切回 Normal Mode 执行

探索 → 规划 → 执行 三步法

Step 1（Plan Mode）：分析现有实现，给我一个方案

Step 2（确认）：方案可以，开始实现

Step 3（自动）：Claude 执行，完成后跑测试验证

复杂功能始终先「describe → plan → approve → implement」，避免改了一大堆再回头

7.2  黄金提示词公式

提示词黄金公式：【目标】+【位置】+【验证】+【约束】

示例：

「为 @src/api/users.ts 中的 getUserById 函数添加 Redis 缓存，

  缓存有效期 5 分钟，使用现有的 @src/lib/redis.ts 客户端。

  实现后运行 pnpm test 确保所有测试通过，

  禁止修改函数签名和返回类型，解决根本问题而不是压制错误。」

7.3  描述症状，不是猜测原因

差的问法

好的

第八章  Subagents——独立上下文的专用助手

8.1  什么是 Subagent？

Subagent 是在独立上下文窗口里运行的专用 AI 助手，有自定义的系统提示和工具权限限制。它的核心价值在于：

•隔离大量输出——测试报告、搜索结果不会污染主会话上下文

•强制工具限制——只读代理无法写文件，安全可控

•并行探索——多个 Subagent 同时在不同模块并行调查

•跨会话记忆——开启 memory 让 Subagent 记住项目模式

8.2  内置 Subagent 类型

类

图片

8.4  Subagent 使用模式

第九章  Hooks——自动化触发器

9.1  什么是 Hooks？

Hooks 是在特定事件发生时自动执行的 Shell 命令，让 Claude Code 的操作触发外部自动化行为，无需手动干预。

Ho

图片

第十一章  实战 SOP

以下三套 SOP 覆盖开发中最常见的场景，可直接复用。每套 SOP 都经过实际项目验证，核心思路是：先建安全网，再动代码；每次只动一小块，每块都可验证。

11.1  SOP A：老项目重构

适用场景：接手历史包袱重的老系统，在不破坏线上功能的前提下逐步改善代码质量。

阶段

图片

图片

11.3  SOP C：全新项目研发

适用场景：从零开始建新项目/服务。核心是：先把「规则」写进项目，让 Claude 从第一行代码起就遵循这些规则。

图片

第十二章  常见错误与避坑指南

12.1  使用习惯类错误

图片

12.3  故障排除速查

症

附录  速查卡与配置参考

图片

D. 资源

Claude Code资料给大家整理好了，有需要的小伙伴按以下步骤获取领取方式：

1、一键三连+关注

2、后台回复“智能体”

#科技#​#IT#​#计算机#​#编程#​#程序员#​#计算机技术#​#AI#​#AI工具#​#人工智能#​#智能体#​#Agent#​#Agent智能体#​#ClaudeCode#​#ClaudeCode安装#​#ClaudeCode部署#​#ClaudeCode学习#​#Claude#​#智能体搭建#​