Everything Claude Code 完整教程：让 AI 编码能力放大 10 倍
来源：https://github.com/affaan-m/everything-claude-code | 140K+ Stars | Anthropic 黑客松获胜作品
前言
Everything Claude Code（以下简称 ECC）是一套经过 10 个月高强度真实产品开发迭代打磨出来的 Claude Code 配置集合。它不是零散的配置项，而是一套完整系统——包含 36 个专用子智能体、183 个技能模块、79 条命令，以及规则、钩子、记忆持久化、安全扫描等基础设施。
这套系统可在 Claude Code、Codex、Cursor、OpenCode、Gemini 等主流 AI 编码框架中通用。
一、核心架构解析
理解 ECC，先理解它的五大组件：
1.1 Agents（子智能体）
ECC 内置 36 个专用子智能体，每个只做一件事，但做得非常专业：
planner.md— 功能实现规划architect.md— 系统架构设计决策code-reviewer.md— 代码质量与安全审查security-reviewer.md— 漏洞分析tdd-guide.md— 测试驱动开发build-error-resolver.md— 构建错误修复e2e-runner.md— Playwright 端到端测试- 以及 Go、C++、Rust、Python、Java、Kotlin 等语言专项审查智能体
当你有一个复杂任务时，可以委派给最合适的子智能体，而不是在一个会话里让主模型处理所有事情。
1.2 Skills（技能模块）
Skills 是 ECC 最强大的部分——183 个领域特定的工作流定义和知识库。涵盖：
开发栈：
backend-patterns/— API、数据库、缓存设计模式frontend-patterns/— React、Next.js 开发模式golang-patterns/— Go 语言惯用写法python-patterns/— Python 最佳实践django-*/— Django 全栈系列（Django patterns/security/TDD/verification）laravel-*/— Laravel 系列springboot-*/— Spring Boot 系列cpp-coding-standards/— 遵循 C++ Core Guidelines
工程能力：
tdd-workflow/— 测试驱动开发方法论security-review/— 安全检查清单deployment-patterns/— CI/CD、Docker、健康检查、回滚docker-patterns/— 容器安全e2e-testing/— Playwright 页面对象模型api-design/— REST API 设计、分页、错误响应
效率工具：
continuous-learning/— 从会话中自动提取模式continuous-learning-v2/— 带置信度评分的本能学习系统eval-harness/— 验证循环评估verification-loop/— 持续验证机制cost-aware-llm-pipeline/— LLM 成本优化、模型路由
运营与媒体：
content-engine/— 多平台社交内容创作market-research/— 市场与竞品研究investor-materials/— 融资路演材料manim-video/、remotion-video-creation/— 视频生成
1.3 Commands（命令）
79 条斜杠命令，提供传统兼容层，例如：
/plan— 生成实现规划/tdd— 启动测试驱动开发/code-review— 代码审查/e2e— 生成端到端测试/learn— 从当前会话提取模式/multi-plan— 多智能体任务拆解/security-scan— 运行安全审计
1.4 Rules（规则）
必须遵守的编码规范，复制到 ~/.claude/rules/ 后自动生效：
rules/common/— 通用原则（文件组织、Git 工作流、测试、性能、安全）rules/typescript/— TypeScript 专属规范rules/golang/— Go 专属规范rules/python/— Python 专属规范
1.5 Hooks（钩子）
基于触发器的自动化逻辑，实现会话生命周期管理：
session-start.js— 会话启动时自动加载上下文session-end.js— 会话结束时保存状态pre-compact.js— 上下文精简前状态保存suggest-compact.js— 策略性精简建议evaluate-session.js— 从会话中提取模式
二、安装配置（插件方式）
2.1 环境要求
- Claude Code CLI v2.1.0 或更高
- Node.js 18+（用于脚本运行）
# 查看当前版本
claude --version
2.2 安装步骤
第一步：添加插件市场并安装
# 添加市场
/plugin marketplace add https://github.com/affaan-m/everything-claude-code
# 安装插件
/plugin install everything-claude-code@everything-claude-code
注意：插件标识符统一为
everything-claude-code@everything-claude-code，旧别名已废弃。
第二步：克隆仓库并安装规则（必需）
插件无法自动分发 rules 目录，必须手动复制：
# 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
# 安装依赖
npm install # 或 pnpm install | yarn install | bun install
# 复制规则（插件安装路径）
mkdir -p ~/.claude/rules
cp -R rules/common ~/.claude/rules/
cp -R rules/typescript ~/.claude/rules/
Windows 系统：
New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules" | Out-Null
Copy-Item -Recurse rules/common "$HOME/.claude/rules/"
Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"
⚠️ 重要警告：如果已经通过
/plugin install安装了 ECC，不要再运行./install.sh --profile full，这会导致技能和规则重复，引发运行时行为异常。
第三步：验证安装
# 尝试一个命令
/ecc:plan "添加用户认证"
/plugin list everything-claude-code@everything-claude-code
安装完成后，你立即拥有：36 个智能体 + 183 个技能 + 79 条命令。
三、插件安装后的手动配置
ECC 的规则需要手动复制，但复制时有讲究：
3.1 复制整个语言目录，不要复制单个文件
# ✅ 正确：复制整个目录
cp -R rules/common ~/.claude/rules/
cp -R rules/typescript ~/.claude/rules/
cp -R rules/golang ~/.claude/rules/
# ❌ 错误：只复制单个文件
cp rules/common/coding-style.md ~/.claude/rules/
复制整个目录是为了保证相对路径引用正常、文件名不会冲突。
3.2 按需选择规则集
ECC 支持按语言选择性安装：
| 语言 | 规则目录 |
|---|---|
| TypeScript/JavaScript | rules/typescript/ |
| Go | rules/golang/ |
| Python | rules/python/ |
| Swift | rules/swift/ |
| PHP | rules/php/ |
| 通用（必装） | rules/common/ |
如果你的项目是纯 TypeScript，只需要安装 common + typescript 两个规则集。
四、多模型协作系统（ccg-workflow）
4.1 什么是 CCG
CCG = Claude + Codex + Gemini，是 ECC 生态中的多模型协作运行时，让三个模型协同工作（Claude 推理审查、Codex 写代码、Gemini 做规划）。
4.2 安装
npx ccg-workflow
首次运行会进入交互式初始化向导，要求配置三个模型：
# 非交互模式快速初始化
npx ccg-workflow init \
--frontend claude,codex \
--backend codex,gemini \
--mode parallel
4.3 启用多模型命令
安装 ccg-workflow 后，以下命令才能使用：
/multi-plan— 多智能体任务拆解/multi-execute— 多智能体工作流编排/multi-backend— 后端多服务编排/multi-frontend— 前端多服务编排/multi-workflow— 通用多服务工作流
4.4 单模型用户的使用建议
如果你只有一个模型，不建议安装 ccg-workflow——它专为多模型协作设计，单模型无法发挥其价值。但 ECC 本身的核心功能（规则、技能、命令、钩子）对单模型用户完全可用。
五、最佳实践
5.1 从 /plan 开始每个任务
面对复杂功能时，先让 ECC 的 planner 智能体规划实现路径：
/plan "实现一个支持 JWT 的用户认证系统"
planner 会输出清晰的步骤分解，你再逐个执行或委派给专项智能体。
5.2 TDD 工作流：先写测试，再写代码
/tdd "用户登录接口"
TDD 模式下，ECC 会先要求你写测试用例，运行失败后再实现功能，确保测试覆盖率。
5.3 代码审查不跳过
每次功能完成后，运行：
/code-review
ECC 的审查规则包括安全检查（SQL 注入、XSS、敏感信息泄露等），比单纯格式检查更有价值。
5.4 利用 Hooks 实现记忆持久化
ECC 的 memory-persistence 钩子会自动在会话结束时保存上下文，下一次会话开始时自动恢复。
要启用这个功能，需要在 ~/.claude/ 目录下正确配置钩子路径。配置好后，你的项目上下文、项目规范、待办事项都会跨会话保留。
5.5 持续学习：用 /learn 提取模式
当你用一个巧妙的方式解决了某个问题，告诉 ECC：
/learn
ECC 会分析本次会话，提取可重用的模式，保存到技能文件中。长期积累下来，它会更懂你的代码风格和业务逻辑。
进阶用法——提取并评估：
/learn-eval
5.6 定期运行安全扫描
# 快速扫描
npx ecc-agentshield scan
# 自动修复
npx ecc-agentshield scan --fix
# 深度分析（调用 3 个 Opus 4.6 智能体）
npx ecc-agentshield scan --opus --stream
建议将安全扫描集成到 CI 流程中，在代码合入前发现安全问题。
5.7 包管理器自动适配
ECC 会按以下优先级自动检测你的首选包管理器：
CLAUDE_PACKAGE_MANAGER环境变量.claude/package-manager.json项目配置package.json的packageManager字段- 锁文件（package-lock.json / yarn.lock / pnpm-lock.yaml / bun.lockb）
- 全局配置
~/.claude/package-manager.json
设置偏好：
export CLAUDE_PACKAGE_MANAGER=pnpm
# 或在 Claude Code 中：
/setup-pm
六、安全能力：AgentShield
ECC 配套的 AgentShield 是专门为 AI 编码智能体设计的安全审计工具，在 Anthropic 黑客松中开发完成，包含 1282 项测试、98% 覆盖率。
扫描范围：
- 密钥泄露检测（14 种模式）
- 权限审计
- 钩子注入分析
- MCP 服务风险评估
- 智能体配置审查
使用方式：
# 在 Claude Code 中直接运行
/security-scan
# 或通过 npm
npx ecc-agentshield scan
发现严重问题时返回退出码 2，可用于构建 CI/CD 门禁，阻止有安全隐患的代码合入。
七、持续学习系统（Continuous Learning v2）
ECC 的学习系统会从你的每次会话中提取模式，不断进化。
7.1 核心命令
/instinct-status # 查看已学习的本能（带置信度评分）
/instinct-import <file> # 导入他人分享的本能
/instinct-export # 导出你的本能以供分享
/evolve # 将相关本能聚类到技能中
/promote # 将项目级本能提升为全局本能
/projects # 查看已识别项目与本能统计
/prune # 删除过期的本能
7.2 工作原理
/learn从当前会话提取模式和解决方案- 这些模式以"本能"形式存储，有置信度评分
/evolve将相关本能聚类，形成新的技能- 技能可被复用，让未来的任务执行更符合你的项目规范
八、生态工具
8.1 技能创建器
两种方式从你的仓库生成技能：
方式 A：本地分析（内置）
/skill-create # 分析当前仓库
/skill-create --instincts # 同时生成本能
方式 B：GitHub 应用（高级）
适用于 10K+ 提交量、自动 PR、团队共享场景。
8.2 跨平台支持
ECC 现已全面支持 Windows、macOS、Linux，并深度集成 Cursor、OpenCode、Antigravity 等主流 IDE。所有钩子与脚本均使用 Node.js 重写，跨平台兼容性良好。
九、配置示例参考
ECC 在 examples/ 目录下提供了多个真实项目的配置参考：
saas-nextjs-CLAUDE.md— Next.js + Supabase + Stripe 的真实 SaaS 项目go-microservice-CLAUDE.md— gRPC + PostgreSQL 的 Go 微服务django-api-CLAUDE.md— DRF + Celery 的 Django REST APIlaravel-api-CLAUDE.md— PostgreSQL + Redis 的 Laravel APIrust-api-CLAUDE.md— Axum + SQLx + PostgreSQL 的 Rust API
这些不是玩具示例，而是可以直接参考并应用到真实项目的配置模板。
十、常见问题
Q：安装了插件还需要手动复制规则吗？
需要。Claude Code 插件系统有技术限制，无法自动分发 rules 目录。必须手动复制，且只需复制 rules/ 目录，不要再运行完整安装脚本（./install.sh --profile full），否则会导致内容重复。
Q：单模型用户能用 ECC 吗？
完全可以。ECC 的核心功能（183 个技能、79 条命令、36 个智能体、规则系统、钩子系统）对单模型完全可用。只有 multi-* 系列命令需要 ccg-workflow 多模型运行时，单模型用户不需要安装 ccg-workflow。
Q：多版本 Node.js 环境会有问题吗？
ECC 的脚本使用 Node.js 重写，不依赖特定系统工具。建议使用 Node.js 18+。ECC 会自动检测并使用正确的包管理器（npm/pnpm/yarn/bun）。
Q：如何更新 ECC？
# 重新安装插件（会自动更新）
/plugin install everything-claude-code@everything-claude-code
# 规则需要手动同步
git pull
cp -R rules/* ~/.claude/rules/
十一、进阶技巧
11.1 上下文精简策略
ECC 提供了两种上下文精简方案：
自动精简：ECC 的钩子系统会在会话过程中监控 Token 使用量，当上下文接近上限时自动触发精简建议。
手动精简：使用战略级精简工具 strategic-compact，它会分析当前会话中的信息密度，保留高价值内容（决策、结论、待办），压缩低价值内容（临时调试输出、重复确认等）。
# 触发手动精简
/pre-compact
11.2 检查点机制
对于长时间运行的任务，使用检查点保存验证状态：
/checkpoint save
这样即使会话中断，也能从检查点恢复，而不是从头开始。
11.3 多智能体并行执行
当任务可以分解为独立子任务时，使用多智能体并行：
/multi-execute "前端组件开发" "后端API开发" "测试用例编写"
三个任务会同时进行，ECC 会自动合并结果。适合时间敏感的项目发布前夕。
11.4 子智能体委派时机
ECC 的 agents.md 规则定义了何时应该委派给子智能体：
- 任务复杂度高（涉及多个模块或技术栈）时委派
- 需要专项深度（如安全审查、C++ 优化）时委派
- 任务可并行拆分 时使用 multi-execute
- 避免过度委派：简单任务直接做，不要为了用智能体而用智能体
11.5 验证循环
ECC 的验证机制不只是一次性测试，而是持续验证：
/verify
验证循环会在每次代码变更后自动运行相关测试，发现回归立即报告。建议在 /checkpoint 保存后启动验证循环，确保后续工作建立在正确的基础上。
11.6 项目级配置 vs 全局配置
ECC 支持两层配置：
全局配置（~/.claude/）：适用所有项目的默认设置，包括通用规则、全局钩子。
项目级配置（项目根目录的 CLAUDE.md）：只针对当前项目的规范和上下文。ECC 提供了 examples/saas-nextjs-CLAUDE.md 等真实项目模板，可以直接参考并修改为你的项目配置。
项目级配置会覆盖全局配置，优先级明确。
结语
Everything Claude Code 不仅仅是一个配置集合，它是经过真实产品开发验证的 AI 编码方法论。从 Token 优化、内存持久化到持续学习、安全扫描，ECC 把一个通用 AI 编码工具塑造成了真正懂得你项目、能为你的代码质量负责的智能助手。
建议从插件安装开始，先体验核心命令（/plan、/code-review、/tdd），感受它的风格后再逐步深入高级功能。
