Claude Code基础教程：用管理的逻辑打开AI Agent

一、引言

Claude Code 大概是过去一年里最火、也最实用的 AI Agent，你多半已经刷到过它的名字。它最开始是给程序员写代码用的，但后来大家发现，写代码只是它的本事之一，整理资料、处理文档、做分析、跑日常重复的任务，它都能干，于是越来越多人拿它来做编程以外的工作。

Claude Code 是 Anthropic（也就是 Claude 背后的公司）推出的一款 AI Agent 产品，它和我们平时使用的聊天机器人（chatbot）不一样，差别不在长相，而在工作方式。chatbot是一问一答：材料你复制粘贴给它，它给个答案，你再把答案搬回去自己用——工作其实还是你自己在做。使用 Claude Code 时，你交代一个任务，它就会直接在你的电脑上动手干活：文件躺在哪个文件夹，它就自己打开来读、自己拆步骤、自己动手改、自己检查结果，不行就换个法子再来，直到把任务做完交给你。

从这个工作过程来看，Claude Code 确实有点像一个接受任务、执行工作并提交结果的“数字员工”。因此，本文尝试借用管理四职能（计划、组织、领导、控制）的框架，梳理 Claude Code 的常用功能和使用方法。

二、准备工作：让Claude Code上岗

1、Claude Code

Claude Code 有多个产品形态，终端版功能最强最新，本文以介绍终端版为主。

• 终端版（CLI）：功能最完整、更新较快，网上的大部分教程也以它为准。
• 桌面 App（Windows / macOS）：图形界面，点开就用，不想碰终端可以从它入门。
• 网页版（claude.ai/code）：在浏览器里用，任务跑在云端服务器而不是本地。
• IDE 插件（VS Code、JetBrains）：写代码的人用得多。
• 第三方集成：比如 Obsidian 的社区插件 Claudian。

终端可以简单理解成电脑自带的一个应用，是一个只能通过打字输入操作电脑的窗口：Windows 上右键点击开始菜单可以看到”终端”和”终端（管理员）“，一般选”终端”就行，如果没有也可以在开始菜单所有程序中去查找“终端”或“Windows Terminal”。macOS和Linux也都有自带终端，如果不怕折腾的话，第三方终端Ghostty体验更佳。

Windows用户打开终端，标签页大概率会显示“Windows PowerShell”或“PowerShell”，如果显示的是命令提示符，记得点击标签栏右边的向下按钮，选择“Windows PowerShell”或“PowerShell”。

2、安装

安装命令官方文档（https://code.claude.com/docs/zh-CN/overview）里有，我直接贴在下面。复制对应系统的那条，粘贴到终端按回车，就会自动安装。

• Windows（PowerShell）：

  irm https://claude.ai/install.ps1 | iex

• macOS / Linux：

  curl -fsSL https://claude.ai/install.sh | bash

以Windows为例

安装完成后，输入claude --version，如果输出类似2.1.177 (Claude Code)的内容，则表明安装成功，以后更新只需要在终端输入：claude update。

3、打开

使用 Claude Code 时，需要先进入准备处理的文件夹，再启动程序。第一次使用可以新建一个空文件夹进行练习，例如在 D 盘创建 claudefiles。建好后使用 cd 命令进入该文件夹，再输入 claude。

cd "D:\claudefiles"
claude

写路径容易出错，可以先输入 cd 加一个空格，然后把文件夹从资源管理器（macOS 上是访达）直接拖进终端窗口，路径就自动填上了。或者在资源管理器打开文件夹后，从其地址栏复制完整地址。

Claude Code 默认只能访问启动时所在文件夹中的内容，这个文件夹称为“工作目录”。这一限制可以避免它访问无关文件，因此启动前需要先进入准备处理的文件夹。

第一次打开时，会让我们先选择主题，一般直接使用默认主题即可；如果有个性化需求，可以通过上下键选择。

选完主题后回车，接下来需要选择登录方式。如果已经有 Claude 订阅账号，我们直接选择第一项“Claude account with subscription”；如果需要在 Claude Code 中使用 GLM、Kimi 这些国产模型，则需要退出终端后修改相关配置文件，具体请参考《[[Claude Code 如何切换使用国产大模型]]》。

选择登录方式后回车，按照提示完成登录，看到下面这个画面，就表示 Claude Code 已经可以使用了。

4、基础交互

打开Claude Code之后，可以看到两条横线中间的输入框，在输入框中输入想要说的话后回车，Claude Code就会开始工作了。

帮我写一篇 Claude Code 的入门教程，要求新手能看懂，存成《Claude Code入门教程.md》

然后看 Claude Code 工作：它会先说自己打算怎么做，到了要新建或编辑文件这一步，界面会弹出三个选项：①Yes（同意本次编辑文件）；②Yes，allow all edits during this session（shift+tab）（同意在本次会话中，它可以不用征询我们的同意，直接编辑工作目录中的文件）；③no（不同意）。目前我们先选①，关于②我们将在Claude Code的权限模式一节中具体说明。

选择同意后，Claude Code 会完成文件的新建和编辑。文件夹中会出现刚才要求生成的教程，随后它会总结已经完成的工作。 这里有个小细节需要说明：在这个示例中，Claude Code 自动调用了一个技能（Skill）。这个技能读取了较多的上下文文件，导致上下文窗口被占满，随后自动进行了一次上下文压缩。如果试用时出现相同提示，不必额外处理，后文的上下文一节会详细说明。

与所有AI Agent交流，实际上更推荐通过语音而不是打字。Claude Code 在聊天框里输入 /voice 回车后即可触发语音输入功能，但它目前不支持中文，好在靠谱的语音输入方式还有很多，比如电脑微信自带的语音输入功能（注意不是微信输入法），还有千问APP的语音输入，就是我目前用得比较多的。

5、常用操作

大多数时候，我们可以像与他人聊天一样，直接向 Claude Code 交代任务。除此之外，下面这些常用操作也能让沟通和操作更加方便。

@ 引用文件：通过@可以让我们精准地把某个文件发送给 Claude Code，减少它自己查找文件的时间和token消耗。在输入框输入@或者@Markdown之后，Claude Code会在下方弹出当前工作目录（工作目录是什么，后面讲”计划”时会专门说）的相关文件。

Esc的三种用法：①Claude Code 在工作过程当中，如果我们发现它跑偏了，可以按一下 Esc ，它马上就会停下来，然后我们就可以对它的工作进行纠偏；②在输入框输入一段话之后，又发现这段话说错了，想要全部清除，可以快速按两次 Esc，输入框的内容会被全部清空；③输入框没有任何内容的时候，如果快速按两次 Esc，就会进入回滚（rewind）模式，关于它我们具体到后面说明。

↑ 调出历史输入：按上方向键，能把之前输入过的话重新调出来，改一改再发，不用从头重打。

移动光标：终端里没法像普通编辑器那样用鼠标点着定位光标，好在键盘快捷键能顶上——Home 跳到行首、End 跳到行尾（笔记本上这两个键常和左右方向键挤在同一个键上，要按住 Fn 再按）；Ctrl+← / Ctrl+→（或 Alt+B / Alt+F）一次跳过一个词。

删除：这两招都以光标当前位置为起点——Ctrl+K 把光标右边的内容一路删到行尾，Ctrl+U 把光标左边的内容一路删到行首，比一个字一个字按退格快得多。万一删错了也不怕，Ctrl+Y 能把刚删掉的内容再粘回来。

复制粘贴：终端里复制粘贴大体和平时一样，选中文字后 Ctrl+C 复制、Ctrl+V 粘贴（macOS 用 Cmd+C / Cmd+V）。但有一点要留心：在终端里 Ctrl+C 还有“中断”的意思——什么都没选中时直接按 Ctrl+C，就会强行打断正在进行的工作，按两次Ctrl+C还会直接退出 Claude Code。此外，有些终端里 Ctrl+C / Ctrl+V可能不管用，这种时候可以尝试使用 Ctrl+Shift+C 复制、Ctrl+Shift+V 粘贴。

输入换行：在终端里按回车是直接发送，想要换行，最不会出错的方式是先敲一个 \ 再按回车，或者直接按 Ctrl+J。如果想用其他快捷键，则要看使用的具体终端，一般 Shift+Enter、Option/Alt+Enter、Ctrl+Enter 总有一种可行。如果这几种都不管用，可以让 Claude Code 查找原因并处理。

6、斜杠命令

Claude Code 还有一类专门用于控制程序本身的指令，叫作斜杠命令。在输入框中输入 /，系统会弹出命令列表；继续输入命令的前几个字母，可以缩小候选范围，再用上下键选择并按回车执行。命令不需要专门记忆，使用时从列表中查找即可。

另外，除内置的斜杠命令外，所有技能（Skill）包括自建的技能，也可以用斜杠命令触发，敲 /技能名 就能让它按那套流程工作（技能是什么、怎么做一个，后面有一节专门讲）。

以下是一些基础的命令，后面各章会结合具体场景，把其他常用的斜杠命令逐个讲到。

7、退出与恢复

可以直接关闭终端窗口退出 Claude Code，也可以输入 /exit 或 /quit 返回命令行。输入 /e 或 /q 后，从弹出的候选命令中选择相应选项即可。

以后想重新进入，照前面”打开”里说的方式来就好。不过需要注意的是，重新打开 Claude Code 会进入一个全新的对话，它不会自动记得上次聊到哪。好在每次对话都会被完整存下来，如果想接着上次的对话/任务继续，有三种方式。

前两种方式会用到启动参数。斜杠命令是在进入 Claude Code 后，通过聊天框输入的；启动参数则是在终端启动 Claude Code 时，写在 claude 后面的附加选项。两者的使用阶段不同。

1. claude --continue：在终端输入这一串来打开 Claude Code，它会直接续上最近一次对话，接着聊。
2. claude --resume：也是在终端输入，打开时会列出历史会话清单，用上下键挑一个回去继续。
3. /resume：进入 Claude Code 后输入该命令，可以调出历史会话列表并切换到指定会话，无需退出后重新启动。

到这一步，准备工作就齐了：Claude Code 已经装好、打开，我们也能向它安排任务，并掌握了斜杠命令、退出和恢复会话等基本操作，日常使用已经基本足够。如果还希望让 Claude Code 做出更有价值的工作成果，就需要进一步了解如何使用和管理它。下面将按照计划、组织、领导、控制展开介绍。这四章虽然依次排列，但内容相对独立，并没有严格的先后顺序。

三、计划：明确定位，制定计划

让 Claude Code 真正上手做事之前，通常需要明确几件事：让它处理哪些文件、完成什么工作，以及我们准备在多大程度上放手。简单来说，就是先确定它的职责和权限；落实到具体任务，还要把工作目标和计划交代清楚。

1、工作目录（working directory）

我们在前面介绍过，打开 Claude Code 之前，需要通过cd进入准备处理的文件夹，这个文件夹就是 Claude Code 的工作目录。

顾名思义，工作目录就是 Claude Code 工作的区域，你在哪个文件夹打开它，哪个文件夹就是它的工作目录，它对这个文件夹下面的内容有充分的访问权限，比如可以自由查看其中的数据文件；而工作目录外的文件则受限。

在 Claude Code 输入框下面，一般会显示当前的工作目录的文件夹路径，如果没有显示，你可以问一下 Claude Code 怎么显示当前工作目录。

Claude Code 可以直接读取工作目录内的文件；访问工作目录外的文件时，则需要另行获得我们的授权。

/add-dir添加文件夹：如果你当前的工作需要跨多个文件夹，比如工作文件在 A 文件夹，参考素材在 B 文件夹，可以通过/add-dir B文件夹的路径的命令，把文件夹 B 也加入到 Claude Code 的工作目录。添加后，Claude Code 可以直接访问两个文件夹中的内容。

/cd切换工作目录：如果你不想”再加一个文件夹目录”，而是想直接整个切换到另一个文件夹去做事，那就用 /cd 新文件夹路径，这样 Claude Code 就会把新的文件夹作为自己的工作目录，原来那个文件夹就属于工作目录外了。

工作目录内容的文件，除了查看权限有差别外，新建、删除、编辑文件的权限在不同权限模式下也有差别，具体我们在讲 Claude Code 的权限模式时，会专门说明。但整体而言，Claude Code 在工作目录内，拥有更大的“自作主张”的空间。

2、权限模式

地盘划好了，接下来可能面临到一个问题：你打算信 Claude Code 到什么程度？是当一个需要你盯着的新人，还是一个能独当一面的老手？这个信任程度对应一个具体设定——权限模式。它决定 Claude Code 执行不同操作时，哪些事要先问你、哪些可以直接干。

首先需要明确的是：读取工作目录内的文件，在任何权限模式下都不需要再向你申请。权限模式调节的是 Claude Code“动手”的尺度——改文件、跑命令、以及碰工作目录外的东西。常用的权限模式有这么几种：

1. 普通模式（default，默认）——每一次文件编辑和命令执行都要你过目：读取照常免确认，但凡有风险的动作（改文件、跑命令）都会弹出提示，经你同意才会执行。这种方式最稳妥，适合刚上手或处理重要资料。
2. 接受编辑模式（acceptEdits）——工作目录内的文件改动直接执行，不再需要你的逐次确认：相比普通模式主要放宽了工作目录内文件的增删改和移动复制等文件操作，但联网、其他命令、以及工作目录外的文件仍需手动确认。适合你已熟悉它的做法、对文件改动放心之后。前面”基础交互”里弹出的选项②”allow all edits during this session”，选中则当前会话自动进入接受编辑模式。
3. 自动模式（auto）——独当一面：几乎所有操作都不再逐次确认。工作目录内的文件操作正常放行，工作目录外的动作以及联网、运行命令则交由一个独立的审查模型逐一把关，一旦越界（如批量删除文件、向外发送数据）即拦截——相当于放权的同时仍设一道合规防线。需要 Sonnet 及以上的模型才能打开自动模式。
4. 计划模式（plan）——只出方案、不动手：你交代任务后，Claude Code 只读文件、只分析，然后给你一份“打算怎么干”的方案，具体见3.3计划模式这一节。

前三种模式是按“放手多少”从紧到松排的：从每步都问，到放开改文件，再到几乎全放手。第四种计划模式有点不一样：它的权限与普通模式完全相同（改文件、跑命令都要征求你的同意），差别只在于系统提示词叮嘱模型只出方案、不要动手。虽然 Claude Code 把计划模式作为一种权限模式，但我更愿意把它当成一种工作方式来看。

通过 Shift+Tab 可以在这几种模式之间循环切换：默认→acceptEdits→plan mode→auto mode（轻量模型如 Haiku不支持自动模式）。除默认模式外，其他权限模式下，输入框下方的状态栏都会显示当前模式名称。

此外，还有两种特殊的权限模式。一种是 bypassPermissions，也就是“啥也不问、啥也不管，全权授予 Claude Code 干到底”（俗称 yolo 模式）。在这种模式下，Claude Code 会跳过所有权限确认，工作目录的边界也不再生效，可以直接读写电脑上的其他文件。因此，官方建议只在虚拟机等隔离环境中使用。另一种是 dontAsk，只允许执行白名单中预先批准的操作，其他操作均会被拒绝，主要用于自动化脚本。

把上面几种模式对着”工作目录内/外”这条边界排一排，就是这张表：

刚开始使用普通模式就好，感觉 Claude Code 比较靠谱之后，就可以使用接受编辑的模式；如果对它的信任度进一步提升，可以使用自动模式。但不管选择什么模式，最后的结果都要自己负责，Claude Code 不会对它自己的错误负责，虽然它会“真诚”地道歉。

3、计划模式（plan mode）

我们向其他人或者 Claude Code 交办一个工作任务时，一般会有三种不同的情形。

目标和执行方式都很清楚，且任务并不复杂。 可以直接告诉 Claude Code 具体要求，让它按照你的方案执行。例如：“把这个文件夹里的十份材料，每份总结成两百字以内的要点，汇总存成一个新文件。”你已经清楚预期结果和处理方式，只需将这些要求完整地告诉它。

方向和目标很清楚，但任务涉及多个步骤。 如果只提供目标就让 Claude Code 直接执行，它可能会按照自己的理解安排步骤，最终结果与预期不一致。可以先让它制定执行计划，确认计划没有问题后再开始操作。

自己还没有想清楚，只有一个大致方向。 这种情况下，可以用采访式提问来澄清想法，例如告诉它：“在制定计划前，请逐一询问需要明确的问题。”Claude Code 会拆解任务并提出问题，我们在回答过程中逐步明确目标。也可以先让它提出几种可行方案及各自的利弊，再据此确定具体做法。

后两种情况都是”先谋后动”——都适合使用 3.2 介绍的计划模式（plan mode）。在计划模式下与 Claude Code 进行沟通，最终会生成一个plan（计划）供你审核。 我们选择上图中的第一项之后，Claude Code 会自动进入自动模式，然后开始执行计划；如果选择第二项，就正常进入默认模式。

此外，我们也可以在最下面一行的那个路径下面直接找到这个计划的MD文档，然后对它进行修改和编辑。我们还可以使用/plan在终端中重新打开这个计划进行查看，或者输入/plan open通过系统默认的Markdown编辑器（如记事本、VS Code）打开这个计划文档。

4、任务清单（task list）

交给 Claude Code 一个稍复杂的任务时，界面下方有时会自动出现一组带勾选框的列表，这就是 任务清单（task list）。任务清单通常由它主动创建，不需要我们手动操作。我们也可以主动要求它先拆解任务、列出清单，再开始执行。

按 Ctrl+T 可以随时隐藏或显示任务清单，面板默认最多同时显示 5 条。任务清单主要有两个作用：一是帮助我们检查 Claude Code 是否准确理解了任务，通过查看拆分后的步骤，可以及早发现与预期不一致的地方；二是帮助我们跟踪执行过程，发现某一步存在问题时，可以按 Esc 暂停并进行纠正。

5、目标（Goal）

输入 /goal 并设置终止条件后，Claude Code 会持续执行任务，并在每轮结束时判断条件是否已经满足；满足后便停止执行。

目前来看，这个功能在编程场景中更容易发挥作用，因为是否满足条件通常可以通过测试、编译结果或报错信息自动判断。非编程任务也可以设置终止条件，但这些条件通常缺少类似的客观验证标准，Claude Code 容易过早判断任务已经完成。

四、组织：配置资源，安排任务

为了更好地完成你的任务，你需要思考如何更好地组织和协调各种资源，包括基础的大模型和其他外部扩展资源，比如MCP、脚本、CLI工具等等，同时让这些资源按照更有效率的方式配合 Claude Code 完成任务，比如主代理调用子代理、多个代理独立工作等等；有的时候你也需要远程监督 Claude Code 工作，有的时候你只想放开双手让它自己工作，这就涉及到远程办公和定时任务。

1、模型（model）

Claude Code 背后的模型是可以换的，输入 /model 就能切。模型更新得很快，具体名单以你列表里看到的为准，写这篇的时候，从强到弱是这么四档：

• Fable——最新的旗舰，2026 年 6 月刚发布，能力全面超过 Opus，而且任务越长、越复杂，领先得越多。不过写这篇文章期间，它已经被禁用了。
• Opus：上一代旗舰模型，能力较强，但速度较慢、费用较高，适合复杂分析或梳理结构混乱的长篇材料。
• Sonnet——性价比最高，日常主力。绝大多数改写、分析和问答任务用它就够。
• Haiku——最快最省，适合简单任务（比如批量改个格式、问个小问题）。

Anthropic 给模型起名还有点文艺范：Haiku 是俳句，日本的三行短诗，最小巧轻快；Sonnet 是十四行诗，篇幅适中、讲究格律；Opus 是拉丁语的”作品”，古典音乐里专指编了号的大部头；Fable 是寓言，源自拉丁语 fabula，“被讲述的事”；Fable 还有个同源的兄弟 Mythos（神话）——基于同一底层架构，Fable 是加了安全限制的通用版，Mythos 是解除了部分安全限制的专业版，只向受审核的机构开放。

除 Haiku 模型外，其他所有模型还有个配套设定——思考深度（effort），控制它做事时对每一步思考得有多深：思考越深，答得越周全，但也越慢、越费额度。effort档位从低到高分别是 low → medium → high（默认） → xhigh → max。一般刚进入 Claude Code 的时候，右下角会显示 effort，但是过段时间就会自动消失。

此外，模型在思考过程中，也会出现类似”thinking with high effort”这类提示。

如果需要调整 effort，可以在 /model 选模型的界面里，按左右方向键顺手调整。 或者直接输入 /effort，会弹出一个调节滑块，按左右方向键调整。也可以直接输入 /effort low 这类指令直接设定。

一般来说，日常用默认的 high 就可以，如果任务确实简单，你也觉得它想得太多、有点磨蹭，可以适当降低思考深度；碰到难啃的硬骨头，可以临时上调到 xhigh 甚至 max。注意 max 不限思考开销、只对当前会话生效，而且官方自己都提醒它容易”想过头”，偶尔用用就好。

不想动设置的话，在交代任务的时候，带上 ultrathink 这个词，它这一轮就会想得格外深，下一轮自动恢复原样。

2、插件（Plugins）

插件一般是指给一个软件（比如我们这里的 Claude Code）额外安装的“小功能模块”，避免在修改主程序代码的情况下扩展软件功能。在 Claude Code 的场景下，大概也是这样。我们装上一个插件，Claude Code 就多了这个插件的相关功能，这些功能通常包含以下四类的其中一种或多种：技能Skill、模型上下文协议MCP、子代理subagent、钩子hooks等。这几种功能我们后面将会陆续介绍到。

下面我们拿三个比较推荐的插件做安装示范：

• skill-creator：一个“用来造技能的技能”，就在 Claude Code 出厂自带的官方市场里。这个技能强烈建议要安装。
• document-skills：能处理 Word、Excel、PowerPoint、PDF 这些 Office 文件，来自 Anthropic 的另一个市场——它不是自带的，得自己加进来。
• obsidian：Obsidian CEO 维护的技能包，来自一个第三方市场。

第一步：添加市场。 插件都放在一个个“市场”里，市场就是别人整理好的一份插件清单。装插件前先看它在哪个市场：在 Claude Code 出厂自带的官方市场里（skill-creator 就是），这步直接跳过；只要不在自带市场里——无论是 Anthropic 自家的另一个市场，还是别人的第三方市场——都得先把市场地址加进来。

加地址有两种方式，效果一样。一种是直接敲命令，/plugin marketplace add 后面跟上“作者/仓库名”这串地址：

/plugin marketplace add anthropics/skills        # document-skills 在这个市场
/plugin marketplace add kepano/obsidian-skills   # obsidian 在这个市场

另一种是输入 /plugin 打开插件管理面板：Discover 发掘已经添加的市场里面的插件、Installed 管理已经安装的插件，Marketplaces 添加/删除市场、Errors 看报错。

我们按 Tab 或左右键切换到 Marketplaces 标签页。蓝色表示我们已经选中了它，选中之后可以按回车，就能进入添加市场的界面。（PS：当前截图中，最下面一个是官方自带的市场，baoyu-skills是已经添加的第三方市场）

进入添加市场界面后，我们在最下面粘贴上我们要添加的市场地址。

回车后提示正在从仓库下载插件（PS：下图换了Obsidian做示例）。

最后成功后就会弹到Discover界面，显示刚刚添加的这个市场里包含的插件了。

第二步：安装插件。 安装插件的命令是 /plugin install 插件名@市场名，但是一般还是通过插件管理器界面进行安装更为方便：输入 /plugin 进入面板，在 Discover 标签页，我们可以看到所有已经添加的市场的所有插件清单，我们可以在搜索框当中进行搜索后通过上下方向键进行选择。

选中我们要安装的插件后回车，就会进入到插件安装界面。

安装时需要我们选择安装在哪一层：①user scope，用户区域，也就是在本机的所有文件夹都能使用这个插件；②project scope，项目区域，也就是以后只能在当前这个文件夹（工作目录）使用这个插件，如果使用了git同步就会同步这些插件；③local scope，同样只能在当前的这个文件夹（工作目录）使用，即便使用了git同步也不会同步这些插件。

一般通用的插件，比如skill creator，选择user就可以了，但是像obsidian这种插件，如果只有一个笔记仓库，就可以在这个笔记仓库安装这个插件并选project。安装完成后在Installed可以看到已安装的插件。

第三步：让它生效。 输入 /reload-plugins，不用重启，三个插件就都能用了。

需要注意的是：插件里有可能存在恶意skill或代码脚本，所以需要优先选官方市场、知名作者、或者能够查看源码的插件，如果不太确定，至少要问问Claude Code。

3、模型上下文协议（MCP）

前面一直在讲 Claude Code 怎么处理你电脑里的文件，但需要使用的内容未必都在这台电脑里，可能存放在 Notion 或其他在线服务中。MCP（全称”模型上下文协议”）就是来打通这一层的：按官方说法，它是一套开放标准，能让 Claude Code 连上电脑之外的几百种网络服务和工具。

什么时候用得上，有个很好认的信号：只要你发现自己在某个软件和 Claude Code 之间反复复制粘贴——比如把 Notion 里的内容拷给它、再把结果拷回去——那就该看看它有没有 MCP。有的话接上，Claude Code 就能直接读写其中的内容，不用你来回搬运了。不过不是每个软件都有 MCP，得服务方自己提供才行——Notion、GitHub 这类常用的就有。说白了，接一个 MCP，就相当于给 Claude Code 添了一件可以直接调用的外部工具。

接 MCP 最省事的方式就是装插件——装法和 4.2 一样，因为官方市场里不少插件本身就捆绑了 MCP。就拿 Notion 插件来说，它一个插件里同时塞了技能、MCP 和一组斜杠命令（正好印证 4.2 说的”一个插件常含好几样东西”），装上它，连 Notion 的那套 MCP 就一起配好了。它就在 Claude Code 自带的官方市场里，不用先加市场，照下面四步走：

第一步：装插件。 输入 /plugin 打开面板，切到 Discover 标签页，在搜索框里输入 notion，选中 Notion 插件回车；进入安装界面后选一个安装范围（只在这个笔记库用就选 project，想所有项目都能用就选 user），确认安装。

第二步：让它生效。 输入 /reload-plugins，或者干脆重启一次 Claude Code——这样它带的 MCP 才会正常启动。

第三步：授权，连上你自己的 Notion。 插件带的 MCP 第一次用要先授权（向 Notion 证明这是你本人）：输入 /mcp，选中 notion 回车，再选 Authenticate，浏览器会自动打开（如果没有自动打开就复制界面给的链接），登录你的 Notion、点同意。

回到 Claude Code，看到 notion 的状态变成 connected，表明MCP进入可用状态了。

第四步：用起来。 直接使唤 Claude Code 就行，比如”搜一下我 Notion 里关于 XX 的笔记”，或者用插件带的斜杠命令，比如 /notion-search。

说个题外话，我在授权这个步骤的时候碰到了一些问题，试了几次一直失败，然后我直接向 Claude Code 求助，最终在它的指导下才完成了授权。这也是它相对于普通软件工具的一个方便之处。

4、子代理（Subagent）

子代理（Subagent） 是由主代理调用、专门处理某类任务的独立代理。它可以在单独的上下文中翻阅大量文件、查找资料，完成后只把结论返回给主代理。这样可以避免中间过程占用主对话的上下文，影响后续任务的处理效果（具体原因见 5.2）。

多数时候我们都不用管它——子代理基本是主代理自动调用的。Claude Code 内置了几个，比如 claude-code-guide：它专门回答”Claude Code 怎么用”这类问题——某个功能在哪、某条命令干嘛的、某个报错怎么办。当我们询问 Claude Code 的使用方法时，主代理有时会调用这个子代理进行研究，子代理把答案反馈给主代理后，主代理再来回复我们。

如果我们觉得有必要，可以自建一个子代理：输入 /agents，在”Library”页签里新建，创建时还需要选择存放位置：选”个人”则所有项目都能使用，选”项目”则只在当前仓库生效——和 4.2 装插件的 User / Project 是同一套逻辑。

写一句职责描述，比如”校对中文文档里的错别字和标点”，Claude Code 会帮你生成一个完整的子代理。

实际上我觉得子Agent的作用暂时没有那么明显，但是了解有这么个东西的好处在于，当需要它的场景出现时，我们知道我们有一个工具可以用来处理这类事情。

5、代理视图（Agent View）

想同时处理几件不相关的事，例如一边整理资料、一边起草文章，最直接的办法是打开几个终端标签页，每个标签页运行一个 Claude Code 会话，需要查看哪项任务时再切换过去。

代理视图（Agent View）是另一种开多任务的方式：不用你在一堆标签页之间切来切去，它把所有并行的会话收进一块调度台，一屏列出每个后台会话的进展，关掉这个界面、甚至关掉终端这些会话都照样继续。和开标签页比，Agent View 的不同主要在两点：一屏统管和后台托管；至于用不用、顺不顺手，看每个人自己的习惯。

代理视图（Agent View） 打开方式有两种，一种是在进入 Claude Code 的时候直接输入 claude agents；另一种是在已经进入 Claude Code 对话后、输入框清空的情况下按两次 ←（左方向键），当前会话就会挂到后台，然后Agent View 随即打开。

从上图可以看到，每一个正在运行的 Claude Code 会话占一行，按状态分成三组——等你回复的、正在工作的、已完成的；每行右侧还有一句自动生成的摘要，告诉你这个会话当前在做什么，不用一个个进去查。

选中会话：选中其中一行（一个会话），按空格键可弹出速览面板——看最新进展或者它卡在哪；大多数时候在面板里直接回复就够了，根本不用进去。按回车键或 → 才是真正进入该会话的完整内容。

退出代理视图：需要注意的是，在代理视图下 Esc不是返回上一次的会话，而是把 Agent View 关掉，直接退回终端命令行，好在那些后台会话不受影响、照样在跑，下次 claude agents 还能找回来。

新建Agent会话：在界面底部的输入框打一句话、回车，就开一个新的后台会话去干这件事；再打一句，再开一个——想同时跑几件事，就发几条。这些后台会话独立运行，关掉 Agent View 界面、甚至关掉那个终端窗口，它们照样在跑，你可以去做别的，回来再看进展。

/bg：把Agent挂后台的另一种方式。在打开的对话里输入 /bg，Claude Code 会把当前会话转成后台会话。但是和按两次 ← 有一个差别：按两次← 是”挂后台 + 并打开代理视图”两件事一起干，/bg 只管挂后台，不打开代理视图。所以一个前台会话在输入 /bg 之后会直接退回到终端命令行，而不会自动弹出代理视图，想看到代理视图，需要重新输入claude agents 才行。当然，如果当前对话本来已经在后台了，那输入 /bg 的效果就和按 ← 一样——回到代理视图。

代理视图也是一个新功能，目前也在预览阶段，使用效果是不是一定比多开几个标签页更好，目前还不好判断，如果觉得这一块不太好理解的，也可以先跳过。

6、远程办公（Remote Control）

任务在家里电脑上跑着，人却要出门，有两种方式让我们不掉线。

遥控（Remote Control）：在Claude Code的输入框中输入 /rc 回车，这轮对话就可以在手机Claude APP上查看和管理了：任务仍然在你电脑上跑，本地文件和配好的 MCP 全都原样可用，手机只是个”遥控器”。代价也明摆着：电脑得开着、这个会话不能关闭。

还有一条路：接进聊天软件。 官方插件市场里有 Telegram、Discord这类插件，装上之后 Claude Code 就可以成为你聊天列表里的一个联系人，发消息派任务、回消息收结果。这个配置起来比遥控还是麻烦一些（要在 Telegram 里领个机器人、做一次配对），这里就不展开了。

7、定时任务（schedule）

Claude Code 支持两种定时任务。

一种是会话内的定时器：不需要任何命令，用自然语言说清楚时间和事情就行——比如”10分钟后进入步骤2”，到点自动执行。这档的限制也明显：终端窗口得开着，关了就停，适合短期的提醒和盯梢。

另一种是云端定时任务，用 /schedule 配置好，到点了在 Anthropic 的云端自动克隆你的仓库、照指令办事、改动放到单独分支等你审核，全程无弹窗、完全自动化。前提是文件库得托管在 GitHub 上，因为云端任务无法访问本机文件。这个功能在编程场景里更容易形成自动化闭环，这里不再展开。

五、领导：洞察“AI性”，高效沟通

人们常说，管理要懂人性，那管 Claude Code，也要懂“AI性”。对于它的一些基础知识，我们还是需要有所了解，才能更好地与它沟通，让它更高效地输出更高质量的工作成果。

1、Claude Code（AI Agent）

这其中最重要的一个知识点，就是驱动 Claude Code 的底层大模型其实是无状态的，也就是说它没有任何记忆，每一次对话对模型来说都是一次全新的开始。模型只做一件事：接收一个输入，给出一个输出，然后这次调用就结束了。

换句话说，每一次大模型想要输出点什么，唯一可以参考和依赖的，就是这次发送给它的所有信息，这些信息就叫做上下文（Context）。

这个听起来有点奇怪，在使用AI聊天机器人的时候，我们的对话明明能够一轮一轮持续下去，它也好像记得之前聊过的内容。但事实上，AI聊天机器人不是大模型本身，而是以大模型为基础包装起来的AI产品。在持续对话时，这个产品每次都会把当前输入和此前的历史聊天记录一起发送给大模型。因此，并不是大模型记住了我们的历史对话，而是AI厂商在每次调用时重新把这些历史记录发给了它。

Claude Code 的逻辑也是一样的。它在每次调用模型之前，会把需要的信息都打好包发给大模型，包括但不限于系统提示词、可用系统工具、可用 Skill、长期记忆、历史对话、外部检索结果、工具执行结果等等。上下文组装的结果，就是让 Claude Code 看起来有了记忆，能够”记住”用户的偏好、延续完成一个复杂的任务。

随着工作任务的推进、双方持续交流纠偏，Claude Code 还会不断查看文件、调用工具，工具也会返回新的信息。这些内容不断累积，很容易就达到一个很高的量级。

但是大模型的上下文窗口是有限的，也就是说发送给它的输入内容存在篇幅限制。目前主流大模型的上下文窗口普遍已达到 1M token，比如 GPT-5.5、DeepSeek、Gemini 和 Claude；超过了这个限制，发给模型的请求会直接报错，无法得到回应。

而在应用层面，各家厂商一般会提前介入——ChatGPT 这类聊天机器人通常直接截去最早的那段对话，Claude Code 则是把前面的内容压缩成摘要；两者都有信息损失，区别在于直接丢弃还是有损压缩。

即便不超过这个限制，一旦上下文信息积累过多，模型输出质量也会大幅下降。这也就意味着，Claude Code 的上下文信息如果组织得好，大模型就更容易抓住重点；如果组织得不好，上下文混乱，模型就更容易跑偏，最终的结果也会跟着偏。所以，对于同一个模型来说，如何在模型有限的上下文窗口当中，塞入足够多的有用信息，就成为使用 Claude Code 水平高低的一个重要因素。

2、上下文（context）

前面说过，上下文窗口是有限的。当当前会话的上下文接近模型的上下文窗口上限时，Claude Code 会自动把前面聊过的内容压缩成一段摘要来腾地方，而压缩是有损的，一些细节会在这个过程里悄悄丢掉。如果可以，最好不要等到系统自动压缩，因为它触发压缩的时机，不一定是我们想要的。

所以我们需要主动关注当前会话的上下文情况，然后自主选择是清除所有上下文，还是压缩上下文。

/context——查看上下文占用。 输入后会显示一张可视化的占用图，谁占了多少、还剩多少，一目了然。看这张图你还会发现一件容易忽略的事：脑容量不是只被聊天占用——你装的插件、连的 MCP（4.3 说”用不上的别囤”，根子就在这里）、给它写的工作手册（5.3），开场就先占去一块；它工作时读过的每个文件，也都记在这本账上。什么时候该看？感觉它开始迟钝的时候、要开一个大任务之前，都值得先看一眼；真到快满，界面上也会自己冒提示——2.4 里那次自动压缩，你已经见过一回。

/clear——清空当前对话。 处理完一个任务、准备换一件不相关的事时，可以使用 /clear。它只会清除当前的聊天记录；手册、记忆和技能不会被删除，开始新对话后仍会按需载入。

/compact——压缩已有对话。 任务干到一半不能清，又眼看要满，用/compact 把前面的对话浓缩成摘要、腾出上下文空间继续工作。主动压缩比自动压缩更可控，一个是你可以掌握压缩的时机，一个是手动压缩可以带一句指示，比如 /compact 保留文件清单和已确认的结论，把你最怕丢的细节点名保下来。

/btw——中途岔开问一句。 正忙着，突然想问个不相干的问题（“对了，某某命令是干嘛的？”），直接问会在当前上下文中多出一段杂音；用 /btw 你的问题，它答完就回到原任务，做任务的上下文不受影响。

3、CLAUDE.md

①CLAUDE.md 是什么

CLAUDE.md 是一个会被 Claude Code 自动读取，并作为上下文发送给大模型的 Markdown 文件。每次开始新的对话，Claude Code 都会重新读取相应的 CLAUDE.md。因此，写在里面的信息不需要在每场对话中重新交代。

这也是理解 CLAUDE.md 最重要的一点。大模型本身不知道用户是谁，不知道当前文件夹是做什么的，也不知道这个项目有哪些特殊规则。Claude Code 读取文件之后，这些内容会和用户当前提出的任务一起进入上下文，大模型才能据此开展工作。

它不是聊天记录，也不是 Claude Code 自己形成的长期记忆，而是我们主动编写并维护的一组长期上下文。5.2 说过，对话经过压缩后可能丢失早期细节；CLAUDE.md 的内容会重新载入，因此适合存放每次工作都需要知道的信息。Claude Code 自动积累的信息属于下一节介绍的 Auto Memory，两者不要混在一起。

②放在哪里，写什么

Claude Code 会根据文件所在的位置，决定其中的内容在哪些范围内生效：

• 全局文件 ~/.claude/CLAUDE.md：适合存放对所有项目都有效的个人要求，比如使用中文、回答方式以及修改文件前是否需要确认。
• 项目共享文件：可以放在项目根目录的 CLAUDE.md，也可以放在 .claude/CLAUDE.md。适合存放项目结构、文件规范、常用命令和协作规则，并且可以随项目一起分享。
• 项目私有文件 CLAUDE.local.md：适合存放只对自己有效、不准备提交给其他人的项目要求，通常会被加入 .gitignore。
• 子目录文件：大型项目可以在子目录中继续放置 CLAUDE.md，其中的内容只在 Claude Code 处理该目录时加载。

选择写什么时，可以用一个标准判断：模型无法仅靠查看现有文件得知，但每次工作时又需要知道的信息，才值得写进去。

例如，我会在笔记库的项目文件中说明四类笔记分别放在哪里、frontmatter 包含哪些字段、回答知识库问题时按什么顺序检索，以及任何文件修改都必须先征得同意。这些要求不会随着具体任务改变，又很难只靠查看几个文件完整推断出来，适合长期保留。

反过来，文件中已经清楚呈现的内容不必再重复描述；只对当前任务有效的要求，也不必写入 CLAUDE.md。内容过多不仅会淹没真正重要的规则，还会在每次对话中持续占用上下文。

③如何创建和维护

不知道从哪里开始，可以输入 /init。Claude Code 会分析项目结构和已有配置，起草一份 CLAUDE.md；如果文件已经存在，它会根据现有内容提出改进建议，而不是直接覆盖。自动生成的只是初稿，仍然需要根据自己的真实工作方式删改。

CLAUDE.md 不需要一次写完。先记录少量确定会反复使用的要求，实际使用中发现某类错误重复出现，或者某项规则必须每次遵守，再把它补进去。判断一条内容是否值得加入，可以继续问两个问题：模型能不能从现有文件中直接看出来？这条要求是不是今后的任务仍然需要？

文件也不宜无限增长。官方建议单份 CLAUDE.md 尽量控制在 200 行以内。内容变多以后，可以把不同主题的规则拆到 .claude/rules/；一套包含多个步骤、需要反复执行的工作方法，则更适合做成 Skill。

如果同时使用 Claude Code、Codex、Gemini CLI 等多个 Agent，可以把共用内容放在 AGENTS.md，再通过 @AGENTS.md 导入 CLAUDE.md。也可以将 CLAUDE.md 做成指向 AGENTS.md 的软链接。

日常维护时，可以直接让 Claude Code 修改 CLAUDE.md，也可以输入 /memory 查看当前加载了哪些文件并打开编辑。

4、自动记忆（Auto Memory）

除了我们主动维护的 CLAUDE.md，Claude Code 还有一套自动记忆。在工作过程中，它会判断哪些信息可能对以后的任务有用，并把这些内容记录下来，例如我们反复纠正的偏好、项目的常用命令、调试经验和工作习惯。以后处理同一个项目时，这些记忆会作为上下文重新提供给模型。

Claude Code 不会把每次对话中的所有内容都保存下来，也不能保证我们说过一句“以后这样做”，它就一定形成记忆。保存什么由 Claude Code 判断，因此 Auto Memory 更适合积累工作中逐渐发现的经验，不能替代明确的项目规则。

这也是 Auto Memory 与 CLAUDE.md 最重要的区别：希望 Claude Code 每次都知道并尽量遵守的要求，应当由我们写入 CLAUDE.md；它在实际工作中发现的经验和偏好，可以交给 Auto Memory 积累。 两者都会作为上下文发送给模型，都不是强制执行的系统设置。

输入 /memory，可以查看当前会话加载了哪些 CLAUDE.md 和规则文件，打开 Auto Memory 的存储目录，以及开启或关闭自动记忆。记忆内容都是普通的 Markdown 文件，可以查看、修改或删除。发现 Claude 记错了，或者已经不再适用，直接清理即可。

5、技能（Skills）

①Skill 是什么

技能（Skills） 是为某一类任务准备的一套可重复调用的说明。它可以写明应该经过哪些步骤、依据什么标准判断、最后交付什么结果，也可以附带参考资料、模板、示例和脚本。Claude Code 遇到相关任务时可以自动调用，我们也可以输入 /技能名 直接调用。

Skill 的价值不只是少写几遍提示词，而是把完成一类工作的有效方法沉淀下来，让 Claude Code 不再完全依赖临场发挥。比如“整理闪念笔记”真正执行时，需要读取笔记、判断类型、查找匹配的永久笔记、调整描述、修改文件并检查结果。把这些要求写成 Skill，以后处理同类任务时就不容易漏步骤、换口径或者重复犯以前已经纠正过的错误。一份好的 Skill 应该帮助 Claude Code 端到端地交付工作成果；某些节点不能由它自行判断时，也可以要求它先停下来征求我们的意见。

Skill 与 CLAUDE.md 的分工，主要取决于信息什么时候需要加载。CLAUDE.md 适合存放每次对话都需要知道的项目事实和长期规则；Skill 平时只提供名称和简要描述，完整内容只在调用时载入，适合存放某类任务才需要的知识和工作方法。

适合做成 Skill 的，通常是那些经常重复、需要反复交代相同要求、已经形成相对稳定步骤，并且有明确交付成果的任务。特别是容易遗漏环节、混淆口径、重复出现同类错误，或者需要固定检查和确认节点的工作，更值得做成 Skill。Skill 也不只适合记录操作流程；某类任务需要用到的专业知识、判断标准、写作规范和参考材料，也可以放进 Skill，在处理相关任务时再提供给 Claude。

②如何创建 Skill

Skill 有两个主要来源：一种是别人已经做好的 Skill，通常会打包在插件中，可以按照 4.2 介绍的方法安装和使用；另一种是根据自己的工作方式创建 Skill。别人做好的 Skill 适合解决相对常见的问题，个人特有的工作流程则更适合自己创建。

创建 Skill 不需要我们自己研究格式、手写文件。更合适的方法是：第一次完整做完一项真实任务后，就让 Claude 根据刚才的执行过程创建一份初版 Skill。这样，它可以直接从真实过程里提取任务的输入、执行步骤、判断标准、确认节点和交付要求。初版 Skill 不必追求完善，先把已经做过的流程记录下来，后续再通过一次次实际使用不断优化。

创建时建议调用前面安装的 skill-creator，直接告诉 Claude：“用 skill-creator，把我们刚才完成这项任务的方法做成一个 Skill。”它会进一步梳理适用场景和执行流程，并生成所需文件。生成之后，重点检查四件事：什么情况下应该调用；完整任务要经过哪些步骤；哪些地方必须先询问我们；最终要交付什么结果。

从文件上看，一份 Skill 至少包含一个独立目录和其中的 SKILL.md。文件开头的 description 说明它能做什么、什么时候应该使用，正文记录具体要求；需要时还可以加入模板、示例、参考资料和脚本。个人 Skill 通常放在 ~/.claude/skills/技能名/，所有项目都能使用；项目专用 Skill 放在 .claude/skills/技能名/，只在当前项目中使用。这些文件一般交给 skill-creator 处理即可，我们主要负责检查内容是否符合自己的真实工作方式。

③使用、管理和迭代 Skill

使用 Skill 有两种方式：直接描述任务，让 Claude 根据 description 自动判断是否调用；或者输入 /技能名 明确调用。Skill 文件夹的名称通常就是命令名称，例如 .claude/skills/flash-notes/SKILL.md 对应 /flash-notes。判断 Skill 是否有效，不只看它有没有被成功调用，更要看最终结果有没有漏步骤、判断错误和格式不一致。

Skill 创建完成并不代表流程已经成熟。很多问题只有在实际使用中才会暴露出来，例如触发条件不准确、步骤顺序不合理、确认节点过多或过少、参考资料没有在正确时机读取、交付结果仍不稳定。遇到这些问题，不要只在当前对话中纠正一次，还应把修正沉淀回 Skill。

因此，建议每个人都准备一个专门用于复盘和优化其他 Skill 的技能，例如 skill-improver。某个 Skill 实际运行一次以后，再调用 skill-improver 检查这次执行中出现的问题，并更新原来的 Skill。这样会形成一条持续改进的路径：完成真实任务 → 创建 Skill → 在同类任务中使用 → 复盘执行问题 → 更新 Skill。

平时也要定期整理已经安装和创建的 Skill。长期不用、功能重复或者已经不符合当前工作方式的，应当删除或合并。Skill 不是越多越好；只保留真正服务于自己使用场景的内容，Claude Code 才更容易准确选择和执行。

六、控制：盯住偏差，控住风险

管理中的控制不是为了限制员工，而是通过一套可靠的机制，让管理者敢于放权。使用 Claude Code 也是一样：设置、权限和钩子用来划定边界，回滚和 Git 负责纠正错误，工作树和沙箱则把风险限制在可控范围内。有了这些机制，我们才敢减少干预，让 Claude Code 更自主地完成任务。

1、设置：/config

输入 /config 会打开 Claude Code 的设置界面，可以在这里查看和修改各种选项。下面以 2.1.177 版本为例，按照面板中的顺序逐项说明；Claude Code 更新很快，后续版本的项目可能会有所增减。

这些选项大多有合理的默认值，不需要一开始就全部调整。先知道各自管什么，实际碰到需求时再回来修改即可。

2、权限规则（permission）

先把它和 3.2 的权限模式分清楚——这两个最容易混，其实是粗调和细调的关系。模式是档位旋钮，决定各种操作默认怎么处理：切到接受编辑模式，工作目录内的文件编辑就会自动放行。权限规则是单独设置的白名单和黑名单，可以控制一整类工具，也可以只针对某个具体动作。规则分三档：

• allow（放行）：名单上的动作免问直接做，比如允许它运行常用的检查命令；
• ask（必问）：名单上的动作每次执行前都必须问你，比如上传文件或向外发送内容；
• deny（禁止）：名单上的动作不允许执行，比如禁止某条危险命令。

两者怎么配合？Claude Code 每次准备执行操作时，会先检查权限规则：deny 中的操作直接禁止，ask 中的必须询问，allow 中的直接放行；没有匹配规则的操作，再按照当前权限模式处理。因此，deny 规则不受当前权限模式影响，列入其中的操作始终不会执行。

在运行命令的确认弹窗中选择 Yes, don’t ask again，Claude Code 就会保存一条 allow 规则，同类命令以后执行时不再询问。需要注意的是，命令的“不再询问”会长期保存，而文件编辑的“不再询问”只在当前会话中有效，2.4 中的弹窗选项②就属于后一种情况。

权限规则也有作用范围：可以只对当前项目生效，也可以设成个人规则，在所有项目中使用。平时通过弹窗保存的命令规则，默认只对当前项目有效；如果想跨项目通用，可以在 /permissions 里调整。

可以通过 /permissions 查看和增删现有规则，以及确认每条规则来自哪份设置文件。刚开始使用时，不妨先保持普通模式，观察哪些无风险操作经常触发确认，再将这些操作加入 allow。这样可以减少重复确认，同时保留对风险操作的审批。

使用权限规则时，还需要注意两点：

• 不要放行危险命令：对于 rm -rf（强制删除）等危险命令，应当保留执行前的确认。
• 不确定时使用普通模式：刚开始使用或处理重要文件时，可以让 Claude Code 在执行操作前逐次确认。

3、钩子（Hooks）

CLAUDE.md 中的规则会作为上下文提供给 Claude Code，但不能保证每次都被准确执行。**钩子（Hooks）**可以在特定事件发生时自动执行预设动作，不依赖模型是否遵循上下文中的规则。

一条钩子类似于一个闹钟，配置时需要确定三个要素：触发事件、匹配条件和执行动作。触发事件决定钩子在什么时候运行，匹配条件用于限定它针对哪些操作，执行动作则规定触发后具体做什么。Claude Code 内置了许多事件名称；这些事件只是触发时机，具体动作仍需自行配置。

以下是三个常用的触发事件：

• Notification：Claude Code 发出通知时触发。可以在它等待你批准或输入时，再执行一条系统通知，让你不用一直盯着终端。
• PostToolUse：某个工具执行成功后触发。可以在它编辑完文件后，自动运行格式化或检查工具。
• PreToolUse：某个工具执行之前触发。可以检查它准备执行的操作，必要时直接阻止，并把原因反馈给它。

我们可以直接让 Claude Code 完成配置，例如：“帮我配一个钩子：每当你需要我输入时，给我弹个系统通知。”这也是官方文档推荐的方式。输入 /hooks，也可以查看、添加、修改或删除已有钩子。

4、检查点与回滚（Checkpointing / Rewind）

每次你提出一个新需求，Claude Code 都会创建一个检查点（checkpoint）；使用文件编辑工具修改文件之前，还会记录文件当时的状态。万一它把文件改坏了，可以输入 /rewind，或者在输入框为空时连按两下 Esc，进入回退界面。先选择想退回的那条历史消息，再选择要恢复哪些内容。如果输入框里还有文字，连按两下 Esc 只会先清空文字。

回滚还分三种，可以按需选：

• 只回滚对话：把聊天退回到之前某一句，但保留已经改好的文件
• 只回滚代码/文件：把文件改动撤销，但保留聊天记录
• 全部回滚：文件和对话一起退回去

检查点可以跨会话保留。退出后恢复这段会话，之前的检查点仍然可用；默认会随会话在 30 天后清理。

检查点有两项限制：

• 不记录系统命令造成的文件变化：通过 rm、mv 等命令删除或移动的文件，无法通过检查点恢复。
• 不记录 Claude Code 之外的改动：你在编辑器中手动修改或通过其他程序产生的改动，不在检查点的追踪范围内。

所以，检查点适合在当前任务中快速反悔，但不能代替长期的版本记录。长期保存和管理文件版本仍需使用 Git。

5、版本控制（Git）

Git 是一个版本控制工具，可以把某个阶段的文件状态保存成一个版本。以后既可以查看两个版本之间改了什么，也可以把文件恢复到某个旧版本。这样即使 Claude Code 大范围修改后出了问题，也有一份可靠的旧版本可以找回来；正因为随时能够撤销和恢复，我们才敢更放心地让它放手去改。Git 不会自动记录每一次编辑，而是由你在合适的时候主动提交；完成一次重要工作或一轮集中修改后保存一个版本，通常就够用了。

Git 最适合管理 Markdown、代码、配置文件这类纯文本文件，因为它能清楚地显示具体增加、删除或修改了哪些文字。PPT、Word、Excel、图片等文件也可以交给 Git 保存版本，但 Git 通常只能看出”整个文件变了”，很难直接展示里面具体改了什么，也不擅长合并两个人分别做出的修改。因此，这类文件可以用 Git 留档，但不要指望获得和纯文本文件一样的版本管理体验。

Git 还是值得花一点时间学习，至少要对仓库、改动、提交和恢复这些基本概念有个大概了解。具体命令不必一开始就全部记住，哪里不懂可以随时问 Claude Code。关于git和GitHub的使用，具体可见《[[9-兴之所志/AI技能/Obsidian笔记中使用Git的一个简单教程|Obsidian笔记中使用Git的一个简单教程]]》。

6、工作树（worktree）

Git 在这里还有另一个用法：通过**工作树（worktree）**为 Claude Code 创建一个类似“平行空间”的独立副本。它在副本中工作，主库里的文件保持不动。任务完成后，可以先验收，再决定合并成果或删除副本。回滚和 Git 用于在改动发生后恢复，工作树则用于提前隔离改动。

工作树主要适合两类任务：

• 改动范围较大：如果任务涉及大量文件或目录重构，可以先在工作树中完成并验收，再合并回主库。少量文件的修改通常使用检查点或 Git 即可。
• 任务执行期间仍需使用主库：Claude Code 可以在工作树中处理任务，我们继续在主库中编辑，两边互不影响。

符合其中一种情况时，就可以考虑使用工作树。对于一般的日常文件处理，则未必需要。

可以在对话中直接要求 Claude Code 创建工作树，例如：“开一个工作树来处理这项任务。”它会在 .claude/worktrees/ 下创建副本，并将当前会话切换到其中。

创建工作树时，还要决定副本从哪个版本开始。默认情况下，副本从远程仓库默认分支的最新版本创建；也可以改成从当前本地已经提交的版本创建。前一种在 /config 中叫 fresh，后一种叫 head。无论选择哪一种，本地尚未提交的修改都不会进入工作树。

Claude Code 完成任务后，可以根据验收结果选择后续操作：

• 检查改动：让 Claude 汇报修改过的文件和具体内容，必要时打开副本验收。
• 合并成果：确认无误后，让 Claude 提交工作树中的改动，再合并回主库。
• 保留工作树：暂不处理时，可以保留工作树，以后继续使用。
• 删除工作树：不采用本次改动时，可以删除工作树，主库不会受到影响。

退出工作树时，Claude Code 会让你选择保留还是删除，不会擅自替你处理。

工作树也可以与 4.4 介绍的子代理结合使用。多个子代理可以分别在独立的工作树中执行任务，避免彼此的文件改动发生冲突。

7、沙箱（sandbox）

**沙箱（sandbox）**用于限制终端命令可以访问和修改的范围。命令执行后，可以正常读写工作目录和临时目录中的文件，但不能随意修改范围之外的文件；需要连接新的网络地址时，也会先征求我们的同意。这个限制由操作系统执行，通过脚本启动的其他程序同样需要遵守。

它和权限（6.2）的区别，可以简单理解为：**权限是门卫，决定一条命令能不能开始运行；沙箱是墙，限制命令运行以后能去哪里、能碰什么。**两者配合起来，既可以减少对普通命令的反复审批，又不至于完全失去边界。

如果所有操作都由我们逐次确认，通常不必额外启用沙箱。需要让 Claude Code 自动运行长任务，或者使用较多第三方脚本和扩展时，可以通过 /sandbox 开启沙箱，进一步限制命令的访问范围。

沙箱支持 macOS、Linux 和 WSL2，不支持原生 Windows。Windows 用户需要在 WSL2 中运行 Claude Code 才能使用。

七、附录：斜杠命令速查表

在聊天框里输入以 / 开头的命令，可以直接控制 Claude Code 的行为，相当于一排快捷按钮。命令会随版本增减，输入 /help 或只输入 /，可以查看当前版本实际可用的命令。

1、本文涉及的命令

下面按正文出现的章节排列。点击“文中位置”可以跳到相应小节查看具体用法。

2、其他常用命令备查

下面这些命令正文没有展开，但实际使用时可能会碰到。部分命令只在特定系统、套餐、项目类型或功能开关下出现，以输入 /help 后看到的列表为准。

兴之所志