古法编程

Appearance

Claude Code 的高效生产力，离不开对 Skills、Hooks、Subagents 及 MCP 等核心组件的系统配置和理解。本文基于 10 个月生产实战经验，手把手教你 10 分钟内建立完整的 Claude Code 工作流：区分 Skills 与 Commands、掌握 Hook 事件自动化、合理配置 Subagents 独立上下文、精细管理 MCP 资源，助你从入门到深度定制，全面提升 AI 编程助手的落地效率。

Claude Code 快速上手指南：Skills、Hooks、Subagents、MCP 实战配置 ​

Claude Code 作为新一代 AI 编程助手，远不止“对话生成代码”这么简单。通过 Skills、Hooks、Subagents、MCP（Model Context Protocol）等模块，你可以像搭积木一样，构建高度自动化、并行化、可扩展的 AI 编程工作流。本文将结合实际项目经验，带你快速入门并高效配置这些核心能力。

Skills 与 Commands：工作流的基石 ​

Skills 是 Claude Code 的核心生产力单元。你可以把 Skill 理解为“可复用的工作流模板”：它不仅包含提示词（Prompt），还可以集成结构化文件、代码地图（codemap）、项目规范等，适用于特定场景下的自动化执行。

例如，清理死代码和无用文档可用 /refactor-clean，测试相关则有 /tdd、/e2e、/test-coverage 等命令。这些“斜杠命令”其实是对 Skill 的快捷入口，而真正可维护、可扩展的逻辑都应该沉淀在 ~/.claude/skills/ 目录下：

bash
~/.claude/skills/
  pmx-guidelines.md      # 项目专属规范
  coding-standards.md    # 语言最佳实践
  tdd-workflow/          # 多文件 Skill，含 SKILL.md
  security-review/       # 检查清单式 Skill

Commands 则是历史兼容层，主要用于迁移期的斜杠命令适配，长期建议将核心逻辑迁移到 Skills。

详细的 Skill 设计与最佳实践，可参考 Everything Claude Code 完全指南：38 Agent + 156 Skill 的生产级 AI 编程插件。

Hooks：事件驱动的自动化 ​

Hooks 是基于事件触发的自动化机制，能在特定操作前后自动执行脚本或提醒。与 Skills 不同，Hooks 主要绑定在工具调用、生命周期事件等节点上。

常见 Hook 类型包括：

  1. PreToolUse：工具执行前（如校验、提醒）
  2. PostToolUse：工具执行后（如格式化、反馈循环）
  3. UserPromptSubmit：用户消息提交时
  4. Stop：Claude 回复结束时
  5. PreCompact：上下文压缩前
  6. Notification：权限请求

实战示例：长时间命令前提醒使用 tmux

json
{
  "PreToolUse": [
    {
      "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm|pnpm|yarn|cargo|pytest)\"",
      "hooks": [
        {
          "type": "command",
          "command": "if [ -z \"$TMUX\" ]; then echo '[Hook] 建议使用 tmux 保持会话持久化' >&2; fi"
        }
      ]
    }
  ]
}

你可以通过官方的 hookify 插件用自然语言描述需求，自动生成 Hook 配置，免去手写 JSON 的繁琐。更多 Hook 场景与配置详见 Everything Claude Code Hooks 实战：PreToolUse / PostToolUse / Stop 事件驱动自动化完全配置。

Subagents：独立上下文的并行协作 ​

Subagents（子代理）让 Claude Code 支持“多进程/多 Agent”并行协作。主 Agent 可将特定任务委派给权限受限的 Subagent，既能释放主上下文窗口，也能实现任务隔离、权限细分。

常见 Subagent 类型包括：

  • planner.md：功能实现规划
  • architect.md：系统架构决策
  • tdd-guide.md：测试驱动开发
  • code-reviewer.md：代码质量与安全审查
  • build-error-resolver.md：构建错误修复
  • e2e-runner.md：端到端测试
  • refactor-cleaner.md：死代码清理

每个 Subagent 可单独配置允许的工具、MCP、权限等，实现最小授权原则。例如，安全审查 Agent 只允许读取代码和调用安全相关工具，避免误操作生产环境。

Subagent 的独立上下文机制，极大提升了复杂任务的并行处理能力。例如，主 Agent 负责需求分解，子 Agent 同步进行代码生成、测试、审查，互不干扰。更多 Subagent 应用可参考 Everything Claude Code Architect Agent：系统设计与架构决策的专职 AI 代理 及相关专题。

Rules 与 Memory：规范与持久记忆 ​

.rules 文件夹用于存放 Claude 必须遵循的最佳实践和项目规范。你可以采用单一 CLAUDE.md 或按主题拆分多个 .md 文件：

bash
~/.claude/rules/
  security.md      # 安全规范
  coding-style.md  # 代码风格
  testing.md       # TDD、覆盖率要求
  git-workflow.md  # 提交规范
  agents.md        # 子代理分工
  performance.md   # 性能与模型选择

典型规则如“不允许代码中出现 emoji”、“前端禁止紫色系”、“上线前必须测试”、“优先模块化代码”、“禁止提交 console.log”等。规则体系可与 Skills、Hooks 联动，形成闭环自动化。关于跨语言规则库的设计，可参考 Everything Claude Code Rules 体系详解：12 种语言规则集的设计思路与按需安装指南。

MCP（Model Context Protocol）：AI 原生的外部服务集成 ​

MCP 是 Claude Code 连接外部服务（如数据库、CI/CD、云平台等）的桥梁。它不是传统 API 的替代，而是通过 Prompt 驱动的协议，让 Claude 能直接读取、操作外部数据。

例如，Supabase MCP 允许 Claude 直接查询数据库表、执行 SQL，无需手动复制粘贴；Chrome MCP 则让 Claude 自动化浏览器操作，实现端到端 UI 测试和页面分析。

MCP 管理的核心原则：精简启用，节省上下文窗口。
虽然你可以配置 20~30 个 MCP，但建议每个项目只启用 5~10 个，避免工具泛滥导致上下文窗口消耗过快，影响性能。

bash
# 查看已启用 MCP
/mcp

# 在 ~/.claude/settings.json 或当前 repo 的 .mcp.json 禁用未用 MCP

合理的 MCP 选择和管理策略，能大幅提升 Claude Code 的响应速度和稳定性。更多 MCP 实践见 Everything Claude Code MCP Server Patterns Skill：Node.js/TypeScript SDK 构建 MCP 服务器与 Zod 验证。

Plugins：快速扩展与一键集成 ​

插件（Plugins） 将常用工具、Skill、MCP、Hook 进行打包，支持一键安装和升级。例如，mgrep 插件提供比 ripgrep 更强大的本地和 Web 搜索能力，typescript-lsp、pyright-lsp 则为 Claude 提供实时类型检查和代码智能补全。

安装插件示例：

bash
claude plugin marketplace add https://github.com/mixedbread-ai/mgrep
# 然后在 Claude 终端输入 /plugins，选择安装

插件同样会占用上下文窗口，建议按需启用，保持精简。

高效工作流技巧 ​

  • 并行开发：用 /fork 分支会话，或利用 git worktree 多目录并行运行 Claude，互不干扰。
  • tmux 持久化：长时间运行命令建议在 tmux 会话中执行，防止断线丢失进度。
  • mgrep 搜索：本地/网页内容一键搜索，效率远超传统 grep。
  • 自定义状态栏：显示当前用户、目录、分支、剩余上下文百分比、模型、时间、待办数等关键信息，便于全局把控。
  • 自动化 Hook：如保存后自动 prettier 格式化、tsc 校验、console.log 检查等。

编辑器选择与集成建议 ​

  • Zed（推荐）：Rust 编写，极致流畅，支持 Claude 实时文件跟踪、命令面板、Vim 模式，资源占用极低，适合大项目高频编辑。
  • VSCode / Cursor：支持官方插件，集成 LSP，自动同步 Claude 编辑，UI 友好，适合习惯主流 IDE 的开发者。

无论选择哪种编辑器，建议分屏操作（终端+编辑器），开启自动保存、Git 集成和文件监听，确保 Claude 与本地开发环境实时同步。

典型配置范例 ​

MCP 配置（仅启用必要项）：

json
{
  "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] },
  "supabase": { "command": "npx", "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=YOUR_REF"] },
  "memory": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-memory"] }
  // 其他 MCP 按需配置
}

常用 Hooks：

json
{
  "PreToolUse": [
    { "matcher": "npm|pnpm|yarn|cargo|pytest", "hooks": ["tmux reminder"] },
    { "matcher": "Write && .md file", "hooks": ["block unless README/CLAUDE"] }
  ],
  "PostToolUse": [
    { "matcher": "Edit && .ts/.tsx/.js/.jsx", "hooks": ["prettier --write"] },
    { "matcher": "Edit && .ts/.tsx", "hooks": ["tsc --noEmit"] }
  ]
}

Subagents 结构：

bash
~/.claude/agents/
  planner.md
  architect.md
  tdd-guide.md
  code-reviewer.md
  build-error-resolver.md
  e2e-runner.md
  refactor-cleaner.md
  doc-updater.md

关键总结 ​

  1. 配置越简洁，效率越高：Treat 配置如微调，避免复杂架构。
  2. 上下文窗口宝贵：禁用未用 MCP/插件，保持响应速度。
  3. 并行执行：善用 fork、git worktree、Subagent，提升多任务效率。
  4. 自动化一切重复操作：用 Hooks 实现格式化、校验、提醒等自动化。
  5. Subagent 权限最小化：只开放必要工具，保障安全与专注。

FAQ ​

Q: Skills 和 Commands 有什么本质区别？ A: Skills 是标准化、可复用的工作流定义，支持结构化内容和多文件扩展；Commands 主要是历史迁移期的斜杠命令兼容层，建议长期用 Skills 替代。

Q: MCP 太多会影响性能吗？如何管理？ A: 会。每启用一个 MCP/插件都会消耗 Claude 的上下文窗口，建议每个项目只启用 5~10 个，未用的及时禁用，保证响应速度和稳定性。

Q: 如何用 Hooks 实现自动化？ A: Hooks 支持在工具调用、文件编辑、命令执行等事件前后自动触发脚本或提醒，可用官方 hookify 插件用自然语言生成配置，极大提升自动化和规范执行。

友情链接： 能跑吗 · 打工算 · 车主算 · 开发工具 · 人工不智能

Copyright © 2026 地豆 蜀ICP备2021007188号 | 关于本站 | 隐私政策