Everything Claude Code 项目完全指南,如何优雅的使用Claude

26 阅读7分钟

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.mdPlaywright 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实现规划
/e2eE2E 测试生成
/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.mdTDD、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 定制化建议

这些配置适用于作者的工作流,你应该:

  1. 从共鸣的部分开始 - 选择对你有用的组件
  2. 根据技术栈修改 - 适配你的项目需求
  3. 移除不用的部分 - 保持配置精简
  4. 添加自己的模式 - 持续迭代优化

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 转变为一个功能完善的开发环境。它的核心价值在于:

  1. 实战验证 - 来自黑客松冠军的 10 个月日常使用经验
  2. 模块化设计 - 可以按需选择和定制组件
  3. 专业化分工 - 通过子代理实现任务委派
  4. 自动化增强 - 通过钩子实现工作流自动化
  5. 持续学习 - 能够从你的编程模式中学习

无论你是 Claude Code 新手还是资深用户,这个项目都能帮助你提升开发效率,建立更一致的代码质量标准。


相关链接