everything-claude-code：生产环境使用的Claude Code配置模板

Claude Code 是一个将 Claude 模型嵌入终端开发环境的 AI 编码助手，能在你的代码库上直接读写、运行命令并协助开发。

这个仓库包含的内容由生产环境实践和真实项目经验打磨而成，适合想在 Claude Code 生态中高效工作的人使用。

这是把 Claude Code 当成工业流水线来用的完整实战说明书：从技能、钩子、子智能体到上下文管理的一整套成熟打法

这是一套经过十个月高强度实战打磨的 Claude Code 使用体系，完整覆盖技能、命令、钩子、子智能体、MCP、插件与上下文管理，目标只有一个：让编码像流水线一样稳定、高效、可扩展。

这个仓库主要按类别组织大量可直接集成到 Claude Code 配置里的文件：

Agents（代理）

* 拆分任务、专注不同职责的子智能体（planner、architect、code-reviewer、security-reviewer、e2e-runner 等）。
* 帮助 Claude Code 在复杂工作流中分工执行。
⚙️ Skills（技能）

* 定义常见开发流程或领域知识（如 TDD 流程、语言最佳实践、框架模式、工程指导）。
* 让 Claude 在执行命令时有流程性、重复性好的策略参考。

Commands（命令）

* 一键触发常用任务（例如 /plan 开始规划、/tdd 执行测试驱动开发、/code-review 做代码审查等）。
* 改善交互体验并提高效率。

Hooks（钩子）

* 响应特定事件自动触发操作（如工具使用前后、任务结束时自动检查或通知）。
* 支持自动化检测、格式化、反馈链路。

Rules（规则）

* 持续执行的条例（安全检查、编码风格要求、测试覆盖率标准等）。
* 可保证一致性和代码质量规范。

MCP 配置

* MCP（Model Control Protocol） 服务器配置集（如 GitHub、Supabase、Vercel 等）。
* 方便 Claude 访问外部服务（例如拉取 issue 数据、与数据库交互）。

Examples & Plugins

* 示例项目配置和插件说明，帮助你快速上手和扩展生态。

1. 克隆仓库：

bash
   git clone https://github.com/affaan-m/everything-claude-code.git
   

✅ 实战级配置：由真正用于生产的工作流打磨而成，有真实价值。([知心书签][3])
✅ 模块化可选：你可以只复制、启用你关心的部分。([GitHub][1])
✅ 提高效率：更规范的命令、规则与技能让 Claude 执行更一致、可靠。([GitHub][1])
✅ 扩展性强：支持自定义扩展（新的 agents、skills、hooks 或 MCP）。([GitHub][1])

这整套内容围绕一个现实问题展开：当 Claude Code 从玩具级尝试走向每天真实干活，复杂度自然爆炸。命令变多、工具变多、上下文变重、注意力被拉扯，效率反而下降。于是出现一个清晰方向：把 Claude Code 当成“可配置的生产系统”，通过技能定义流程，通过命令触发动作，通过钩子自动纠偏，通过子智能体拆分脑力，通过 MCP 接入外部世界，再通过严格的上下文管理保持性能稳定。这不是灵感清单，而是一套已经跑过真实项目、拿过黑客松结果的可复用结构。

这套配置来源于持续十个月的日常使用，从 Claude Code 实验阶段开始参与，完整经历从早期不稳定到可规模化使用的全过程，并且在 Anthropic 与 Forum Ventures 联合举办的黑客松中，完全使用 Claude Code 构建项目并取得成果。整个体系并非展示技巧，而是为长期高频使用而生，因此每一项设计都服务于“减少摩擦、保持节奏、避免上下文浪费”。

第一大件技能包——把常用咒语写成快捷符

Claude Code的skills文件夹就像游戏里的宏命令，把一长串咒语缩成一个/键。

想删废代码？以前得喊“请把未引用函数、空readme、临时注释统统干掉”，现在直接敲/refactor-clean，AI立刻懂行：先扫全文件树，把没被import的函数标红，再把空白markdown丢进回收站，最后给变量名做一次瘦身SPA，三分钟完事。

测试套娃也有三连击：/tdd先搭骨架，/e2e把浏览器开起来点点点，/test-coverage把报告刷到80 %以上，一条命令下去，红色区域瞬间变绿。

技能还能套娃，写codemap-updater技能，让AI每跑完一个里程碑就自动刷新代码地图，像迷宫游戏更新小地图，主脑不用重复“这是哪我又在哪”，省下的上下文全拿去写新功能。

技能在这套体系中承担“流程模板”的角色。一次成熟的开发流程往往包含多个固定步骤，例如测试驱动、重构清理、安全审查。技能通过 Markdown 文件固化这些步骤，限定使用范围与执行顺序，相当于把一段很长的提示词压缩成一个可以随时调用的能力模块。

命令是技能的快捷入口，通过斜杠触发，减少输入成本。一次长时间编码结束后，代码库里自然会出现冗余文件与无效逻辑，于是一个 /refactor-clean 就能触发清理流程。需要测试时，/tdd、/e2e、/test-coverage 顺序连用即可。技能与命令支持链式组合，多个流程在一次提示中连续执行，节奏连贯，上下文集中。

技能文件结构清晰可维护，例如：

~/.claude/skills/
  pmx-guidelines.md
  coding-standards.md
  tdd-workflow/
  security-review/

这种结构让流程本身成为第一公民，而不是临时对话产物。

Codemap 技能：为上下文节省而生的导航机制

在大型代码库中，最浪费上下文的行为来自探索文件结构。为此引入 codemap 更新技能，在关键节点生成或更新代码地图，让 Claude 快速理解项目结构而无需反复扫描文件内容。这个做法本质上是用磁盘换上下文，用结构化摘要代替实时探索，从而提升长会话稳定性。

第二大件钩子——像老妈一样盯现场

钩子承担自动化监督角色，绑定在工具调用和生命周期节点上。与技能不同，钩子不关心业务流程，只关心行为发生的瞬间是否需要校验、提醒或补救。

钩子类型覆盖多个阶段，包括工具执行前、执行后、用户提交提示、响应结束、上下文压缩前、权限请求等。一个典型例子是在运行 npm、pytest 等长任务前，自动提醒开启 tmux，避免会话中断。

示例如下：

{
  "PreToolUse": [
    {
      "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm|pnpm|yarn|cargo|pytest)\"",
      "hooks": [
        {
          "type": "command",
          "command": "if [ -z \"$TMUX\" ]; then echo '[Hook] Consider tmux for session persistence' >&2; fi"
        }
      ]
    }
  ]
}

这种提醒在行为发生前出现，形成条件反射式规范执行。

钩子分五种姿势：PreToolUse、PostToolUse、UserPromptSubmit、Stop、Notification，作用就是“关键时刻拽一把”。

PreToolUse最像老妈提醒：检测到命令里出现npm、pnpm、yarn、cargo、pytest，立刻问一句“挂tmux没？”——要是没挂，就在终端飘红字“长命令易挂，先tmux保平安”，省得跑半小时测试突然断网全白给。

PostToolUse像自动保洁：每改完.ts/.tsx，马上prettier --write抹平缩进，再tsc --noEmit扫一遍类型，console.log直接亮黄灯“这玩意儿敢上库？”

Stop钩子像下班前保安：会话一结束，钩子把今天所有改过的文件翻一遍，发现console.log就弹窗“想偷偷留痕迹？没门！”

最爽的是hookify插件，不用手搓JSON，直接/claude说“我想在git push前打开编辑器”，插件咔咔生成钩子，一分钟上线。

Hookify 插件：把配置工作变成对话：手写 JSON 容易出错，也消耗注意力。hookify 插件提供对话式创建钩子的能力，通过 /hookify 描述目标行为，自动生成配置。配置工作本身被流程化，避免人为失误，同时降低学习成本。

第三大件小分身——子智能体：把一个大脑拆成多个专用工位

子智能体在体系中承担“任务外包”的角色。主 Claude 负责调度，子智能体在限定范围内执行具体任务。每个子智能体拥有清晰职责，例如规划、架构设计、测试驱动、代码审查、安全分析、构建错误修复、端到端测试、重构清理。

主脑像总指挥，小分身（子智能体）就是包工队，工具箱只给锤子就不会乱拿电锯。

子智能体目录结构示例如下：

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

每个子智能体都可以限定可用工具、可访问 MCP、权限范围，确保行为聚焦，避免上下文污染。主智能体通过委派获得更干净的注意力空间。

planner分身专画蓝图：接到“做个购物车”需求，先拆数据库表、接口、组件三层，再按依赖排序，输出一张可执行任务清单，主脑直接点头“开工”。

security-reviewer分身像安检员：代码一提交，立刻扫依赖库漏洞、查硬编码密钥、看SQL注入，报告标红处直接附修复链接，主脑不用二次翻书。

e2e-runner分身是机器人测试员： playwright一开，自动把注册、登录、下单、支付跑一遍，截图+视频+日志打包发邮箱，主脑继续写下一个功能。
分身还能后台挂机，主脑上下文稳在70 k以内，像手机清后台，流畅度瞬间+50。

第四大件MCP——把外部世界装进背包

MCP不是普通API，它像随身仓库，数据库、浏览器、部署平台一键开门。

MCP（Model Context Protocol）用于连接外部服务，例如 GitHub、Supabase、Vercel、数据库、文档系统。MCP 本质上是提示驱动的服务封装，让 Claude 能直接浏览、查询、操作外部系统。

Supabase MCP最直观：直接让AI在终端跑SQL，select * from users where last_login < now() - interval '7 days'，结果秒回，不用来回切网页复制粘贴。

Chrome MCP更离谱：AI自己点开浏览器，输入网址，点按钮，截全屏，像雇了个实习生帮看“这按钮是不是绿的”。允许 Claude 操作浏览器，模拟点击与观察行为，用于探索未知界面。

Vercel、Railway、Cloudflare全家桶MCP把部署日志、环境变量、DNS记录全拉到终端，一条命令看全球节点状态，像坐进飞船仪表盘。

但MCP是内存老虎，装20个只剩70 k窗口，策略是“全装后关”：用户目录配置14个，项目目录再关9个，日常只留5个，性能与功能兼得。

规则与长期记忆：永远执行的行为底线

规则文件用于定义始终生效的原则，例如安全、编码风格、测试要求、Git 流程、性能管理、子智能体调度条件。这些规则不依赖具体任务，而是像项目宪法一样持续存在。

规则可以集中在一个 CLAUDE.md 文件中，也可以拆分为模块化文件：

~/.claude/rules/
  security.md
  coding-style.md
  testing.md
  git-workflow.md
  agents.md
  performance.md

示例规则包括禁止提交 console.log、保持模块化结构、部署前完成测试、前端避免特定色系等。这些规则通过持续注入上下文，形成稳定行为模式。

security.md写“不允许硬编码密码”，AI一旦检测到字符串里夹带“sk-”就自动停笔。
coding-style.md写“函数体超50行直接拆”，AI写完立刻提示“这函数快成论文了，拆不拆？”
testing.md写“覆盖率低于80 %不许push”，AI跑完测试一看79 %，立刻补用例，像驾校教练坐副驾。

插件市场——像App Store一样点点装

插件=技能+MCP+钩子三合一套餐，装完即用。

typescript-lsp与pyright-lsp给AI装上语法望远镜，变量类型一跳就懂，少写两行 debug print。
mgrep插件把搜索升级成涡轮增压：本地搜“function handleSubmit”秒回，后面加--web还能搜“Next.js 15 app router changes”，直接返回 curated 答案，比谷歌翻十页靠谱。

装插件只要三步：claude plugin marketplace add网址，打开/plugins面板，点击install，全程像给手机换皮肤，30秒搞定。

编辑器搭档——Zed当驾驶舱

Claude Code 可独立运行于终端，但配合编辑器能获得更好体验。Zed 编辑器因性能、集成与轻量化成为首选。其优势包括实时文件追踪、快速命令面板、资源占用低、Vim 模式支持。
通过快捷键可快速定位 Claude 正在编辑的文件，开启自动保存确保文件状态同步，使用 Git 集成功能审查修改。
VSCode 与 Cursor 同样可用，支持终端模式或扩展模式，适合已有生态用户。

Claude Code裸跑终端也能飞，但配上Zed就像开高达。
Zed用Rust写的，启动速度比记事本还快，大仓库秒开不卡。

Agent Panel实时同步文件变动，AI改一行，编辑器立刻跳一行，像看直播弹幕。
Cmd+Shift+R呼出命令转盘，所有自定义/技能一字排开，想跑/tdd直接敲回车，不用切终端。
Ctrl+G一键把AI正在改的文件拉到前台，边看边喝可乐，省得来回cd。
自动保存+文件热重载保证AI读到的永远最新版，像给赛车换轮胎不熄火。

平行宇宙——git worktree + /fork双刷

同一仓库多个分支并行开发？git worktree add ../feature-a feature-a，再开一个新终端，独立node_modules，独立Claude会话，两边互不打扰，像开两台电脑。
对话内也能/fork，主线程聊前端，分身线程聊后端，两条时间线一起推，最后合并PR，时间成本砍半。

状态栏血条——把信息刷成HUD

自定义/statusline显示：当前用户@目录名｜git分支 脏标记｜上下文剩余%｜模型名｜时间｜待办数，像游戏左上角血条+蓝条+任务数，一眼判断“还能写多少代码”“分支干净不”“该push了不”。

键盘快捷键——秒操不废话

Ctrl+U整行清空，比狂按Backspace快十倍；
!直接切bash，@秒搜文件，/呼命令，Shift+Enter多行输入，Tab开关思考面板，Esc Esc紧急刹车，像格斗游戏搓招。

tmux保命术——长命令不断线

高频快捷键用于降低操作摩擦，例如删除整行、快速 Bash 前缀、文件搜索、斜杠命令、思考展示切换、中断恢复等。

并行工作通过 /fork 分叉对话实现，避免串行等待。更复杂场景使用 Git worktree，为每个任务创建独立工作区，同时运行多个 Claude 实例，互不干扰。

tmux 用于承载长时间运行任务，允许随时分离与重连，保证流程不中断。

tmux new -s dev，AI在里面跑npm run dev，日志刷得飞起，人走开去倒水，回来tmux attach -t dev继续看，断网也不慌，像游戏存档点。

窗口管理底线——70 k红线

上下文窗口是最稀缺资源。启用过多 MCP、插件、工具会快速侵蚀可用上下文，导致性能下降。实践经验显示，配置层面可以保留二十到三十个 MCP，但每个项目启用数量控制在五到六个，工具总数控制在八十以内，才能保持稳定。

通过 /plugins 或 /mcp 命令随时查看启用状态，按项目禁用不相关 MCP，从源头控制上下文体积。

200 k总量，MCP+插件+上下文一起啃，剩70 k是舒适区，低于50 k就开始丢历史，像手机内存红条，及时/compact清缓存，保持流畅。

关键结论与实践原则

配置应当像微调而非架构设计，持续演进而非一次性定型。上下文窗口管理决定性能上限。并行执行释放时间。重复行为通过钩子自动化。子智能体通过权限收敛获得更高质量输出。