Claude Code 保姆级教程：从入门到进阶

这是一份从 0 基础开始的 Claude Code 系统教程。我们从安装讲起，接入第三方厂商模型绕过区域限制，逐一拆解权限系统、Tools 工具、Hooks 钩子、Skills 技能、Plugins 插件、Subagent 子智能体以及自动化任务这些核心功能，最后把它们综合起来，一起做一个真正可用的网页 AI App。跟到最后，你就能随心所欲地用 Claude Code 完成日常工作，并构建你想要的项目。

第一章：环境准备与安装

在正式使用 Claude Code 之前，我们一共需要安装三样东西：Git、VS Code 和 Claude Code 本身。别担心这些概念，下面逐一解释，安装都非常简单。

1.1 安装 Git

Git 是什么？ Git 是代码的版本管理工具，你可以把它理解成「AI 的后悔药」。

当我们让 AI 帮忙写代码、写脚本、做自动化任务时，任何不对、不满意的地方，都可以随时通过 Git 回退到之前的版本；同时它还能对比两个版本之间代码的差别。

💡 重点：这里的 Git 不是给你用的，是给 AI 用的。你只需要把它装好，让 AI 去做这些版本管理的工作即可，不需要自己学 Git 命令。

如何安装：

（如果暂时不涉及代码程序、或大量文件修改，想先做小项目，可以暂不安装）

Windows 系统：

下载 Git 安装包

国内镜像推荐清华大学开源软件镜像站

地址：https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/

找到Git–64-bit.exe或Git–32-bit.exe，下载后直接安装。

Mac 系统：

打开「启动台 / 应用程序」，搜索 terminal（终端），点击打开，把命令粘贴进去回车即可。

如果没有安装 Homebrew，先执行：

然后执行：

1.2 安装 VS Code

为什么需要 VS Code？

如果没有 VS Code，我们的工作界面就只有一个孤零零的终端：想开新终端要另开窗口，看不见文件树，也看不到代码。

有了 VS Code 之后，我们就能在一个界面里完成所有工作：

左边栏：看到项目的文件树；

主区域：查看代码和文件；

下边栏：终端，在这里跟 Claude Code 对话。

如何安装：

搜索「VS Code 安装」，进入官网，它会自动检测你的操作系统。

macOS：下载后把安装包拖拽到「应用程序」文件夹即可。

Windows：下载对应安装包，双击安装。

首次打开如果让你登录，可以直接点 Skip 跳过。

1.3 安装 Claude Code

绕过Anthropic账号限制（无魔法安装）

Claude Code 不仅能用 Anthropic 自家的 Claude 模型，也可以接入其他厂商的模型。对于因为区域等原因无法直接使用 Claude 模型的朋友，接入第三方模型或者是使用API的方式就非常重要。

Claude Code、Codex 安装配置教程

第二章：界面详解（终端与图形化）

很多朋友抵触在终端里操作，觉得太技术、太复杂。别担心，我们把所有界面元素过一遍，你会发现其实非常好理解。而且 Claude Code 除了终端，还有图形化操作界面。

2.1 VS Code 的三个关键区域

打开 VS Code，先看右上角有三个可以弹出的栏：

左边栏：主要用来看文件树。点击任何文件都可以进去查看、修改（代码不用你写，但可以看）。左边栏还能安装插件等。

下边栏：也就是终端，我们把 Claude Code 从这里叫出来进行操作。

右边栏：可以把你想要的栏目放进去，后面用到再讲。

用到最多的三个地方：

终端 —— 跟 Claude Code 对话的主要入口；

左边文件树 —— 方便查看、修改文件；

主区域 —— 查看代码和文件（大部分时间不用你改）。

2.2 终端界面的信息解读

打开后，终端界面的信息含义如下：

右上角：版本号。

下面：使用的模型及其推理强度。

右侧：使用的 Claude 订阅。如果你用的是第三方（如某厂商模型），这里会显示对应模型、推理强度，以及标注走 API 付费。

再下面：当前工作目录（你在哪个文件夹下打开的 Claude Code）。

试着问它一句「给我讲一个冷笑话」，底部状态栏会更新出很多信息：

状态栏项	含义
模型名（如 Sonnet 4.6）	当前使用的模型
文件夹位置	当前工作目录
0.6k 之类的数字	当前对话累计消耗的 token 数量（不是单条回答，是整段对话累积）
ctx 18%	当前已用上下文的百分比
5h 32%	当前 Claude 订阅5 小时额度已用 32%（官方登录方式）
7d 28%	**7 天（一周）**额度已用 28%（官方登录方式）

💡 token 太少（不到 100）时不会统计；问更长的问题才会累积显示。

但你刚开始使用Claude Code时，可能并不会展示最下面的这条状态栏。

这时候你就需要让它帮你把这个状态栏调出来。

输入以下提示词：

等它执行完你就拥有了这条状态栏。

这条状态栏有什么用？

你可以把它理解成“任务仪表盘”。

这就像你开车时，不只是想知道发动机在不在转。

你还会看：

油够不够

现在开到哪了

是不是快超载了

路线是不是还在继续

Claude Code 的状态栏，承担的就是这个角色。

2.3 思考/工作过程界面

不论问什么问题，Claude Code 都会有一个专门展示思考和工作过程的界面，里面包含很多信息。逐行解释：

顶部若出现类似 frontend-design 的字样，说明它调用了这个 Skill 来完成任务。

白点开头的一行字，是它工作过程中给你的回答。

Write demo.html —— Write 表示它使用了写入工具，写入了 demo.html 这个文件；下方是写入的代码内容（会做简略显示）。

想展开全部内容，按快捷键 Ctrl + O。

顶部出现 infusing 之类的词没有实际意义，只是表示它在思考。

24s 表示此次任务执行时间；501 tokens 表示此次任务到目前消耗的 token 数量。

💡 刚安装打开时，状态栏大概率不显示这些信息。想显示它们，需要给 Claude Code 一段提示词，让它把这些信息显示在状态栏下（可用官方/社区提供的 statusline 配置）。

2.4 图形化操作界面（VS Code 插件）

不习惯终端？Claude Code 有图形化界面：

打开左边栏（图标在右上角）。

点击「管理插件」图标。

搜索 Claude Code，第一个 Anthropic 蓝标的插件就是我们要的，点击 安装。

安装后有两个改变：

左边栏出现 Claude Code 标志，点开可以在这里聊天；

右边栏也自动弹出 Claude Code 标志。

推荐用法：把右边栏的 Claude Code 保留（右边这个按钮打开右边栏），左边栏用来看文件树，这样两边可以同时工作。如果右边栏同时有 Claude Code 和 Chat 两个弹窗，可以把不需要的拖到左边，只保留右边栏的 Claude Code。

2.5 图形化界面元素

右上角放大按钮：右边栏完全弹出，占据整个屏幕（截图给 Claude 看时很有用）。

叉号：关闭右边栏。

对话历史按钮：回到之前的对话历史。

加号（新对话）：开启一个新的对话线程，跟网页端 AI 对话一样。

对话框加号：上传任何文件。

@ context：增加上下文，可以 @ 现有文件夹里的文件。

关于上下文的关键点：除了用 @ context，更常用的是直接点击文件。当某个文件出现在对话框下方（显示文件名），说明它已被加入上下文，接下来对话时这个文件就会进入上下文。例如你问它「在看哪个文件」，它会回答正在看 index.html；你让它加一行欢迎语，它就会真的修改这个文件。

暂停按钮：思考/工作过程中，点它可以停住当前工作。

斜杠 / 按钮：点开看到所有指令，等价于终端里 / 下拉看到的各种命令。

edit automatically 按钮：点击后有三种不同的权限/工作模式（详见第四章）。

第三章：权限系统

Claude Code 的权限系统其实非常简单。从左到右，一共有四种权限模式：

3.1 四种权限模式（VS Code）

模式	名称	行为
1	Plan Mode（计划模式）	只做计划，完全不修改任何东西。
2	Ask before edit（默认模式）	每次动手前、修改文件前都先征得你同意，你点 Yes 才继续。
3	Edit automatically（自动接受编辑）	编辑文件的命令、常见系统命令会直接帮你做，不再问你。但部分终端命令和网络请求仍要征得同意。
4	Auto mode	自动拆解、自动持续推进

3.2 实操走一遍

Step 1｜Plan Mode 制定计划

把模式改成权限最小的 Plan Mode，给它一个简单任务，例如「帮我做一个简单的个人博客网站」。它会在 Plan Mode 下思考、制定计划，此时还没有新建任何文件。计划给出后有三个选项：

Yes, and auto-accept —— 接受并开始执行，任何编辑命令不再询问（对应第 3 种权限模式）。

Yes, and manually approve edits —— 开始执行，但任何编辑命令都要你 Yes 才放行（对应第 2 种模式）。

No, keep planning —— 计划不满意，继续修改计划。

Step 2｜Ask before edit

选 2 后，右下角模式自动变成 Ask before edit。它想新建文件夹（通过终端命令）会问你同意，点 Yes 放行；想把内容写进 index.html 也会问你同意。

Step 3｜Edit automatically

不想每次盯着，可以点 Yes, allow all edits in this session。之后右下角权限自动变成 edit automatically，相当于批准了那次编辑，并把模式切成自动编辑、自动同意、不再询问。

有些终端命令（如 mkdir 创建文件夹）可以自动批准；但像 open 这样的命令不在自动批准清单内，仍会询问。你可以选择「本项目内所有 open 命令都不再询问」，它就会执行 open 直接帮你打开创建好的网页。

Step 4｜Auto mode

可以把它理解成 3 个关键词：

自动拆解任务 你给目标，它自己拆成步骤，而不是等你每一步指挥。

自动调用工具 会自己读文件、搜代码、改代码、运行测试或命令。

自动持续推进 遇到小问题不会立刻停下，而是先自己排查、修复、再继续。

3.3 开启 Bypass Permissions（全权限）

右下角没有更高的模式了，Bypass permissions 在哪里开？

终端命令

回车后自动进入 Bypass permissions（最高权限）模式，终端里会显示已生效。

生效后再让它重新建网页、修改、重新打开给你看，整个任务从头到尾再也不会问你任何权限。

⚠️ Bypass permissions 会让 Claude Code 自动完成一切，包括可能有破坏性的操作。请谨慎使用。

第四章：Tools 工具

Tools（工具）是智能体里最基本的概念。

大模型只能做推理、给出文字回答，本质上没有任何改变环境的能力：它无法替你操作电脑，无法改变项目里的代码，也无法在文件夹里新建或修改文件。它只能「想」，只能告诉你文字。

这时候工具就登场了。

大部分工具本质上只是完成特定任务的一段代码。

当大模型想执行某个任务时，Claude Code 会：

解析大模型输出中想调用哪个工具、怎么调用；

调用并执行相应的工具（也就是执行对应代码），从而真正改变环境。

如果说大模型是大脑，那么工具就是它的手，大脑操纵手来干活。

4.1 一个直观例子

用户想「减少文章字数」：

大模型看到需求，心想：需要调用写入工具，在文件第 3 行加上这么一句。

Claude Code 解析出「要调用写入工具」，真的在文件里写入这一行。

项目被改变，用户看到字数变少了。

用户只下达了「减少文章字数」的命令，看到的是整个智能体协同工作、改了文件、最终字数少了——智能体完成了本该由人完成的工作。

4.2 Claude Code 的内置工具

Claude Code 已经内置了很多工具，例如：

Write —— 写入文件

Read —— 读取文件

Edit —— 编辑文件

Bash —— 执行终端命令

WebSearch —— 网络搜索工具

WebFetch —— 网络抓取工具

……等等

4.3 实操：看工具如何被调用

拿生成的网页举例，希望主题颜色从红色改成绿色。可以截图发给 Claude Code。

观察它的工作过程：

Bash —— 执行终端工具，看看当前文件夹里有多少文件；

Read —— 用读文件工具读取；

Edit —— 用编辑文件工具修改。

调用这几个工具后，它成功把网页颜色从红色改成绿色。

总结：Claude Code 本质上就是一个不断循环的过程——大模型思考想做什么、要调用什么工具，Claude Code 就调用这些工具，从而实现你的要求。每个被调用的工具都会在过程里清楚地体现出来。

第五章：Hooks 钩子

Hooks（钩子） 是一个很重要但很多人较少听到的功能。

它的作用是：在程序运行到某个关键节点时，提前预留一个挂钩，让你可以在此时插入自己的逻辑。它常常被用作智能体的监督员——在关键节点强制检查「智能体真的照我说的做了吗」。

5.1 常见的钩子节点

Hook	触发时机	作用	解释
Stop	主智能体结束任务之前	交付验收门	检查测试、lint、类型、页面运行、TODO、验证步骤；不满足就阻止结束，让 AI 继续修。
SubagentStop	子智能体结束任务之前	子智能体质检	要求子 agent 交代看过哪些文件、改了哪些文件、证据、风险、未完成项和测试结果。
PreToolUse	调用工具前	防误操作保险丝	在 AI 真正执行命令或改文件前，拦截危险命令、敏感文件、越界访问和数据库操作。
PostToolUse	调用工具成功后	即时反馈系统	AI 改完代码后，自动格式化、跑 lint、typecheck 或相关测试。
PostToolUseFailure	调用工具失败后	失败修复提示器	工具失败后，把错误转成下一步修复方向，减少 AI 瞎猜。
PreCompact / PostCompact	上下文压缩前 / 后	防失忆系统	压缩上下文前后，保留或重新注入关键规则
PermissionRequest	请求权限前	安全放权系统	低风险操作自动通过，高风险操作继续人工确认

在这些关键节点，你都可以插入自己的逻辑——既可以直接执行命令，也可以给它提示词让它按你的逻辑跑，从而确保整个智能体的可控性。

除了列表里的节点，Claude Code 还提供了更多钩子选择。

5.2 实操：用自然语言创建一个 Hook

创建 Hook 非常简单，用自然语言跟 Claude Code 对话下达要求即可。示例提示词：

请帮我创建一个 Claude Code Stop hook。作用：Claude 准备结束前做交付验收。 规则：如果本轮改了代码、配置或文档，但没有说明测试、lint、typecheck、功能验证或 TODO 检查结果，就不允许结束，继续工作，并让 Claude 继续完成验证。 如果已经验证，允许结束。创建完成后，告诉我怎么用 /hooks 检查。

创建后如何查看：

点开左边栏文件树，找到 .claude 文件夹。

进入 settings.json（.claude/settings.json）。

可以看到自动创建的 Hook：

关键节点是 Stop（任务完成之前触发）；

类型是 command（会去跑下面的命令）；

命令内容就是按你的要求：看测试有没有跑、结果有没有通过、待办清单（to-do list）有没有完成；没完成就继续工作、做完验证再结束。

回到对话界面，它加完 Hook 后也会自己跑一遍规则。例如它会说「本轮无改动，仅文字回复未触碰任何文件，可以结束」——说明 Hook 已经生效，每次任务时都会检查：有代码改动就要跑验证，并检查所有待办清单是否完成。

💡 Hook 是「硬性规定」：不同于后面要讲的 CLAUDE.md（只是进入上下文的「软性规定」），Hook 会强制执行。

第六章：Skills 技能

6.1 Skills 是什么

Skills（技能） 其实很好理解：为了完成某一个特定任务（比如制作 PPT），把反复使用的提示词和正确的流程打包成 Claude Code 可以自动调用的「能力包」。

下次再做这类任务时，它会自动调用这个 Skill，或者你指定它用这个 Skill，就不用重复交代了——它会按照你给的流程和最佳实践来完成这一类特定工作。

Skills 本质上就是一个文件夹，里面最核心的是一个 Markdown 文件，叫 SKILL.md。它主要告诉 Claude：

这个能力什么时候用；

怎么用、按什么步骤做；

最后输出的格式是什么样。

如果流程里需要相关的资源、参考资料或代码脚本，可以一起打包进 Skills 文件夹，在 SKILL.md 走到相关步骤时调用它们。

6.2 拆解一个官方 Skill：pptx

Anthropic 官方有一个 Skills 仓库。

https://github.com/anthropics/skills

我们用其中的 pptx（生成、修改、阅读 PPT 的技能）来拆解。

请帮我在当前项目安装Anthropic官方skills仓库里的ppts skill

安装后，打开左边栏文件树，.claude 下会多出 skills 文件夹，里面有 pptx。继续打开会看到不同文件：

SKILL.md（最醒目）—— 总的指挥、总的指导；

其他 Markdown 文件（如 editing.md、pptxgen.md）；

scripts —— 代码脚本（如 Python 文件）。

SKILL.md 内容解读：

定义了名字：pptx；

description 说明什么时候调用：处理 .pptx / PPT 文件时（无论编辑还是阅读）都用这个 Skill；

Quick Reference（快速参考），尤其注意两条分流：

当你编辑或从模板创建 PPT 时 → 请阅读 editing.md；

当你从零创建 PPT 时 → 请阅读 pptxgen.md。

里面的内容可以按照自己的风格来修改，这样以后创建的ppt会更符合自己的需求。

editing.md：规定如何一步步修改现有 PPT。例如要复制 PPT、或从 layout 排版开始创建页面时，需要用到某个 Python 脚本（该脚本就在 scripts 下）。

所以整体协作关系是：

💡 你可以修改下载下来的 SKILL.md，改成自己想要的 PPT 风格，这样以后每次生成/修改 PPT 都按你的风格来。

打包在一起，你就有了一个能综合处理 PPT（新建、阅读、复制等），且包含最佳实践的 PPT 技能。

6.3 创建自己的 Skill

同样非常简单，回到 Claude Code 一句话就能创建。示例：

生成一个 Skill 叫 research-slides：用户给主题后，先去网上仔细搜寻，然后把搜寻来的信息整理，调用 pptx 技能来生成 PPT。

创建完成后查看文件树，skills 下除了官方的 pptx，还会多出新建的 research-slides。点开很简单，只有一个 SKILL.md，里面规定：给它一个主题，先在网上仔细搜索，然后调用 pptx 技能完成 PPT 生成。

测试：给它一个主题让它调研后生成ppt，它就会成功调用 research-slides 这个 Skill，等一会 PPT 就生成完了。

第七章：MCP Server 配置实操

7.1 MCP 是什么（一分钟理解）

MCP（Model Context Protocol）是一个开放标准，相当于给 AI 工具用的「USB-C 接口」——同一个插头，接任意设备。接上MCP Server 之后，Claude Code 就能：

直接读写你的 Notion笔记

查GitHub 的PR、提issue

查询数据库里的真实数据

收发Slack 消息

整个过程每一步依然需要你批准，它不会偷偷乱动东西。

7.2 安装方式：Claude Code 一行命令

在终端里，格式是：

几个常用例子：

安装后，在对话框里输入 /mcp 就能看到已连接的服务器和状态。

本地工具（跑在你电脑上的，不是云端API）用stdio 方式：

作用范围可以指定：

不加参数默认是 local（只有当前项目本地生效，不共享）。

7.3 值得最先安装的几个 MCP

MCP Server	能做什么	安装方式
GitHub	查 PR、提 issue、读代码仓库	claude mcp add --transport http github https://api.githubcopilot.com/mcp/ + token
Notion	读写 Notion 页面和数据库	claude mcp add --transport http notion https://mcp.notion.com/mcp
Sentry	直接从对话里查生产环境报错	claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

7.4 常用管理命令

7.5 安全注意事项

MCP Server 连上之后，它拥有真实访问权限，不是沙盒。三条必须记住：

第一，只安装你信任的 MCP。陌生来源的 MCP Server 有注入风险，接入了就能影响 Claude 的行为。

第二，权限给最小够用的。比如 Filesystem 只授权你需要的那一个文件夹，不要直接给整个主目录；GitHub token 只给需要的仓库权限，不要给管理员权限。

第三，不要关掉审批弹窗。每次操作前Claude Code 都会问你"要做这个吗"，这个弹窗是保险丝，别为了省事全部自动同意。

第八章：Plugins 插件

这三个概念它们正是插件的组成部分：

Skills：把固定的提示词、模板、流程打包成能力包，需要时自动调用；

Hooks：在关键节点（如调用工具前后、完成任务之前）插入你给的规则，比如结束前进行验收；

MCP Server：能让 Claude Code 连接到外部工具和数据源，获得调用外部工具、获取外部数据的能力。例如连接外部 App、连接邮箱、连接 Notion 获取信息并写笔记/写邮件；有些 MCP Server 本质上就是一些 API，专门获取外部数据。

8.1 Plugin = Skills + Hooks + MCP Server

把 Skills、Hooks、MCP Server 打包在一起，就是 Plugin（插件）。它相当于给 Claude Code 安装了一整套工作能力。

举例：一个「视频生成」插件里可能包含——

Skills：教 Claude Code 怎么写视频脚本和分镜；

Hooks：渲染前检查所有文件是否完整；

MCP Server：连接视频渲染工具。

8.2 管理插件

在 Claude Code 里输入斜杠命令：

命令长这样：

VS code里长这样：

会出现 plugin 里面的菜单，左右选择选项：

Installed：已安装的插件；

Discover/AVAILABLE：探索可安装的插件。

往下滑有非常多不同的插件。例如 frontend-design（让前端设计更好的插件）选择后就可以安装。

8.3 插件/技能装在哪里？

你可能会疑惑：比如 frontend-design 已安装，为什么项目的 .claude 文件夹下只有 skills，看不到插件？

原因：默认情况下，安装的 Skills 和插件会装到根目录的 .claude 文件夹下，而不是项目文件夹下。

根目录 ~/.claude：作用于所有项目——只要你用 Claude Code 工作都生效。

项目 .claude：可以显式让 Claude Code 装到项目文件夹下，这样只作用于当前项目。

第九章：Subagent 子智能体

9.1 概念

什么是 Agent（智能体）？ 简单说就是能替你做决定和执行任务的 AI 工具。

早期的 ChatGPT 等只能一问一答，无法完成工作，只能算「AI 聊天软件」。而现在的网页版 GPT、Claude Code、Codex 等都已经演化为能替我们工作的智能体。核心一句话：任何 AI 能真正替你完成工作、而不只是回答，就是智能体。

什么是 Subagent（子智能体）？ 子智能体也是智能体，它是主智能体（比如Claude Code）派出去的专门助手，用来完成某一类特定工作。它最重要的特点：

独立的上下文

独立的工具权限

这意味着主智能体把一个子任务交给它，它在独立上下文里完成，然后只把结果汇报给主智能体。整个过程中它的上下文、思考过程都不会进入主智能体，也就是不会污染主智能体的上下文。

这个特性也决定了：可以让多个子智能体并行完成工作，一个主对话智能体协调，多个子智能体分头干，最终把所有结果汇总。

9.2 创建方式

直接在 Claude Code 里对话，说「我要创建…这个子智能体，这是我的要求」。

9.3 实操：一步步创建子智能体

如果你已经使用过一段时间claudecode，它也会帮你准备好你常用的操作，可以直接创建。

也可以与它沟通清楚需求后再创建。

例如：

9.4 测试

给它一个任务。

可以看到它调用了Agent。

第十章：上下文管理

很多人用 Claude Code 一段时间后都会遇到同一个问题：聊到后面，它开始「记错」东西——之前说过的要求它忘了，明明存在的文件它说找不到，甚至前后矛盾。根源几乎都是上下文用尽或被污染。

上下文怎么看在前面3.3有讲到。

10.1 什么是上下文窗口

你可以把上下文窗口想象成 Claude 工作时的「工作桌面」——桌面有多大，它能同时看见多少东西。Claude Code 当前的上下文窗口是 200,000 token（约 15 万个汉字），听起来很多，但在实际工作中会比你预期消耗得快得多，因为它不只装你说的话，还装：

整段对话历史（每一条来回）

读入的文件内容

工具调用的输入和输出

CLAUDE.md、Skills、Hooks的内容

10.2 上下文满了会怎样

超出窗口后，Claude Code 会自动触发压缩（Compact），把之前的内容压缩成摘要继续。这个过程本身没问题，但压缩意味着细节丢失——如果你的任务对细节要求高，压缩后质量会明显下降。

还有一种更危险的情况：上下文没满，但被噪声污染了。比如中途跑偏的讨论、失败的尝试、大量不相关的文件，都会稀释有效信息，让后续回复质量悄悄变差。

10.3 核心策略

策略一：主动压缩，而非等它自动压缩

感觉对话变长、或者完成了一个阶段性任务后，主动输入：

它会把当前上下文压缩成精简摘要，继续工作。相比让它满了自动压缩，主动压缩时你可以附加一句指令，例如：

这样能保留你最在意的上下文。

策略二：大任务开新对话

完成一个独立任务后，直接开一个新对话（点加号）。别觉得浪费——新对话的上下文干净，不带上一个任务的"杂音"，往往比在旧对话里继续效果更好。

开新对话前，有个好习惯：让 Claude Code 帮你写一段"任务交接摘要"，作为新对话的开场白：

策略三：用子智能体隔离复杂任务

这是最被忽视但最有效的策略。前面讲过子智能体有「独立上下文」的特性——把耗上下文的工作（大量搜索、读大文件、代码分析）交给子智能体去做，主对话只收结果，上下文始终保持干净。

对比一下：

做法	上下文占用	适合场景
主对话直接做所有事	高，容易满	简单小任务
派给子智能体	主对话几乎不增加	搜索、分析、大文件处理

策略四：CLAUDE.md 精简，不要塞太多

CLAUDE.md 每次对话都会进入上下文。很多人喜欢往里面塞大量说明，结果每次都用掉大量 token加载它。保持 CLAUDE.md 在50 行以内，只写最关键的：技术栈、禁止事项、运行命令。细节放到对话里按需说。

策略五：用 /clear 彻底清空

如果对话已经完全乱掉，不如直接：

这会清空所有对话历史，从零开始。注意这会让它忘掉这次对话里所有内容，所以在清空前先保存好你需要的结论。

10.4 判断上下文状态的信号

状态栏里的ctx 百分比就是你的「桌面还剩多少空间」。几个经验值：

ctx占比	状态	建议
< 30%	健康	正常工作
30–60%	注意	可以完成当前任务，但别拖太长
> 60%	高风险	主动 /compact 或开新对话
系统自动压缩	已满	下个任务一定开新对话

第十一章：自动化任务（定时调度）

像上一章那种「搜索并交叉验证」的工作，我们每天都要干，总不能每天手动输入让它执行，太麻烦了。这时候就需要自动化任务。

11.1 用自然语言创建定时任务

示例：

帮我创建一个每天的定时任务：每天早上 8 点使用刚才的子智能体，搜索前一天的 热点新闻，并交叉验证信息源，写入表格。

它会创建好这个定时任务。可以让它触发一次看看效果，它会给你一个链接。

11.2 查看运行结果

点进链接会看到 Routines（自动化任务）界面：

当前是激活状态，每天 8 点跑一次；

显示它的提示词；

Runs 里能看到运行记录（例如你刚要求它跑的那一次）。

点进某次 run 查看效果：它把当天的 AI 新闻都收集起来，并验证了信息来源，没有核实的传闻都被排除掉了。

第十二章：.claude 文件夹与 CLAUDE.md

完成项目基本功能后，回到左边文件树，打开 .claude 文件夹。学完前面的功能，你大概能猜到它的作用了。

12.1 .claude 文件夹

.claude 就是管理和包含 Claude Code 所有扩展能力的文件夹，例如：

agents —— 你创建的子智能体（如搜索并交叉验证的那个）；

agent-memory —— 子智能体的所有记忆；

skills —— 所有技能（官方安装的做 PPT 技能、自己创建的调研生成 PPT 技能等）；

plugins —— 如果插件是项目级的，也会有这个文件夹；

settings.json —— 包含 Hooks 等配置。

一句话：.claude 告诉这个项目——有哪些技能、哪些插件、哪些子智能体可以用。

作用范围回顾：

项目 .claude：只作用于当前项目；

根目录 ~/.claude：作用于你用 Claude Code 的所有项目。

12.2 CLAUDE.md —— 项目说明书

最后一块重要拼图是 CLAUDE.md 文件。它是这个项目给 Claude Code 的说明书，通常写：

技术栈是什么；

怎么运行；

哪些功能不能做；

完成前要检查什么；

一些风格和偏好。

这样 Claude Code 接手项目时，就不需要每次扫描所有代码、每次都问你问题了。

12.3 用 /init 生成 CLAUDE.md

在 Claude Code 里输入：

它会自动扫描代码，帮你生成 CLAUDE.md（在项目根目录）。打开它，会看到各种信息：如何本地运行、架构、用的是哪个 API Key（如 DeepSeek）等。

12.4 软性规定 vs 硬性规定

CLAUDE.md 是「软性规定」：每次在这个项目里工作时，它都会进入上下文，但只是进入上下文而已，不像 Hooks 那样是硬性强制。正因为会进入上下文，所以越简短越好，不要长篇大论。你可以按喜好自己编辑 CLAUDE.md，也可以借鉴网络上其他开发者的写法。

总结：CLAUDE.md 告诉 Claude Code 这个项目的基本信息、该怎么做；.claude 文件夹告诉这个项目有哪些技能、插件、子智能体可以用。

第十三章：从零到上线——完整项目实战路径

前面各章都是单独的功能，这一章把它们串起来，给出一条从空文件夹到真正上线的完整路径。

这不是一篇手把手教程，而是路线图——每一步该问Claude Code 什么、该用什么功能，你照着走就能完成一个完整项目。

整体路径

第一步：让 Claude Code 帮你做需求梳理

在空文件夹里打开 Claude Code，先不要让它写代码，用Plan Mode 做规划：

收到计划后再开始。这步能避免做到一半发现方向错了。

第二步：用 /init 初始化项目说明书

骨架建好后立刻跑：

它会扫描刚生成的代码，自动生成 CLAUDE.md，记录项目结构、运行方式、技术栈。后续每次回来继续做，它都能快速回想起项目情况。

第三步：功能逐块来，不要一次要太多

每次只交代一个功能，交代清楚，做完验收，再做下一个：

功能越大，出错的地方越多，也越难回滚。拆小任务是效率最高的方式。

第四步：遇到 Bug，截图比描述有效

运行遇到问题，截一张浏览器或终端的错误截图，直接发给 Claude Code，比你用文字描述报错信息快得多准确得多。

第五步：用 Git 保存每个里程碑

每完成一个功能后：

这样如果后续某个改动搞坏了东西，可以随时回退。Claude Code 会执行 git 命令，你不用自己学。

第六步：部署上线

本地跑通之后，部署是最后一关。告诉 Claude Code 你要部署：

它会根据你的技术栈给建议。常见选择：

Vercel：前端和Next.js 项目首选，几乎零配置，免费额度够个人项目用

Railway：后端 + 数据库一起托管，操作简单，适合全栈项目

Render：类似 Railway，有免费层

Cloudflare Pages：纯静态网站

部署过程让Claude Code 一步步引导你，遇到报错贴给它看。

第七步：购买域名绑定

部署完后会有一个平台给的默认域名（如 your-app.vercel.app）。想要自己的域名：

国内常用阿里云或腾讯云买域名，海外常用 Namecheap 或 Cloudflare Registrar。域名便宜的大概几十块一年，绑定过程 Claude Code 会一步步告诉你怎么配DNS。

进阶方向

做完第一个项目之后，可以往这些方向深入：

让项目更完整：加用户系统（登录、注册、权限）、加支付（Stripe）、加数据分析仪表板。

让开发更高效：配GitHub Actions 让代码提交后自动测试、自动部署；用子智能体并行开发前端和后端；给 Claude Code 接入项目管理工具的MCP（如 Linear、Jira）让它直接从ticket 开始写代码。

做更复杂的产品：Claude Code 同样能帮你做 iOS/Android App（配合 React Native 或 Flutter）、浏览器插件、桌面应用、命令行工具。从同样的流程开始，把技术栈换一换就行。

第十四章：不懂编程，你也能用 Claude Code 做什么

很多人以为 Claude Code 是"程序员专属工具"，看到终端就觉得不是自己的东西。这个误解让大量非技术用户错过了它最实用的一半能力。

这一章专门为不写代码的人写。你不需要读懂任何代码，也不需要理解技术架构。你只需要能描述你想要的结果。

先说清楚一件事

Claude Code 本质上是能操作你电脑文件的 AI 工作伙伴。

普通网页版AI（如 ChatGPT、Claude.ai）的工作流是：你粘贴内容进去 → 它回答 → 你把答案复制出来 → 你再手动去做。

Claude Code 的工作流是：你说你要什么 → 它直接在你的电脑文件夹里帮你做完→ 成品文件已经在那里了。

这个区别，对非程序员其实意义更大。因为你不需要管中间那些技术步骤，只需要看结果。

场景一：文件和文档处理

这是最低门槛的起点，完全不需要任何配置。

把一个文件夹里的文档交给它处理：

这类任务，以前要一个文件一个文件手动打开处理，现在批量说一句话，它帮你全做了。

场景二：调研与内容创作

如果你写文章、做内容、做汇报，Claude Code 配合子智能体和网络搜索，可以当你的「研究助理」。

最后这个用法很关键：你不是让它替你写，而是让它给你提诊断，你自己改。文件在你电脑里，没有复制粘贴，整个过程在本地完成。

场景三：表格与数据整理

不懂 Excel 公式也不要紧：

场景四：接上外部工具之后（MCP的非编程用法）

装上 MCP 之后（上一章有安装方法），Claude Code 就不只是操作本地文件了，而是能直接操作你已经在用的工具。以下都是只用自然语言就能完成的真实工作流：

连接 Notion之后：

连接 GitHub 之后（不用你懂代码）：

连接 Google Analytics 之后：

连接 Apple Notes 之后：

这些工作流的共同特点：你描述目标，它操作工具，你看结果。整个过程不需要你登录任何平台、不需要复制粘贴、不需要切来切去。

场景五：创建个人自动化工作流

前面第十章讲了定时任务。对非程序员来说，这是最省力的一个功能。

你可以创建的自动化例子：

一次说清楚，之后它自己跑，你只看输出。

上手的正确姿势

第一条：描述结果，不用描述步骤。

你不需要告诉它"第一步打开文件，第二步读取内容，第三步……"，就像你跟一个真正的助手说话一样，直接说你要什么：「帮我把这50封邮件整理成一张联系人表」，它会自己想步骤。

第二条：把任务拆小，一次一件事。

「帮我把公司今年的事全整理好」太模糊，会出乱。「帮我把这份Q2报告里的数据提取成表格」清晰，能做好。任务越具体，结果越准确。

第三条：用 Plan Mode 先看计划。

做任何批量操作之前，先切到 Plan Mode，让它告诉你打算怎么做，确认没问题再执行。特别是会修改大量文件的任务，先看计划是好习惯。

第四条：失败了，截图发给它。

结果不对？出错了？截一张图或者把错误信息粘贴过来，它会自己修。不需要你懂哪里出了问题。

快速命令速查表

启动

命令	作用
claude	普通启动
claude --dangerously-skip-permissions	跳过所有权限确认（最高权限）启动

对话中最常用

命令 / 操作	作用
Shift + Tab	切换权限模式（Plan / Ask / Auto 循环切换）
Ctrl + O	展开 / 折叠当前思考和工具调用过程
Esc	中断 Claude 正在执行的任务
↑ 方向键	调出上一条输入

上下文管理

命令	作用
/compact	压缩对话上下文（附加说明保留什么）
/clear	完全清空对话，从头开始

项目与配置

命令	作用
/init	扫描当前项目，自动生成 CLAUDE.md
@ 文件名	把指定文件加入上下文
/mcp	查看已连接的 MCP 状态
/hooks	查看已设置的 Hooks

功能管理

命令	作用
/plugin	管理、安装插件
/agents	管理子智能体
/schedule	创建定时任务
/model	查看或切换当前使用的模型
/	查看所有可用指令