引言

“好的工具配置能让 AI 助手从’能用’变成’好用’，从’助手’变成’伙伴’。”

这是"一天一个开源项目"系列的第1篇文章。今天带你了解的项目是 everything-claude-code（GitHub）。

如果你正在使用 Claude Code（Claude Desktop 的代码编辑功能），或者对 AI 辅助编程感兴趣，那么这个项目绝对值得你深入了解。它不仅仅是一个配置集合，更是一套经过实战验证的、完整的 AI 编程工作流解决方案。

为什么选择这个项目？

• 🏆 实战验证：来自 Anthropic x Forum Ventures 黑客马拉松获奖者的配置
• 📦 开箱即用：包含 agents、skills、hooks、commands、rules、MCPs 等完整配置
• 🎯 即插即用：支持插件安装，一键获取所有功能
• 🌟 社区认可：22.7k+ Stars，2.7k+ Forks，活跃的社区支持

你将学到什么

• Claude Code 的核心概念：Agents、Skills、Hooks、Rules、MCPs
• everything-claude-code 项目的完整架构和设计理念
• 如何快速上手使用这个配置集合
• 项目的核心功能和使用场景
• 与其他 AI 编程工具的对比分析
• 如何基于此项目定制自己的配置

前置知识

• 基本的命令行操作经验
• 对 AI 辅助编程有基本了解
• 熟悉 JSON 配置文件格式
• 了解 Claude Code 的基本使用

---

项目背景

项目简介

everything-claude-code 是一个完整的 Claude Code 配置集合，旨在为开发者提供一套经过实战验证的、开箱即用的 AI 编程助手配置。它不仅仅是一个简单的配置文件集合，而是一套包含多个组件的完整工作流系统。

项目解决的核心问题：

• Claude Code 配置复杂，新手难以快速上手
• 缺乏经过实战验证的最佳实践配置
• 不同场景下的配置需求分散，难以统一管理
• 缺少完整的工具链和自动化流程

面向的用户群体：

• 使用 Claude Code 的开发者
• 希望提升 AI 辅助编程效率的团队
• 想要学习 AI 工具配置最佳实践的技术人员
• 需要定制化 AI 编程工作流的组织

作者/团队介绍

作者：Affaan Mustafa (@affaan-m)

• 背景：Anthropic x Forum Ventures 黑客马拉松获奖者（2025年9月）
• 成就：使用 Claude Code 构建了 zenith.chat，一个完全基于 Claude Code 的生产级应用
• 经验：从 Claude Code 实验阶段就开始使用，积累了丰富的实战经验
• 理念：这些配置经过多个生产应用的实战验证，不是纸上谈兵

项目创建时间：2025年（具体月份未明确，但从 GitHub 活动来看是活跃项目）

项目数据

• ⭐ GitHub Stars: 22.7k+（持续增长中）
• 🍴 Forks: 2.7k+
• 📦 版本: v1.0.0（最新版本，2026年1月22日发布）
• 📄 License: MIT（自由使用、修改、贡献）
• 🌐 官网: 无独立官网，GitHub 为主要入口
• 📚 文档: 包含详细的 README 和两个指南（Shorthand Guide 和 Longform Guide）
• 💬 社区: GitHub Discussions 活跃

项目发展历程：

• 2025年9月：作者在 Anthropic 黑客马拉松中获奖，项目开始受到关注
• 2025年底：项目逐渐完善，添加了更多配置和示例
• 2026年1月：发布 v1.0.0 正式版本，支持插件安装

---

主要功能

核心作用

everything-claude-code 的核心作用是为 Claude Code 提供一套完整的、经过实战验证的配置集合，让开发者能够：

1. 快速上手 Claude Code：无需从零开始配置，直接使用最佳实践
2. 提升开发效率：通过预配置的 agents、skills、hooks 等组件，自动化常见任务
3. 标准化工作流：为团队提供统一的 AI 编程工作流标准
4. 扩展和定制：基于现有配置，快速定制符合自己需求的配置

使用场景

1. 个人开发者快速配置 Claude Code

   • 刚接触 Claude Code，不知道如何配置
   • 希望快速获得一套可用的配置
   • 需要参考最佳实践来优化自己的配置

2. 团队统一 AI 编程标准

   • 团队希望统一 AI 辅助编程的工作流
   • 需要标准化的代码审查、测试、部署流程
   • 希望建立团队级的 AI 工具使用规范

3. 学习和研究 AI 工具配置

   • 想了解 Claude Code 的高级功能
   • 研究如何优化 AI 辅助编程的工作流
   • 学习 agents、hooks、MCPs 等概念的实际应用

4. 定制化开发

   • 基于现有配置，开发符合特定需求的配置
   • 集成到自己的开发工具链中
   • 为特定技术栈（如 Python、Go、Rust）定制配置

5. 生产环境应用

   • 在真实项目中应用经过验证的配置
   • 提升代码质量和开发效率
   • 建立可复用的开发模式

快速开始

方式一：插件安装（推荐）

最简单的方式是将其作为 Claude Code 插件安装：

# 添加市场源
/plugin marketplace add affaan-m/everything-claude-code

# 安装插件
/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
  }
}

方式二：手动安装

如果需要更精细的控制，可以手动安装：

# 克隆仓库
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.json 复制 hooks 配置到 ~/.claude/settings.json，从 mcp-configs/mcp-servers.json 复制 MCP 配置到 ~/.claude.json。

核心特性

1. 完整的组件体系

   • Agents：预定义的子代理，处理特定任务（代码审查、测试、重构等）
   • Skills：工作流定义，可被命令或 agents 调用
   • Hooks：基于事件的自动化触发器
   • Commands：可执行的命令集合
   • Rules：始终遵循的指导原则
   • MCPs：Model Context Protocol 服务器配置

2. 实战验证的配置

   • 所有配置都经过生产环境验证
   • 来自黑客马拉松获奖项目的实战经验
   • 包含多个真实项目的使用案例

3. 模块化设计

   • 每个组件都可以独立使用
   • 支持按需选择和组合
   • 易于扩展和定制

4. 跨平台支持

   • 包含跨平台的 Node.js 脚本
   • 支持多种包管理器（npm、yarn、pnpm）
   • 提供统一的工具接口

5. 完善的测试体系

   • 包含完整的测试套件
   • 支持自动化测试
   • 确保配置的可靠性

6. 丰富的文档和示例

   • 详细的 README 文档
   • Shorthand Guide（快速入门）
   • Longform Guide（深入指南）
   • 多个示例配置

7. 社区驱动

   • 活跃的社区贡献
   • 持续更新和维护
   • 欢迎社区贡献

8. 灵活的定制能力

   • 支持项目级和用户级配置
   • 可以禁用不需要的组件
   • 易于扩展和修改

项目优势

与其他 AI 编程工具配置相比，everything-claude-code 的优势：

对比项	everything-claude-code	其他配置集合	自己从零配置
完整性	⭐⭐⭐⭐⭐ 包含所有组件	⭐⭐⭐ 通常只包含部分组件	⭐⭐ 需要自己组合
实战验证	⭐⭐⭐⭐⭐ 生产环境验证	⭐⭐⭐ 理论为主	⭐⭐ 需要自己验证
上手速度	⭐⭐⭐⭐⭐ 插件一键安装	⭐⭐⭐ 需要手动配置	⭐ 需要大量时间
文档质量	⭐⭐⭐⭐⭐ 详细的双指南	⭐⭐⭐ 基础文档	⭐ 需要自己摸索
社区支持	⭐⭐⭐⭐⭐ 22.7k+ Stars	⭐⭐⭐ 较小社区	⭐ 无社区支持
定制能力	⭐⭐⭐⭐ 模块化设计	⭐⭐⭐ 部分可定制	⭐⭐⭐⭐⭐ 完全可控
维护成本	⭐⭐⭐⭐⭐ 持续更新	⭐⭐⭐ 更新较少	⭐ 需要自己维护

为什么选择这个项目？

• ✅ 开箱即用：无需从零开始，直接获得最佳实践
• ✅ 实战验证：来自真实项目的配置，不是纸上谈兵
• ✅ 持续更新：活跃的社区和作者维护
• ✅ 完整生态：不仅仅是配置，还包含工具、脚本、测试等
• ✅ 学习价值：可以学习如何构建高质量的 AI 工具配置

---

项目详细剖析

架构设计

everything-claude-code 采用模块化、分层式架构，每个组件都有明确的职责和边界：

everything-claude-code/
├── agents/          # 子代理定义
├── commands/        # 可执行命令
├── skills/          # 工作流定义
├── hooks/           # 事件触发器
├── rules/           # 规则和指导原则
├── contexts/        # 动态上下文注入
├── mcp-configs/     # MCP 服务器配置
├── scripts/         # 工具脚本
├── tests/           # 测试套件
└── examples/        # 示例配置

核心组件详解

1. Agents（子代理）

Agents 是处理特定任务的子代理，每个 agent 都有明确的职责范围：

典型 Agents：

• code-reviewer：代码审查代理，专注于代码质量、安全性、可维护性
• test-writer：测试编写代理，遵循 TDD 原则
• refactor-assistant：重构助手，帮助清理代码
• build-fixer：构建错误修复代理

Agent 结构示例：

---
name: code-reviewer
description: Reviews code for quality, security, and maintainability
tools: Read, Grep, Glob, Bash
model: opus
---

You are a senior code reviewer...

设计特点：

• 每个 agent 专注于单一职责
• 可以指定使用的工具和模型
• 支持工具限制，避免过度使用

2. Skills（工作流）

Skills 定义了可重复使用的工作流，可以被命令或 agents 调用：

典型 Skills：

• TDD 工作流：定义接口 → 编写失败测试 → 实现代码 → 重构
• 代码审查流程：安全检查 → 质量检查 → 性能检查
• 重构流程：识别问题 → 制定计划 → 逐步重构 → 验证

设计特点：

• 工作流可复用
• 支持组合和嵌套
• 可以参数化

3. Hooks（事件触发器）

Hooks 基于工具使用事件自动触发操作，实现自动化：

典型 Hooks：

• PreToolUse：在工具使用前执行（如检查权限）
• PostToolUse：在工具使用后执行（如记录日志）
• Stop：在会话停止时执行（如保存状态）

Hook 配置示例：

{
  "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"
  }]
}

设计特点：

• 基于事件驱动
• 支持条件匹配
• 可以执行命令或脚本

4. Commands（命令）

Commands 是可执行的命令集合，提供快速访问常用功能：

典型 Commands：

• /build-fix：修复构建错误
• /refactor-clean：清理死代码
• /learn：从会话中提取模式
• /checkpoint：保存验证状态
• /verify：运行验证循环

设计特点：

• 命令式接口，易于使用
• 可以调用 agents 和 skills
• 支持参数传递

5. Rules（规则）

Rules 是始终遵循的指导原则，确保一致的行为：

典型 Rules：

• security.md：强制安全检查（禁止硬编码密钥）
• coding-style.md：编码规范（不可变性、文件组织）
• testing.md：测试要求（TDD、80%覆盖率）
• git-workflow.md：Git 工作流（提交格式、PR 流程）

设计特点：

• 模块化，易于管理
• 始终生效
• 可以按项目定制

6. MCPs（Model Context Protocol）

MCPs 提供外部工具和服务的集成：

预配置的 MCPs：

• GitHub：代码仓库操作
• Supabase：数据库操作
• Vercel：部署服务
• Railway：云平台服务

设计特点：

• 统一的外部服务接口
• 支持多个服务同时配置
• 可以按需启用/禁用

关键技术实现

1. 上下文窗口管理

问题：启用太多 MCPs 会导致上下文窗口从 200k 缩小到 70k

解决方案：

• 配置 20-30 个 MCPs，但只启用 10 个以内
• 使用 disabledMcpServers 在项目配置中禁用不需要的
• 保持活跃工具数在 80 个以下

最佳实践：

{
  "disabledMcpServers": ["unused-service-1", "unused-service-2"]
}

2. 模块化配置

设计理念：每个组件都可以独立使用，支持按需组合

实现方式：

• 使用标准的文件结构
• 支持项目级和用户级配置
• 提供清晰的配置优先级

3. 跨平台脚本

问题：不同平台的脚本执行方式不同

解决方案：

• 使用 Node.js 编写跨平台脚本
• 提供统一的工具接口（lib/utils.js）
• 自动检测包管理器（lib/package-manager.js）

扩展机制

1. 添加自定义 Agent

创建新的 agent 文件：

---
name: my-custom-agent
description: My custom agent for specific tasks
tools: Read, Edit
model: sonnet
---

You are a custom agent...

2. 添加自定义 Hook

在 hooks.json 中添加：

{
  "matcher": "your condition",
  "hooks": [{
    "type": "command",
    "command": "your command"
  }]
}

3. 添加自定义 Command

创建命令文件：

# my-command
description: My custom command
---

Workflow for my command...

---

项目地址与资源

官方资源

• 🌟 GitHub: https://github.com/affaan-m/everything-claude-code
• 📚 Shorthand Guide: The Shorthand Guide to Everything Claude Code
• 📖 Longform Guide: The Longform Guide to Everything Claude Code
• 💬 Discussions: GitHub Discussions
• 🐛 Issues: GitHub Issues
• 📦 Releases: GitHub Releases

相关资源

• 作者 Twitter: @affaanmustafa
• zenith.chat: https://zenith.chat（作者使用 Claude Code 构建的项目）
• Claude Code 官方文档: Anthropic Claude Code Documentation

---

适用人群

强烈推荐：

• 正在使用或准备使用 Claude Code 的开发者
• 希望提升 AI 辅助编程效率的团队
• 想要学习 AI 工具配置最佳实践的技术人员

也适合：

• 对 AI 辅助编程感兴趣的研究人员
• 需要定制化 AI 编程工作流的组织
• 希望建立团队级 AI 工具使用规范的团队

---

欢迎来我中的个人主页找到更多有用的知识和有趣的产品