Everything Claude Code 项目完全指南
将 Claude Code 打造成专业开发环境的终极配置工具包
一、项目简介
什么是 Everything Claude Code?
Everything Claude Code 是一个由 Anthropic 黑客松冠军 Affaan Mustafa 创建的开源项目,提供了一套完整的 Claude Code 配置集合,包括:
- Agents(代理):专业化的子代理用于任务委派
- Skills(技能):工作流定义和领域知识
- Hooks(钩子):基于触发器的自动化
- Commands(命令):快速执行的斜杠命令
- Rules(规则):始终遵循的开发准则
- MCP Configs(MCP 配置):多模态聊天协议服务器配置
这些配置是作者经过 10 个多月的密集日常使用,在构建真实产品过程中不断打磨形成的"实战验证"配置。
项目背景
Affaan Mustafa 自 Claude Code 实验性发布以来就一直在使用它。2025 年 9 月,他与队友 @DRodriguezFX 使用这套配置,仅用 8 小时就完全使用 Claude Code 构建了 zenith.chat,并赢得了 Anthropic x Forum Ventures 黑客松。
解决的问题
- 上下文腐化:长会话中的上下文管理问题
- 代码质量不一致:缺乏统一的代码标准
- 重复解释浪费时间:每次都要重新说明项目规范
二、核心组件详解
2.1 Agents(代理)
子代理是具有有限范围的委派任务处理器。项目提供了多个专业代理:
| 代理名称 | 功能说明 |
|---|---|
planner.md | 功能实现规划 |
architect.md | 系统设计决策 |
tdd-guide.md | 测试驱动开发 |
code-reviewer.md | 代码质量和安全审查 |
security-reviewer.md | 漏洞分析 |
build-error-resolver.md | 构建错误解决 |
e2e-runner.md | Playwright E2E 测试 |
refactor-cleaner.md | 死代码清理 |
doc-updater.md | 文档同步 |
项目还提供了针对特定语言的代理,如 Go 代码审查、Go 构建错误解决等,你可以根据自己使用的技术栈选择性启用。
代理配置示例:
---
name: code-reviewer
description: Reviews code for quality, security, and maintainability
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---
You are a senior code reviewer...
2.2 Skills(技能)
技能是工作流定义,可被命令或代理调用:
| 技能目录 | 说明 |
|---|---|
coding-standards/ | 多语言最佳实践 |
backend-patterns/ | API、数据库、缓存模式 |
frontend-patterns/ | React、Next.js、Vue 等前端模式 |
continuous-learning/ | 从会话中自动提取模式 |
continuous-learning-v2/ | 基于直觉的学习系统 |
iterative-retrieval/ | 子代理的渐进式上下文细化 |
tdd-workflow/ | TDD 方法论 |
security-review/ | 安全检查清单 |
项目还提供了针对特定语言的技能(如 Go、Python、TypeScript 等),你可以根据项目需要选择性使用。
TDD 工作流示例:
# TDD Workflow
1. Define interfaces first
2. Write failing tests (RED)
3. Implement minimal code (GREEN)
4. Refactor (IMPROVE)
5. Verify 80%+ coverage
2.3 Commands(斜杠命令)
快速执行的命令,提高开发效率:
通用命令:
| 命令 | 功能 |
|---|---|
/tdd | 测试驱动开发 |
/plan | 实现规划 |
/e2e | E2E 测试生成 |
/code-review | 代码质量审查 |
/build-fix | 修复构建错误 |
/refactor-clean | 死代码移除 |
/learn | 提取会话中的模式 |
/checkpoint | 保存验证状态 |
/verify | 运行验证循环 |
/skill-create | 从 git 历史生成技能 |
/instinct-status | 查看学习到的直觉 |
/evolve | 将直觉聚类为技能 |
项目还提供了针对特定语言的命令(如
/go-review、/go-test等),支持多种编程语言。
2.4 Rules(规则)
始终遵循的开发准则,保持代码一致性:
| 规则文件 | 说明 |
|---|---|
security.md | 强制安全检查(禁止硬编码密钥) |
coding-style.md | 不可变性、文件组织 |
testing.md | TDD、80%覆盖率要求 |
git-workflow.md | 提交格式、PR 流程 |
agents.md | 何时委派给子代理 |
performance.md | 模型选择、上下文管理 |
2.5 Hooks(钩子)
基于事件触发的自动化:
{
"matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
"hooks": [{
"type": "command",
"command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
}]
}
钩子类型包括:
PreToolUse:工具使用前PostToolUse:工具使用后Stop:会话结束时- 会话生命周期钩子
2.6 生态系统工具
Skill Creator(技能创建器)
两种方式从仓库生成技能:
方式 A:本地分析(内置)
/skill-create # 分析当前仓库
/skill-create --instincts # 同时生成直觉
方式 B:GitHub App(高级)
适用于 10k+ 提交、自动 PR、团队共享等高级功能。
Continuous Learning v2(持续学习 v2)
基于直觉的学习系统,自动学习你的编程模式:
/instinct-status # 显示学习到的直觉及置信度
/instinct-import <file> # 从他人导入直觉
/instinct-export # 导出直觉用于分享
/evolve # 将相关直觉聚类为技能
三、安装指南
3.1 方式一:作为插件安装(推荐)
# 1. 添加市场源
/plugin marketplace add affaan-m/everything-claude-code
# 2. 安装插件
/plugin install everything-claude-code@everything-claude-code
或者直接编辑配置文件 ~/.claude/settings.json:
{
"extraKnownMarketplaces": {
"everything-claude-code": {
"source": {
"source": "github",
"repo": "affaan-m/everything-claude-code"
}
}
},
"enabledPlugins": {
"everything-claude-code@everything-claude-code": true
}
}
注意:Claude Code 插件系统不支持通过插件分发 rules,需要手动安装:
# 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
# 方式 A:用户级规则(应用于所有项目)
cp -r everything-claude-code/rules/* ~/.claude/rules/
# 方式 B:项目级规则(仅应用于当前项目)
mkdir -p .claude/rules
cp -r everything-claude-code/rules/* .claude/rules/
3.2 方式二:手动安装
如果你想要更精细的控制:
# 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
# 复制 agents
cp everything-claude-code/agents/*.md ~/.claude/agents/
# 复制 rules
cp everything-claude-code/rules/*.md ~/.claude/rules/
# 复制 commands
cp everything-claude-code/commands/*.md ~/.claude/commands/
# 复制 skills
cp -r everything-claude-code/skills/* ~/.claude/skills/
配置 Hooks
将 hooks/hooks.json 中的钩子配置复制到 ~/.claude/settings.json。
配置 MCPs
将 mcp-configs/mcp-servers.json 中需要的 MCP 服务器配置复制到 ~/.claude.json。
重要:将 YOUR_*_HERE 占位符替换为你的实际 API 密钥。
四、最佳实践
4.1 上下文窗口管理
关键提醒:不要同时启用所有 MCP!
你的 200k 上下文窗口可能因为启用太多工具而缩减到 70k。
经验法则:
- 配置 20-30 个 MCP
- 每个项目保持少于 10 个启用
- 保持少于 80 个活跃工具
使用项目配置中的 disabledMcpServers 禁用未使用的服务器。
4.2 定制化建议
这些配置适用于作者的工作流,你应该:
- 从共鸣的部分开始 - 选择对你有用的组件
- 根据技术栈修改 - 适配你的项目需求
- 移除不用的部分 - 保持配置精简
- 添加自己的模式 - 持续迭代优化
4.3 跨平台支持
该插件完全支持 Windows、macOS 和 Linux。所有钩子和脚本都已用 Node.js 重写,以获得最大兼容性。
五、项目结构概览
everything-claude-code/
├── .claude-plugin/ # 插件和市场清单
│ ├── plugin.json # 插件元数据和组件路径
│ └── marketplace.json # 市场目录
├── agents/ # 专业化子代理
├── skills/ # 工作流定义和领域知识
├── commands/ # 斜杠命令
├── rules/ # 始终遵循的准则
├── hooks/ # 基于触发器的自动化
│ └── hooks.json
├── scripts/ # 跨平台 Node.js 脚本
│ ├── lib/ # 共享工具
│ ├── hooks/ # 钩子实现
│ └── tests/ # 测试套件
├── contexts/ # 动态系统提示注入上下文
├── examples/ # 示例配置和会话
└── mcp-configs/ # MCP 服务器配置
六、常用工作流示例
6.1 TDD 开发流程
# 启动 TDD 工作流
/tdd
# Claude 将引导你:
# 1. 定义接口
# 2. 编写失败的测试(红灯)
# 3. 实现最小代码(绿灯)
# 4. 重构(改进)
# 5. 验证 80%+ 覆盖率
6.2 代码审查
# 启动代码审查
/code-review
# Claude 将检查:
# - 代码质量
# - 安全性问题
# - 可维护性
6.3 功能规划
# 规划新功能
/plan
# Claude 将协助:
# - 需求分析
# - 架构设计
# - 实现步骤拆分
6.4 构建错误修复
# 修复构建错误
/build-fix
# Claude 将自动:
# - 分析错误日志
# - 定位问题根源
# - 提供修复方案
6.5 持续学习与技能演进
# 从当前仓库生成技能
/skill-create
# 查看学习到的直觉
/instinct-status
# 将直觉聚类为技能
/evolve
七、总结
Everything Claude Code 是一个强大的配置工具包,能够将原生的 Claude Code 转变为一个功能完善的开发环境。它的核心价值在于:
- 实战验证 - 来自黑客松冠军的 10 个月日常使用经验
- 模块化设计 - 可以按需选择和定制组件
- 专业化分工 - 通过子代理实现任务委派
- 自动化增强 - 通过钩子实现工作流自动化
- 持续学习 - 能够从你的编程模式中学习
无论你是 Claude Code 新手还是资深用户,这个项目都能帮助你提升开发效率,建立更一致的代码质量标准。
相关链接
- GitHub 仓库:affaan-m/everything-claude-code