everything-claude-code
面向 Claude Code 的完整配置工具包,聚合了 agents、commands、skills、rules、hooks 和 MCP 配置,源自 Anthropic hackathon 获奖者的实战积累。支持插件式安装,提供跨平台 Node.js 脚本与测试套件,覆盖 token 优化、记忆持久化、验证循环等进阶用法。适合想系统化提升 Claude Code 编程效率的开发者,可按需裁剪集成。
README
Everything Claude Code
来自 Anthropic hackathon 获奖者的完整 Claude Code 配置集合。
经过 10 个多月在高强度日常开发中构建真实产品的锤炼,这些生产级 agents、skills、hooks、commands、rules 和 MCP 配置不断演化而成。
指南
本仓库仅包含原始代码。配套指南对所有内容进行了详细讲解。
|
|
| 速查指南 环境搭建、基础概念、核心理念。请先阅读此篇。 |
深度指南 Token 优化、记忆持久化、评估(evals)、并行化。 |
| 主题 | 你将学到什么 |
|---|---|
| Token 优化 | 模型选择、系统提示词精简、后台进程管理 |
| 记忆持久化 | 通过 hooks 在会话之间自动保存/加载上下文 |
| 持续学习 | 从会话中自动提取模式,沉淀为可复用的 skills |
| 验证循环 | 检查点 vs 持续评估、评分器类型、pass@k 指标 |
| 并行化 | Git worktrees、级联方法、何时扩展实例数量 |
| Subagent 编排 | 上下文问题、迭代检索模式 |
跨平台支持
该插件现已完全支持 Windows、macOS 和 Linux。所有 hooks 和脚本均已用 Node.js 重写以实现最大兼容性。
包管理器检测
插件按以下优先级自动检测您偏好的包管理器(npm、pnpm、yarn 或 bun):
- 环境变量:
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
# 通过全局配置
node scripts/setup-package-manager.js --global pnpm
# 通过项目配置
node scripts/setup-package-manager.js --project bun
# 检测当前设置
node scripts/setup-package-manager.js --detect
或者在 Claude Code 中使用 /setup-pm 命令。
仓库内容
本仓库是一个 Claude Code 插件 - 您可以直接安装,也可以手动复制所需组件。
everything-claude-code/
|-- .claude-plugin/ # Plugin and marketplace manifests
| |-- plugin.json # Plugin metadata and component paths
| |-- marketplace.json # Marketplace catalog for /plugin marketplace add
|
|-- agents/ # Specialized subagents for delegation
| |-- planner.md # Feature implementation planning
| |-- architect.md # System design decisions
| |-- tdd-guide.md # Test-driven development
| |-- code-reviewer.md # Quality and security review
| |-- security-reviewer.md # Vulnerability analysis
| |-- build-error-resolver.md
| |-- e2e-runner.md # Playwright E2E testing
| |-- refactor-cleaner.md # Dead code cleanup
| |-- doc-updater.md # Documentation sync
|
|-- skills/ # Workflow definitions and domain knowledge
| |-- coding-standards/ # Language best practices
| |-- backend-patterns/ # API, database, caching patterns
| |-- frontend-patterns/ # React, Next.js patterns
| |-- continuous-learning/ # Auto-extract patterns from sessions (Longform Guide)
| |-- strategic-compact/ # Manual compaction suggestions (Longform Guide)
| |-- tdd-workflow/ # TDD methodology
| |-- security-review/ # Security checklist
| |-- eval-harness/ # Verification loop evaluation (Longform Guide)
| |-- verification-loop/ # Continuous verification (Longform Guide)
|
|-- commands/ # Slash commands for quick execution
| |-- tdd.md # /tdd - Test-driven development
| |-- plan.md # /plan - Implementation planning
| |-- e2e.md # /e2e - E2E test generation
| |-- code-review.md # /code-review - Quality review
| |-- build-fix.md # /build-fix - Fix build errors
| |-- refactor-clean.md # /refactor-clean - Dead code removal
| |-- learn.md # /learn - Extract patterns mid-session (Longform Guide)
| |-- checkpoint.md # /checkpoint - Save verification state (Longform Guide)
| |-- verify.md # /verify - Run verification loop (Longform Guide)
| |-- setup-pm.md # /setup-pm - Configure package manager (NEW)
|
|-- rules/ # Always-follow guidelines (copy to ~/.claude/rules/)
| |-- security.md # Mandatory security checks
| |-- coding-style.md # Immutability, file organization
| |-- testing.md # TDD, 80% coverage requirement
| |-- git-workflow.md # Commit format, PR process
| |-- agents.md # When to delegate to subagents
| |-- performance.md # Model selection, context management
|
|-- hooks/ # Trigger-based automations
| |-- hooks.json # All hooks config (PreToolUse, PostToolUse, Stop, etc.)
| |-- memory-persistence/ # Session lifecycle hooks (Longform Guide)
| |-- strategic-compact/ # Compaction suggestions (Longform Guide)
|
|-- scripts/ # Cross-platform Node.js scripts (NEW)
| |-- lib/ # Shared utilities
| | |-- utils.js # Cross-platform file/path/system utilities
| | |-- package-manager.js # Package manager detection and selection
| |-- hooks/ # Hook implementations
| | |-- session-start.js # Load context on session start
| | |-- session-end.js # Save state on session end
| | |-- pre-compact.js # Pre-compaction state saving
| | |-- suggest-compact.js # Strategic compaction suggestions
| | |-- evaluate-session.js # Extract patterns from sessions
| |-- setup-package-manager.js # Interactive PM setup
|
|-- tests/ # Test suite (NEW)
| |-- lib/ # Library tests
| |-- hooks/ # Hook tests
| |-- run-all.js # Run all tests
|
|-- contexts/ # Dynamic system prompt injection contexts (Longform Guide)
| |-- dev.md # Development mode context
| |-- review.md # Code review mode context
| |-- research.md # Research/exploration mode context
|
|-- examples/ # Example configurations and sessions
| |-- CLAUDE.md # Example project-level config
| |-- user-CLAUDE.md # Example user-level config
|
|-- mcp-configs/ # MCP server configurations
| |-- mcp-servers.json # GitHub, Supabase, Vercel, Railway, etc.
|
|-- marketplace.json # Self-hosted marketplace config (for /plugin marketplace add)
安装
方式一:作为插件安装(推荐)
使用本仓库最简单的方式 - 作为 Claude Code 插件安装:
# 将此仓库添加为 marketplace
/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
}
}
这样您就可以立即使用所有 commands、agents、skills 和 hooks。
方式二:手动安装
如果您希望手动控制安装内容:
# 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
# 复制 agents 到您的 Claude 配置目录
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 添加到 settings.json
将 hooks/hooks.json 中的 hooks 复制到您的 ~/.claude/settings.json。
配置 MCPs
将 mcp-configs/mcp-servers.json 中需要的 MCP servers 复制到您的 ~/.claude.json。
重要提示: 请将 YOUR_*_HERE 占位符替换为您真实的 API keys。
核心概念
Agents
Subagents(子代理)在限定范围内处理委派的任务。示例:
---
name: code-reviewer
description: Reviews code for quality, security, and maintainability
tools: Read, Grep, Glob, Bash
model: opus
---
You are a senior code reviewer...
Skills
Skills 是由 commands 或 agents 调用的工作流定义:
# TDD Workflow
1. Define interfaces first
2. Write failing tests (RED)
3. Implement minimal code (GREEN)
4. Refactor (IMPROVE)
5. Verify 80%+ coverage
Hooks
Hooks 在工具事件触发时执行。示例 - 对 console.log 发出警告:
{
"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"
}]
}
Rules
Rules 是始终需要遵循的准则。建议保持模块化:
~/.claude/rules/
security.md # No hardcoded secrets
coding-style.md # Immutability, file limits
testing.md # TDD, coverage requirements
运行测试
插件包含一套完整的测试套件:
# 运行所有测试
node tests/run-all.js
# 运行单个测试文件
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js
参与贡献
欢迎并鼓励任何形式的贡献。
本仓库旨在成为社区资源。如果您有以下内容:
- 实用的 agents 或 skills
- 巧妙的 hooks
- 更好的 MCP 配置
- 改进的 rules
欢迎贡献!请参阅 CONTRIBUTING.md 了解贡献指南。
可贡献的思路
- 特定语言的 skills(Python、Go、Rust 模式)
- 特定框架的配置(Django、Rails、Laravel)
- DevOps agents(Kubernetes、Terraform、AWS)
- 测试策略(不同的测试框架)
- 特定领域的知识(机器学习、数据工程、移动开发)
背景
我从 Claude Code 实验性发布时就开始使用它。2025 年 9 月,我与 @DRodriguezFX 合作,完全使用 Claude Code 构建了 zenith.chat,并赢得了 Anthropic x Forum Ventures hackathon 奖项。
这些配置已在多个生产级应用中经过了充分的实战检验。
重要说明
上下文窗口管理
关键提示: 不要一次性启用所有 MCP。启用过多工具时,您的 200k 上下文窗口可能会缩减到 70k。
经验法则:
- 配置 20-30 个 MCPs
- 每个项目启用不超过 10 个
- 保持活跃工具在 80 个以内
使用项目配置中的 disabledMcpServers 来禁用未使用的 MCP servers。
自定义配置
这些配置适合我的工作流。建议您:
- 从对您有参考价值的部分入手
- 根据您的技术栈进行修改
- 删掉不用的部分
- 加入您自己的模式
Star 历史
链接
- 速查指南(从这里开始): The Shorthand Guide to Everything Claude Code
- 深度指南(进阶): The Longform Guide to Everything Claude Code
- 关注我: @affaanmustafa
- zenith.chat: zenith.chat
许可证
MIT - 可自由使用、按需修改,如有能力欢迎回馈贡献。
如果本仓库对您有帮助,请点个 Star。阅读两份指南,去构建一些了不起的东西吧。