Chuiyu Wiki

Appearance

2026-03-22
11267
46.7m

Claude Code 从入门到生产：一文讲透安装、使用、MCP、SubAgent、Plugin 的实战指南 ​

原文转载说明：本文基于公开可访问页面进行完整转载，并做了轻微排版整理，图片已本地化到仓库。

原文标题：Claude Code 从入门到生产：一文讲透安装、使用、MCP、SubAgent、Plugin 的实战指南

原文来源：CSDN / DreamMeng

原文链接：https://blog.csdn.net/DreamMeng/article/details/159353229

2026年的春天，Claude Code 非常火🔥。

r/ClaudeAI - * Welcome to the Claude Code research preview! CLAUDE CODE Login successful. Press Enter to continue

很多人已经装上了，也体验过：让它写个页面、改几段代码、生成一个小工具，看起来都很惊艳。但真正的问题是：会让它写几段代码，不等于你真的掌握了 Claude Code。因为一旦你把它真正用进日常开发，就会立刻遇到一连串更实际的问题：

这些，才是 Claude Code 从“玩具”走向“生产工具”的关键。所以这篇文章不讲虚的，我直接按照一条完整的实战路径，把 Claude Code 从安装开始，一路讲到：

  • 基础交互

  • 复杂任务处理

  • 终端控制

  • 回滚与上下文管理

  • 图片与 Figma 设计稿还原

  • CLAUDE.md 项目记忆

  • Hook

  • Agent Skill

  • SubAgent

  • Plugin

目标只有一个：

让你只看这一篇文章，就能把 Claude Code 从入门一直用到接近生产环境。

一、先装起来：Claude Code 的起点不是聊天，而是终端

Claude Code 不是网页里的聊天机器人，它的核心使用方式是在终端里运行。
所以第一步不是“打开一个网页开始提问”，而是先把它安装到你的本机环境中。

通常安装流程是这样的：

  1. 打开 Claude Code 官方安装页面。

    https://claude.com/product/claude-code

    图片

  2. 复制页面给出的安装命令。

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

    如果你不喜欢 curl | bash 这种方式，还有一个更“安全/规范”的替代方案。可以用：

    brew install --cask claude-code

  3. 回到终端，粘贴并执行。

    图片

  4. 等待安装完成。

    图片

  5. 之后你就可以在终端里直接输入 claude 启动它。

    图片

安装完成之后，Claude Code 的使用入口就是命令行。这一点非常重要，因为它决定了 Claude Code 后续的能力边界远远不只是“回答问题”，而是：

  • 进入你的项目目录

  • 读写文件

  • 执行命令

  • 管理任务

  • 接外部工具

  • 维护会话与记忆

也就是说，它更像一个运行在终端中的开发 Agent。

二、登录与授权：先让 Claude Code 拿到工作资格

第一次启动 Claude Code 时，通常会要求你登录。如果没有自动提示，可以手动输入：/login 这样会主动触发登录流程。一般来说，Claude Code 的接入方式可以理解为两类：

1）订阅账号登录：如果你本身已经有 Claude 的 Pro 或 Max 账号，通常可以直接走订阅授权方式。

2）API Key 登录：如果你走 API 模式，那就是按调用量计费。

图片

完成授权后，Claude Code 就正式可用了。这里你要建立一个正确认知：

Claude Code 的重点，不只是“模型本身”，而是“模型 + 终端 + 工具 + 工作流”。

所以不要把它理解成另一个普通聊天框。它真正的价值，在于它能进入你的开发现场，替你执行一部分工作。

三、从一个最小实战开始：先让它做一个待办软件

学一门工具，最好的方式不是先背命令，而是先做一个简单但完整的小任务。比如，你可以先新建一个目录：

mkdir my-todocd my-todo
然后启动 Claude Code：
claude
进入之后，直接给它一个清晰需求：
给我做一个待办软件，使用 HTML 实现
图片
这时 Claude Code 会开始分析你的需求，并尝试创建文件，比如 index.html。
但这里它不会一上来就直接改，而是会先问你：
图片
  • 是否允许本次创建文件？
  • 是否允许本次会话期间后续所有编辑自动通过？
  • 或者拒绝这次修改？
这一刻，你就正式接触到了 Claude Code 的核心机制之一：
模式与权限控制。
四、三种模式一定要分清：默认模式、自动模式、规划模式
Claude Code 最容易让新手混乱的地方，就是模式切换。但其实它的逻辑并不复杂，只要你把这三种模式理解透了，后面很多行为你就看得懂了。通过 Shift + Tab，你可以在不同模式之间切换。
图片
1）默认模式：最适合第一次进项目
默认模式下，Claude Code 每次创建文件、修改文件，都会先征求你的同意。
这种模式的特点是：
  • 安全
  • 可控
  • 不容易误改
  • 适合陌生项目
适合什么时候用？
  • 第一次进入一个项目
  • 不确定 Claude Code 会改哪里
  • 改的是比较重要的代码
  • 你想先观察它的行为
缺点也很明显：如果任务比较长，它会频繁打断你，让你一次次确认。
2）自动模式：文件层面最省心
如果你开启自动模式，那么 Claude Code 后续在当前会话中对文件的创建和编辑，就不再反复询问你了。这时候它可以连续完成很多事情，比如：
  • 拆分文件
  • 写多个模块
  • 重构目录
  • 连续改代码
适合什么时候用？
  • 你已经明确任务目标
  • 目录可控
  • 本地实验项目
  • 想快速推进开发
但要注意：自动模式只代表“文件编辑自动通过”，不代表它执行所有终端命令也自动通过。这一点很多人会误解，后面讲终端权限时你就会明白。
3）规划模式（Plan Mode）：复杂任务先讨论，不直接开改
规划模式是 Claude Code 非常强的一个能力。开启后，它不会直接修改文件，而是先帮你：
  • 理解目标
  • 拆分步骤
  • 设计目录结构
  • 说明实施方案
  • 给出执行计划
这个模式非常适合：
  • 架构重构
  • 技术栈迁移
  • 复杂页面改造
  • 大模块新增
  • 需求还没完全想清楚的时候
比如你已经有了一个单文件 index.html 的待办应用，但你觉得这种结构不适合继续扩展，想改造成：
  • React + TypeScript + Vite
这时，不要直接说“给我重构”。更推荐的方式是先切到规划模式，然后输入：
请将当前待办应用重构为 React + TypeScript + Vite 项目，保留现有功能，并保持 UI 风格一致。
如果还想补充要求，可以继续增加，比如：
  • 给每个待办事项增加优先级
  • 分为高、中、低
  • 用不同颜色区分
在规划模式下，Claude Code 会先产出一份方案。
 这份方案里通常会包括：
  • 改造目标
  • 推荐目录结构
  • 需要新增哪些文件
  • 原功能如何迁移
  • 状态管理怎么做
  • 可能需要的测试点
然后它会问你：
  • 直接执行计划
  • 执行但保留谨慎权限
  • 继续修改计划
这就是 Claude Code 非常像“工程搭档”的地方。不是一上来就写，而是先和你把方案对齐。
五、在 Claude Code 里直接执行终端命令：这是它和普通聊天工具最大的区别之一
很多 AI 编程工具会生成代码，但是否能真正进入你的开发过程，关键要看它能不能操作终端。在 Claude Code 里，你可以输入 ! 号进入 Bash 模式并执行命令。比如你已经让它生成了 index.html，现在想直接打开这个文件看效果，就不一定非要去文件管理器手工双击。
图片
open index.html
如果你想查看当前目录下的文件，也可以执行：
ls
如果要安装依赖，可以运行：
npm install
如果要启动开发服务，可以运行：
npm  run dev
这意味着 Claude Code 不是只会“说怎么做”，而是已经开始具备“帮你做”的能力了。
过去我们的工作流是：
  • 问 AI
  • 复制代码
  • 自己粘贴
  • 自己保存
  • 自己开终端
  • 自己运行
  • 出错再回来问
现在它可以逐步把这些动作串起来。
所以你要明白：
Claude Code 的真正威力，不是生成一段代码，而是能帮你推进整个开发链路。
六、为什么自动模式下它还会向你确认命令？因为文件编辑和终端命令不是一个风险等级
这里是 Claude Code 很多人第一次使用时会困惑的地方。你明明已经打开了自动模式，为什么它在执行某些命令时还是会停下来问你？原因很简单：
Claude Code 认为执行终端命令，比修改文件更危险。
比如：
  • 创建目录
  • 安装依赖
  • 删除内容
  • 启动脚本
  • 修改某些环境结构
这些动作可能会对整个项目甚至本机环境产生影响。所以即使你在自动模式下，它对于命令层面的行为仍然会比较谨慎。这是合理的，因为：
  • 改一个文件，影响通常局部可控；
  • 执行一个命令，影响可能是全局的。
所以文件权限自动放开，不代表命令权限也自动放开。
七、最高权限模式：dangerously-skip-permissions 到底能不能用？
如果你觉得每次执行命令都要确认太麻烦，那么 Claude Code 提供了一个更彻底的方式：
启动时直接加上这个参数：
claude --dangerously-skip-permissions
一旦这样启动，Claude Code 基本就进入了“权限绕过”状态。它执行各种终端命令时，不会再频繁要求你确认。听上去是不是很爽？
是的，它确实能大幅提高效率。特别是在这种场景下非常好用：
  • 本地实验项目
  • 个人 Demo
  • 你新建的空目录
  • 完全可控的沙盒环境
但这个选项名字里为什么直接写着 dangerously？因为它确实危险。开启后，你相当于把终端里的很多主动权直接交给了 Claude Code。理论上，它就具备了执行下列操作的可能：
  • 删除文件
  • 改动目录
  • 安装或卸载依赖
  • 执行各种 Shell 命令
所以我的建议很明确：
可以考虑开启的场景:
不建议开启的场景
  • 你自己本地的测试项目
  • 没有重要数据的新目录
  • 想追求极致效率的个人环境
  • 公司代码仓库
  • 生产项目
  • 含敏感配置的目录
  • 共享机器
  • 你根本不了解结构的旧项目
一句话总结：这是一个效率开关，也是一个风险开关。
 能不能开，不看你胆子大不大，而看你的环境是不是足够可控。
八、让它帮你重构架构：从 HTML 单文件升级到 React + TypeScript + Vite
我们继续顺着待办应用这个例子往下走。
如果 Claude Code 初始生成的是一个单文件 HTML 应用，那么它很适合快速验证想法，但不适合长期维护。
 因为代码全写在一个文件里，项目稍微复杂一点，就会变得很难改。
这时你就可以进入规划模式，提出结构升级需求。
比如：
请把当前待办应用重构成 React + TypeScript + Vite 项目，保留所有现有功能，界面风格保持一致。
图片
如果你还想加新功能，也可以在同一轮需求里补进去，比如：
每个待办项要有优先级，高、中、低三档，并且用不同颜色区分。
Claude Code 会先给你一份计划。
图片
如果你觉得还不够完整，可以继续补要求，让它重新整理计划。只有当你对方案满意了，再让它真正执行。这一点要养成习惯：
小活儿直接做，大活儿先出计划。
很多人觉得 AI 最大的问题是“写出来的东西不稳定”，但其实很多不稳定，不是模型不行，而是你没让它先把方案想清楚。
九、自己启动开发服务器：但要小心，服务一跑起来，Claude Code 可能会被阻塞
当 Claude Code 完成了前端项目的创建后，通常你会想跑起来看看效果。
这时你可以执行：
npm run dev
如果项目正常，终端通常会输出本地访问地址。你点开链接，就能看到页面效果。但这里有一个必须理解的点：
当前终端一旦被开发服务占住，Claude Code 就没法继续正常处理你的新输入。
因为 npm run dev 这类命令通常是持续运行的。它会一直监听文件变化、持续占用前台终端。所以如果你在同一个会话里还想继续让 Claude Code 改代码、回答问题、追加功能，就必须把这个服务放到后台。
十、后台任务管理：让服务继续跑，同时你还能继续和 Claude Code 协作
如果前端服务正在运行，而你又想继续和 Claude Code 对话，这时最好的做法是把当前任务放到后台。
图片
放到后台之后，会发生两件事：
第一，开发服务不会停
你的页面依然可以访问，热更新通常也还能工作。
第二，Claude Code 恢复响应
你可以继续给它提需求、让它修改代码。
随后你还可以查看当前后台任务列表。在任务列表里，通常能看到类似 npm run dev 这样的服务正在后台运行。如果后面你想结束这个服务，也可以在任务管理界面中停止它。这套机制在实际开发里非常重要，因为真实工作不是“写完代码就结束”，而是：
  • 启服务
  • 看页面
  • 发现问题
  • 改代码
  • 再看效果
  • 再继续改
Claude Code 能管理后台任务，就意味着它开始真正接近开发现场，而不是只做静态回答。
十一、追加功能后发现做错了怎么办？用 Rewind 回滚
假设你现在已经把待办应用跑起来了，接着你又让 Claude Code 帮你加了一个“中英文切换”的功能。它确实加上去了，右上角还多了语言切换。但你用着用着突然发现：
“等等，我的用户本来就都看得懂中文，我做这个功能干什么？”
这时候最理性的做法不是继续补丁式修改，而是直接回滚。Claude Code 提供了回滚能力。它会记录你在不同请求节点上的变更点，你可以回到其中某一个版本。
图片
回滚时通常会有几种选择：
  • 同时回滚代码和会话
  • 只回滚代码
  • 只回滚会话
  • 放弃回滚
如果你的目标是“撤销这个功能，回到功能添加前的状态”，那最稳妥的做法通常是把代码和会话一起回退。这样一来，不只是文件内容回去，连当前对话的上下文也会同步回到那个节点，更不容易让 Claude Code 后续继续沿着错误方向往下走。
十二、但一定要记住：Claude Code 的回滚不是 Git
这里必须单独提醒一下。
Claude Code 的回滚很好用，但你不能把它当成完整的版本控制系统。
因为它更擅长撤销“它自己写入的内容”，但对那些通过终端命令产生的副作用，它未必能完整恢复。例如：
  • 你执行了 mkdir
  • 你执行了 npm install
  • 你生成了某些构建文件
  • 你安装了依赖包
这些内容，有时候不会随着 Claude Code 的回滚一起彻底消失。所以回滚之后，如果你发现目录里还有很多残留文件，不要惊讶。这不是一定出 Bug，而是 Claude Code 的回滚边界本来就和 Git 不一样。
图片
所以我的建议是：
Claude Code 的 Rewind 适合做什么？
  • 快速撤销最近几轮错误尝试
  • 回到某个会话节点重新开始
  • 撤回一次不满意的功能改动
不适合做什么？
  • 替代 Git 分支管理
  • 替代正式版本控制
  • 处理复杂工程的精确回滚
真正重要的项目，Git 还是必需的。
十三、如果你不满意它做的页面，直接给它看图
很多时候，纯文字描述 UI 是不够的。你说“高级一点”，它理解的是一种高级；你说“现代一点”，它可能还是给你一个很典型的 AI Demo 风格页面。这时候怎么办？最直接的方式，就是把设计稿图片给 Claude Code。
操作方式通常有两种：
方法一：直接拖拽图片到 Claude Code
你把 PNG 图片直接拖进去，它就能识别这是图像输入。
方法二：复制图片后粘贴
这里有一个细节要注意：
 在 Claude Code 里粘贴图片时，用的是 Ctrl + V。即使你在 macOS 上，也不是 Command + V。
图片给进去之后，你就可以直接下指令：
请根据这张设计稿修改当前页面。
这时候 Claude Code 会尝试根据图片中的布局、颜色、层次来调整页面。
这种方式已经很好用了，特别适合：
  • 快速做近似还原
  • 调整视觉方向
  • 让 AI 更接近你的审美预期
但要坦白说，单靠图片还原通常还不够精确。因为图片只能提供视觉结果，无法天然提供：
  • 精确间距
  • 字体样式规范
  • 组件结构
  • 设计系统信息
想做到更准，就要上 MCP。
十四、MCP 到底是什么？
一句话理解：让 Claude Code 不只是“看见”，而是真正“读取外部世界”
很多人第一次接触 MCP，会觉得这个词很抽象。
你可以先这样理解：
MCP 是让大模型连接外部工具和外部上下文的一种标准方式。
在 Claude Code 的场景里，它的意义就是：
  • 不再只靠你手工描述
  • 不再只靠一张截图猜
  • 而是让 Claude Code 直接去读取工具中的结构化信息
这就是为什么用 MCP 接 Figma，会比单纯给截图更强。因为它拿到的不只是“长什么样”，还包括：
  • 设计上下文
  • 组件信息
  • 字体与间距
  • 样式规则
  • 布局关系
这就从“凭感觉还原”升级成了“依据结构化设计信息还原”。
十五、如何安装 Figma 的 MCP Server，并让 Claude Code 读取设计稿
如果你想让 Claude Code 更精准地还原 Figma 设计稿，一般做法是安装对应的 Figma MCP Server。操作思路通常是：
  1. 按照 Figma MCP Server 的安装方式，在终端执行安装命令。
    claude mcp add --transport http figma https://mcp.figma.com/mcp
  2. 安装完成后，重新启动 Claude Code。
  3. 使用 /resume 回到当前会话。也可以用 claude -c。
  4. 在 Claude Code 里查看当前 MCP 工具。
    /mcp
  5. 找到 Figma 相关工具并完成授权。
    图片
  6. 然后把 Figma 设计稿链接交给 Claude Code。
完成这些后，你就可以直接对 Claude Code 说：
请修改当前页面，使它与这个 Figma 设计稿保持一致。
并把设计链接一起提供给它。
图片
接下来，Claude Code 会尝试调用对应的 MCP 工具，例如：
  • 获取 design context
  • 获取设计截图
  • 获取组件信息
当这些信息拿到之后，它就能依据更完整的设计上下文去改代码。这种方式的还原效果，通常会明显优于单纯凭一张 PNG 图片硬猜。
当然，也别神化它。它依然可能会在个别细节上出现：
  • 某些值没算对
  • 某些字段是 undefined
  • 某些布局还得你手工微调
但总体方向通常会更准，尤其对间距、风格、层次感的把握会更好。
十六、安装完 MCP 后会话没了怎么办？用 Resume 恢复
有时你为了安装 MCP Server，需要先退出 Claude Code。装完之后再进来，很多人第一反应是：
“我之前那段对话是不是丢了？”
其实未必。Claude Code 支持恢复历史会话。常见思路有两种：
方式一：手动恢复
进入 Claude Code 后，执行恢复会话命令，然后从历史列表中选择你刚才那个会话。
方式二：启动时直接继续上次会话
在启动 Claude Code 时，加一个 continue 参数，让它直接恢复最近一次会话。
这样做的好处非常明显：
  • 不用重新讲项目背景
  • 不用重新解释你刚才做到哪一步
  • 不用重新把需求从头输入一遍
这会让 Claude Code 更像一个持续协作对象，而不是一次性问答工具。
十七、上下文太长怎么办？学会用 Compact 和 Clear
当你和 Claude Code 互动得越来越多，它的上下文会不断累积：
  • 你提了很多需求
  • 它写了很多代码
  • 跑了很多命令
  • 调了很多工具
  • 还读了图片和 MCP
如果不处理，这会带来几个问题：
  • 响应变慢
  • 成本变高
  • 容易抓不住重点
  • 记忆越来越乱
所以一定要学会上下文管理。
1）/compact：保留重点，压缩无关噪音
当你觉得当前会话已经很长，但项目还要继续做下去，这时最推荐用的是压缩。压缩的作用不是“忘掉一切”，而是：
  • 把核心需求留下来
  • 把关键信息提炼出来
  • 把那些冗长日志、中间过程、重复记录压缩掉
这样 Claude Code 后面还能继续工作，但负担会小很多。Ctrl + o 可以查看压缩后的上下文内容。
图片
这非常适合：
  • 一个功能做完，要继续做下一个功能
  • 会话很长，但项目背景还要保留
  • 想降低上下文噪音
2）/clear：彻底清空上下文
如果你接下来要做的是另一个完全无关的任务，那就没必要背着旧上下文继续走。这时候可以直接清空。适合这种情况：
  • 这个项目先不做了
  • 接下来换成另一个目录、另一类任务
  • 旧上下文继续保留反而容易干扰判断
一句话总结：
  • 还在同一个项目里继续推进：优先 compact
  • 准备换任务、换上下文：再考虑 clear
未来会不会高效使用 AI，核心能力之一就是：你会不会管理上下文。
十八、CLAUDE.md：把“口头提醒”升级成“项目记忆”
很多人用 Claude Code，会不断重复说这些话：
  • 这个项目用 React + TypeScript
  • 不允许动 API 层
  • 样式统一用 Tailwind
  • 输出说明用中文
  • 不要随便改目录结构
  • 变更前先给计划
  • 回答要简洁
如果这些都靠每次口头说，那太低效了。Claude Code 提供了一种更稳定的办法：
项目记忆文件 CLAUDE.md。
你可以让 Claude Code 帮你初始化一份 CLAUDE.md，然后你自己继续补充内容。
图片
这个文件非常适合放：
  • 项目背景
  • 技术栈
  • 目录约束
  • 开发规范
  • 输出语言
  • 风格偏好
  • 注意事项
例如你完全可以写：
  • 本项目使用 React + TypeScript + Vite
  • 所有新增组件放入 src/components
  • 不允许直接修改 api 目录
  • 所有回答以中文输出
  • 需要先给出改造思路再动手
  • 样式优先保持现有视觉风格
这样 Claude Code 每次进入这个项目时，就会读取这些规则。
图片
它的本质，就是把你和 AI 之间那些反复重复的口头约定，固化成项目级长期记忆。
十九、项目级记忆和用户级记忆要分开理解
通常这类记忆 /memory 会有两层：
图片
1）项目级 ./CLAUDE.md
只对当前项目生效。适合写这个项目自己的规则。
2）用户级 ~/.claude/CLAUDE.md
对你这个用户整体生效。适合写你个人长期不变的偏好。
项目级适合写
用户级适合写
  • 技术栈
  • 目录结构要求
  • 项目特定约束
  • 输出规范
  • 你偏爱中文回复
  • 你喜欢先给方案再执行
  • 你喜欢精简还是详细风格
  • 你常用的编码习惯
这两层分清之后，Claude Code 的记忆会更稳定，也更不容易混乱。
二十、Hook：把重复动作自动化
接下来开始进入高级玩法。
1. Hook 是什么？
你可以把它理解成：当 Claude Code 完成某个动作时，自动触发你预先定义的一段逻辑。最典型的场景，就是代码格式化。
图片
比如你不想每次都手工运行格式化工具。那么就可以配置一个 Hook：只要 Claude Code 刚刚创建或编辑了文件，就自动执行一次格式化。这个逻辑非常适合做成 Hook。
图片
2. Hook 适合干什么？
除了格式化，它还很适合自动做这些事：
  • 运行 prettier
  • 运行 lint
  • 自动补充文件头
  • 执行测试
  • 生成日志
  • 发送通知
  • 校验命名规则
它的本质是：
把“每次都得手动做的事”变成自动执行的流程。
当团队里很多规范总是靠“记得做一下”维持时，Hook 的价值就非常大。因为一旦靠人记忆，迟早会漏。
图片
3. Hook 的思维方式
你在设计 Hook 时，其实只需要想清楚三件事：
图片
你一旦按这个思路去理解，Hook 就不再是一个抽象概念，而是一个很实用的自动化入口。
二十一、Agent Skill：把常用套路沉淀成随时可调用的能力
有些任务不是很复杂，但重复频率很高，而且每次格式都差不多。例如：
  • 每日总结
  • 周报
  • 会议纪要
  • 发布说明
  • Bug 报告
  • Code Review 模板
  • PR 描述
如果你每次都重新写要求，太浪费了。这时候最适合用 Agent Skill。
你可以把它理解成：一份给 Claude Code 看的能力说明书。它通常包含两部分：
第一部分：元信息
  • 名称
  • 描述
  • 什么时候适合调用
第二部分：具体要求
  • 输出格式
  • 固定结构
  • 语气要求
  • 需要包含哪些信息
举个最典型的例子：日报 Skill
假设你每天都想让 Claude Code 按固定格式帮你写日报，那你就可以创建一个类似 daily-report 的 Skill。
图片
里面规定：
  • 必须包含日期
  • 必须有开发摘要
  • 必须有开发详情
  • 必须有问题与阻塞
  • 必须有明日计划
以后当你输入：
写一份今日开发总结
Claude Code 就可能自动识别并调用这个 Skill。或者你也可以主动调用它。这样你的日报输出就能长期保持同样结构，而不必每天都重复解释一次。
这就是 Skill 最适合的场景：高频、固定套路、对格式要求强。
二十二、SubAgent：不是模板，而是“分身”
很多人学到这里，会觉得：
“Skill 已经很强了，那为什么还要 SubAgent？”
因为这两者根本不是一个层级的东西。
  • Skill 更像是“给主助手加了一套固定写法”。
  • 而 SubAgent 更像是“给主助手配了一个专门干某类活的分身”。
这就是本质区别。
1. SubAgent 适合什么场景？
适合这些任务：
  • 代码审核
  • 大型目录分析
  • 安全检查
  • 文档巡检
  • 架构审查
  • 风险评估
这些任务通常有个共同特点：
  • 中间过程很多
  • 可能要读大量代码
  • 需要独立分析
  • 不希望把主会话塞得很脏
这时就很适合交给 SubAgent。
2. 你可以如何理解 SubAgent？
你可以这样想：
主会话是你当前坐在桌前的主工程师。
 SubAgent 是你临时叫来的某个专项顾问。
比如你说：
帮我做一次代码审核
这时候主 Agent 不一定自己亲自去啃所有文件，而是把任务交给一个“代码审核专员”去做。
图片
这个专员：
  • 有自己的任务边界
  • 有自己的行为规则
  • 有自己的上下文
  • 有自己的工具权限
它干完活之后，只把最终审核结果汇报回来。这样，主会话就不会被一堆中间分析过程撑爆。
图片
图片
二十三、Skill 和 SubAgent 的区别，一定要彻底弄懂
这是 Claude Code 里最容易混淆、但又最关键的点之一。
Agent Skill
SubAgent
特点：
  • 共享主会话上下文
  • 继承你当前对话里的背景
  • 过程也会进入当前上下文
  • 适合轻量、格式化、高频任务
  • 有独立上下文
  • 中间过程不污染主会话
  • 适合重分析任务
  • 适合处理大量内容
比如：
  • 日报
  • 周报
  • 当前任务总结
  • 会议纪要
  • 大项目代码审核
  • 风险检查
  • 大规模文档扫描
  • 深度架构分析
一句话记住：Skill 是套路。SubAgent 是分身。
再具体一点：
  • 你想让 Claude Code 用固定格式做事，用 Skill。
  • 你想让 Claude Code 派一个独立代理去做重任务，用 SubAgent。
只要把这点记住，后面很多高级玩法你都会顺很多。
二十四、Plugin：把 Skill、SubAgent、Hook 等能力打包成一键安装包
如果说 Skill、Hook、SubAgent 还是单个能力组件，那么 Plugin 就是把这些组件打包起来，做成一个能力安装包。
你可以把 Plugin 理解成：Claude Code 的能力整合包。
安装一个 Plugin，可能就相当于一次性装上了：
  • 一个 Skill
  • 一个 Hook
  • 一个 SubAgent
  • 一组配置
  • 甚至一些外部工具接入规则
1. Plugin 的价值在哪里？
它最大的价值不是给个人玩，而是给团队复用。比如一个团队里，已经沉淀出一套成熟的前端设计工作流：
  • 有固定的界面规范
  • 有常用的提示模板
  • 有统一的样式策略
  • 有审核要求
如果这些东西都靠口口相传，很容易失真。
 但如果能打成 Plugin，团队成员装上就能直接用，效率会高很多。
2. 前端设计类 Plugin 为什么特别值得关注？
因为 AI 生成前端页面时，经常会出现一种“很像 AI 做的页面”的感觉。
图片
比如：
  • 配色套路化
  • 布局审美雷同
  • 交互缺乏层次
  • 有种熟悉的模板味
而一些专门的前端设计类 Plugin，目标就是改善这种共性，让 Claude Code 在做页面时更贴近成熟设计规范，而不是只会输出那种标准化 AI Demo 风格。
所以如果你是做前端的，或者你经常让 Claude Code 出页面，Plugin 这条线非常值得深入研究。
二十五、真正想把 Claude Code 用进生产，建议你这样落地
讲到这里，能力很多了。但真正能不能用起来，关键还是看你的使用策略。这里给你几个最实用的落地建议。
建议 1：小任务直接做，大任务先 Plan Mode
不要所有任务都一句话扔给 Claude Code 开干。正确做法是：
  • 小改动、单功能、单文件：直接做
  • 重构、迁移、新架构、大功能：先出计划
这会明显降低返工率。
建议 2：把 dangerously-skip-permissions 当作实验环境加速器，不要当默认配置
它确实很爽，但不该在所有环境无脑开启。只在这些地方考虑用：
  • 本地实验目录
  • 新建 Demo
  • 可随时删除的沙盒项目
不要在这些地方轻易开：
  • 公司项目
  • 老仓库
  • 敏感代码库
  • 有配置和密钥的目录
建议 3：尽早写好 CLAUDE.md
很多人不是不会用 Claude Code，而是不会给它稳定上下文。把这些信息尽早写进去：
  • 技术栈
  • 目录约束
  • 输出语言
  • 项目背景
  • 风格偏好
  • 不能碰的地方
  • 修改前必须先做什么
这是提升稳定性的关键动作之一。
建议 4：重复性输出用 Skill，重分析任务用 SubAgent
这个判断一定要形成肌肉记忆：
  • 高频格式任务 → Skill
  • 深度分析任务 → SubAgent
一旦选对，Claude Code 会好用很多。
建议 5：真正想做设计还原，尽量接 MCP
文字描述 UI，通常不够准；
 只看截图，通常不够细；
 能接结构化设计信息，才更接近工程可用。
所以如果你们本来就在用 Figma，尽快研究 MCP，会非常值。
建议 6：回滚只是应急，Git 仍然是正式版本控制核心
Claude Code 可以帮你快速撤销错误方向，但不要因为它有 Rewind，就忽略 Git。真正重要的项目，一定要继续保留：
  • 分支
  • 提交记录
  • 回滚点
  • 可审计变更
Claude Code 是开发搭档，不是版本治理系统。
二十六、结语：Claude Code 的真正门槛，不在命令，而在工作流
很多人第一次看 Claude Code，会被它“能写代码”吸引。但用久了你会发现，它真正厉害的地方，从来不是“生成一段代码”。而是它正在逐步提供一整套开发 Agent 工作流能力：
图片
    这些能力组合在一起，Claude Code 就不再只是一个代码助手，而更像一个可以被你逐步驯化、配置、扩展、沉淀的开发系统。所以学 Claude Code，真正要学的不是几个命令，而是这件事：
    你如何设计自己的 AI 开发工作流。
    这才是它从“好玩”走向“好用”，再走向“生产可落地”的关键。
    最近更新