语言: 英语 | 葡萄牙语(巴西) | 简体中文 | 繁体中文 | 日语 | 韩语 | 土耳其语 | 俄语 | 越南语 | 泰语 | 德语 | 乌克兰语
Everything Claude Code¶
140K+ 星标 | 21K+ 分支 | 170+ 贡献者 | 12+ 语言生态系统 | Anthropic 黑客马拉松冠军
面向 AI 智能体框架的性能优化系统。由 Anthropic 黑客马拉松冠军打造。
它不仅仅是一组配置文件。它是一个完整的系统,涵盖技能、直觉(Instinct)、内存优化、持续学习、安全扫描和研究优先开发。其中包含经过 10 个月以上实际产品构建和每日高强度使用而不断打磨的生产级智能体、钩子、命令、规则和 MCP 配置。
可在 Claude Code、Codex、Cursor、OpenCode、Gemini 等多种 AI 智能体框架中使用。
指南¶
本仓库仅包含代码。指南中会解释所有内容。
|
|
|
| 简要指南 配置、基础、哲学。请从这里开始阅读。 |
详细指南 令牌优化、内存持久性、评估、并行处理。 |
| 主题 | 可学习的内容 |
|---|---|
| 令牌优化 | 模型选择、系统提示词优化、后台进程 |
| 内存持久性 | 自动跨会话保存/加载上下文的钩子 |
| 持续学习 | 从会话中自动提取模式并转换为可复用的技能 |
| 验证循环 | 检查点与连续评估、评分类型、pass@k 指标 |
| 并行处理 | Git worktree、级联方式、实例扩展时机 |
| 子智能体编排 | 上下文问题、重复搜索模式 |
新闻¶
v1.8.0 — 框架性能系统(2026年3月)¶
- 以框架为中心的版本 — ECC 现在被明确定义为智能体框架性能系统,而不仅仅是一组配置。
- 钩子稳定性改进 — SessionStart 根回退、Stop 阶段会话摘要,将脆弱的内联单行命令替换为基于脚本的钩子。
- 钩子运行时控制 — 通过
ECC_HOOK_PROFILE=minimal|standard|strict和ECC_DISABLED_HOOKS=...在不修改钩子文件的情况下进行运行时控制。 - 新的框架命令 —
/harness-audit、/loop-start、/loop-status、/quality-gate、/model-route。 - NanoClaw v2 — 模型路由、技能热加载、会话分支/搜索/导出/压缩/指标。
- 跨框架兼容性 — 增强 Claude Code、Cursor、OpenCode、Codex 之间行为的一致性。
- 通过 997 个内部测试 — 在钩子/运行时重构及兼容性更新后,全部测试通过。
v1.7.0 — 跨平台扩展 & 演示文稿构建器(2026年2月)¶
- Codex 应用 + CLI 支持 — 基于 AGENTS.md 的直接 Codex 支持
frontend-slides技能 — 无依赖的 HTML 演示文稿构建器- 5 个新的业务/内容技能 —
article-writing、content-engine、market-research、investor-materials、investor-outreach - 992 个内部测试 — 扩展的验证和回归测试范围
v1.6.0 — Codex CLI、AgentShield & 市场(2026年2月)¶
- Codex CLI 支持 — 用于 OpenAI Codex CLI 兼容性的
/codex-setup命令 - 7 个新技能 —
search-first、swift-actor-persistence、swift-protocol-di-testing等 - AgentShield 集成 — 通过
/security-scan直接在 Claude Code 中运行 AgentShield;1282 个测试、102 条规则 - GitHub 市场 — 在 github.com/marketplace/ecc-tools 提供免费/专业/企业版
- 30 多名社区贡献 — 覆盖 6 种语言的 30 名贡献者
- 978 个内部测试 — 覆盖智能体、技能、命令、钩子、规则的整体验证
完整变更历史请在 发布 中查看。
快速开始¶
2 分钟内完成设置:
第 1 步:安装插件¶
# 마켓플레이스 추가
/plugin marketplace add https://github.com/affaan-m/ECC
# 플러그인 설치
/plugin install ecc@ecc
第二步:安装规则(必需)¶
WARNING:重要提示: Claude Code 插件无法自动部署
rules规则,您必须手动安装:
# 먼저 저장소 클론
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
# 권장: 설치 스크립트 사용 (common + 언어별 룰을 안전하게 처리)
./install.sh typescript # 또는 python, golang
# 여러 언어를 한번에 설치할 수 있습니다:
# ./install.sh typescript python golang
# Cursor를 대상으로 설치:
# ./install.sh --target cursor typescript
手动安装方法请参阅 rules/ 目录下的 README。
第三步:开始使用¶
# 커맨드 실행 (플러그인 설치 시 네임스페이스 형태 사용)
/ecc:plan "사용자 인증 추가"
# 수동 설치(옵션 2) 시에는 짧은 형태를 사용:
# /plan "사용자 인증 추가"
# 사용 가능한 커맨드 확인
/plugin list ecc@ecc
完成! 现在,您可以使用 16 个代理(Agent)、65 个技能(Skill)和 40 个命令(Command)。
跨平台支持¶
该插件完全支持 Windows、macOS 和 Linux,并与主流 IDE(Cursor、OpenCode、Antigravity)及 CLI 工具链紧密集成。所有 Hook 和脚本均使用 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 - 回退:
npm
配置包管理器的方法:
# 환경 변수로 설정
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 命令。
Hook 运行时控制¶
您可以通过运行时标志调整严格级别,或临时禁用特定 Hook:
# 훅 엄격도 프로필 (기본값: standard)
export ECC_HOOK_PROFILE=standard
# 비활성화할 훅 ID (쉼표로 구분)
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"
组件¶
该仓库是一个 Claude Code 插件——您可以直接安装,也可以手动复制各个组件。
everything-claude-code/
|-- .claude-plugin/ # 플러그인 및 마켓플레이스 매니페스트
| |-- plugin.json # 플러그인 메타데이터와 컴포넌트 경로
| |-- marketplace.json # /plugin marketplace add용 마켓플레이스 카탈로그
|
|-- 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-reviewer.md # Go 코드 리뷰
| |-- go-build-resolver.md # Go 빌드 에러 해결
| |-- python-reviewer.md # Python 코드 리뷰
| |-- database-reviewer.md # 데이터베이스/Supabase 리뷰
|
|-- skills/ # 워크플로우 정의와 도메인 지식
| |-- coding-standards/ # 언어 모범 사례
| |-- backend-patterns/ # API, 데이터베이스, 캐싱 패턴
| |-- frontend-patterns/ # React, Next.js 패턴
| |-- continuous-learning/ # 세션에서 패턴 자동 추출
| |-- continuous-learning-v2/ # 신뢰도 점수가 있는 직관 기반 학습
| |-- tdd-workflow/ # TDD 방법론
| |-- security-review/ # 보안 체크리스트
| |-- 그 외 다수...
|
|-- commands/ # 빠른 실행을 위한 슬래시 커맨드
| |-- tdd.md # /tdd - 테스트 주도 개발
| |-- plan.md # /plan - 구현 계획
| |-- e2e.md # /e2e - E2E 테스트 생성
| |-- code-review.md # /code-review - 품질 리뷰
| |-- build-fix.md # /build-fix - 빌드 에러 수정
| |-- 그 외 다수...
|
|-- rules/ # 항상 따르는 가이드라인 (~/.claude/rules/에 복사)
| |-- common/ # 언어 무관 원칙
| |-- typescript/ # TypeScript/JavaScript 전용
| |-- python/ # Python 전용
| |-- golang/ # Go 전용
|
|-- hooks/ # 트리거 기반 자동화
| |-- hooks.json # 모든 훅 설정
| |-- memory-persistence/ # 세션 라이프사이클 훅
|
|-- scripts/ # 크로스 플랫폼 Node.js 스크립트
|-- tests/ # 테스트 모음
|-- contexts/ # 동적 시스템 프롬프트 주입 컨텍스트
|-- examples/ # 예제 설정 및 세션
|-- mcp-configs/ # MCP 서버 설정
生态系统工具¶
Skill Creator¶
从仓库生成 Claude Code 技能(Skill)的两种方法:
选项 A:本地分析(内置)¶
如需在本地进行分析而无需外部服务,请使用 /skill-create 命令:
它会在本地分析 git 历史记录并生成 SKILL.md 文件。
选项 B:GitHub 应用(高级)¶
如果您需要高级功能(10k+ 提交、自动 PR、团队共享):
AgentShield — 安全审计工具¶
在 Claude Code 黑客松(Cerebral Valley x Anthropic,2026 年 2 月)中开发。包含 1282 个测试、98% 覆盖率、102 条静态分析规则。
扫描 Claude Code 配置中的漏洞、错误配置和注入风险。
# 빠른 스캔 (설치 불필요)
npx ecc-agentshield scan
# 안전한 문제 자동 수정
npx ecc-agentshield scan --fix
# 3개의 Opus 4.6 에이전트로 정밀 분석
npx ecc-agentshield scan --opus --stream
# 안전한 설정을 처음부터 생성
npx ecc-agentshield init
扫描对象: CLAUDE.md、settings.json、MCP 配置、Hook、Agent 定义、Skill — 共 5 个类别:密钥检测(14 种模式)、权限审计、Hook 注入分析、MCP 服务器风险画像、Agent 配置审查。
--opus 标志会以红队/蓝队/审计官的管道方式运行 3 个 Claude Opus 4.6 代理(Agent)。攻击方负责寻找漏洞利用链,防御方负责评估防护措施,审计官则综合双方的发现,生成一份按优先级排序的风险评估报告。
在 Claude Code 中使用 /security-scan,或通过 GitHub Action 将其集成到 CI 中。
持续学习 v2¶
基于直觉(Instinct)的学习系统会自动学习您的模式:
/instinct-status # 학습된 직관과 신뢰도 확인
/instinct-import <file> # 다른 사람의 직관 가져오기
/instinct-export # 내 직관 내보내기
/evolve # 관련 직관을 스킬로 클러스터링
更多详情请参阅 skills/continuous-learning-v2/。
系统要求¶
Claude Code CLI 版本¶
最低版本:v2.1.0 及以上
由于 Hook 系统的变更,该插件需要 Claude Code CLI v2.1.0 或更高版本。
查看版本:
重要:Hook 自动加载行为¶
WARNING:贡献者须知: 请勿在
.claude-plugin/plugin.json中添加"hooks"字段。回归测试会强制检查这一点。
Claude Code v2.1+ 会自动加载已安装插件的 hooks/hooks.json。如果显式声明,将会导致重复检测错误。
安装¶
选项 1:以插件方式安装(推荐)¶
# 마켓플레이스 추가
/plugin marketplace add https://github.com/affaan-m/ECC
# 플러그인 설치
/plugin install ecc@ecc
或者,直接添加到 ~/.claude/settings.json:
{
"extraKnownMarketplaces": {
"ecc": {
"source": {
"source": "github",
"repo": "affaan-m/everything-claude-code"
}
}
},
"enabledPlugins": {
"ecc@ecc": true
}
}
注意: Claude Code 插件系统不支持将
rules作为插件分发。规则必须手动安装:git clone https://github.com/affaan-m/everything-claude-code.git # 옵션 A: 사용자 레벨 룰 (모든 프로젝트에 적용) mkdir -p ~/.claude/rules cp -r everything-claude-code/rules/common ~/.claude/rules/common cp -r everything-claude-code/rules/typescript ~/.claude/rules/typescript # 사용하는 스택 선택 # 옵션 B: 프로젝트 레벨 룰 (현재 프로젝트에만 적용) mkdir -p .claude/rules cp -r everything-claude-code/rules/common .claude/rules/common
选项 2:手动安装¶
如果你想自行选择要安装的内容:
# 저장소 클론
git clone https://github.com/affaan-m/everything-claude-code.git
# 에이전트 복사
cp everything-claude-code/agents/*.md ~/.claude/agents/
# 룰 복사 (common + 언어별)
cp -r everything-claude-code/rules/common ~/.claude/rules/common
cp -r everything-claude-code/rules/typescript ~/.claude/rules/typescript # 사용하는 스택 선택
# 커맨드 복사
cp everything-claude-code/commands/*.md ~/.claude/commands/
# 스킬 복사
cp -r everything-claude-code/skills/* ~/.claude/skills/
cp -r everything-claude-code/skills/search-first ~/.claude/skills/
核心概念¶
智能体¶
子智能体在有限范围内处理委派的任务。示例:
---
name: code-reviewer
description: 코드의 품질, 보안, 유지보수성을 리뷰합니다
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---
당신은 시니어 코드 리뷰어입니다...
技能¶
技能是由命令或智能体调用的工作流定义:
# TDD 워크플로우
1. 인터페이스를 먼저 정의
2. 실패하는 테스트 작성 (RED)
3. 최소한의 코드 구현 (GREEN)
4. 리팩토링 (IMPROVE)
5. 80% 이상 커버리지 확인
钩子¶
钩子(Hook)响应工具事件而执行。示例——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] console.log를 제거하세요' >&2"
}]
}
规则¶
规则是需要始终遵循的指南,由 common/(语言无关)+ 各语言专属目录组成:
rules/
common/ # 보편적 원칙 (항상 설치)
typescript/ # TS/JS 전용 패턴과 도구
python/ # Python 전용 패턴과 도구
golang/ # Go 전용 패턴과 도구
更多详情请参阅 rules/README.md。
应该使用哪个智能体?¶
如果不知道从哪里开始,请参考下面的对照表:
| 想做的事 | 使用的命令 | 使用的智能体 |
|---|---|---|
| 规划新功能 | /ecc:plan "인증 추가" |
planner |
| 设计系统架构 | /ecc:plan + architect 智能体 |
architect |
| 先写测试再编码 | /tdd |
tdd-guide |
| 审查刚写好的代码 | /code-review |
code-reviewer |
| 修复构建失败 | /build-fix |
build-error-resolver |
| 运行 E2E 测试 | /e2e |
e2e-runner |
| 查找安全漏洞 | /security-scan |
security-reviewer |
| 清理未使用的代码 | /refactor-clean |
refactor-cleaner |
| 更新文档 | /update-docs |
doc-updater |
| 修复 Go 构建失败 | /go-build |
go-build-resolver |
| 审查 Go 代码 | /go-review |
go-reviewer |
| 审查数据库 schema/查询 | /code-review + database-reviewer 智能体 |
database-reviewer |
| 审查 Python 代码 | /python-review |
python-reviewer |
常见工作流¶
开始新功能:
/ecc:plan "OAuth를 사용한 사용자 인증 추가"
→ planner가 구현 청사진 작성
/tdd → tdd-guide가 테스트 먼저 작성 강제
/code-review → code-reviewer가 코드 검토
修复 Bug:
生产环境准备:
/security-scan → security-reviewer: OWASP Top 10 감사
/e2e → e2e-runner: 핵심 사용자 흐름 테스트
/test-coverage → 80% 이상 커버리지 확인
常见问题(FAQ)¶
钩子不工作,或看到 "Duplicate hooks file" 错误
这是最常见的问题。不要在 .claude-plugin/plugin.json 中添加 "hooks" 字段。Claude Code v2.1+ 会自动加载已安装插件的 hooks/hooks.json。
上下文窗口变小了 / Claude 上下文不足
MCP 服务器太多会占用大量上下文。每个 MCP 工具描述都会在 200k 窗口中消耗 token,可能导致窗口缩减至 ~70k。
解决方法: 按项目禁用未使用的 MCP:
保持少于 10 个 MCP 和少于 80 个工具处于启用状态。
可以只使用部分组件吗?(例如只用智能体)
可以。使用选项 2(手动安装),只复制你需要的部分:
# 에이전트만
cp everything-claude-code/agents/*.md ~/.claude/agents/
# 룰만
cp -r everything-claude-code/rules/common ~/.claude/rules/common
每个组件都是完全独立的。
在 Cursor / OpenCode / Codex / Antigravity 中也能用吗?
是的。ECC 是跨平台的:
- Cursor:在 .cursor/ 中提供转换后的配置
- OpenCode:在 .opencode/ 中提供完整的插件支持
- Codex:macOS 应用和 CLI 均提供一流支持
- Antigravity:在 .agents/ 中集成工作流、技能、智能体以及扁平化的规则
- Claude Code:原生支持——这是主要目标
我想贡献新的技能或智能体
请参阅 CONTRIBUTING.md。简单来说:
1. Fork 仓库
2. 在 skills/your-skill-name/SKILL.md 中创建技能(包含 YAML frontmatter)
3. 或在 agents/your-agent.md 中创建智能体
4. 提交带有清晰描述的 PR
运行测试¶
# 모든 테스트 실행
node tests/run-all.js
# 개별 테스트 파일 실행
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js
参与贡献¶
欢迎贡献!
这个仓库是作为社区资源而创建的。如果你有以下内容: - 有用的智能体或技能 - 出色的钩子 - 更好的 MCP 配置 - 改进的规则
欢迎贡献!¶
请参考 CONTRIBUTING.md 中的指南。
贡献想法¶
- 各语言技能(Rust、C#、Swift、Kotlin)——Go、Python、Java 已包含
- 各框架配置(Rails、Laravel、FastAPI)——Django、NestJS、Spring Boot 已包含
- DevOps 智能体(Kubernetes、Terraform、AWS、Docker)
- 测试策略(多种框架、视觉回归)
- 领域专属知识(ML、数据工程、移动端)
Token 优化¶
如果 Claude Code 的使用成本让你感到负担,就需要管理 Token 消耗。通过这些设置,可以在不降低质量的情况下大幅降低成本。
推荐设置¶
添加到 ~/.claude/settings.json:
{
"model": "sonnet",
"env": {
"MAX_THINKING_TOKENS": "10000",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
}
}
| 设置 | 默认值 | 推荐值 | 效果 |
|---|---|---|---|
model |
opus | sonnet | 节省约 60% 成本;可处理 80% 以上的编码任务 |
MAX_THINKING_TOKENS |
31,999 | 10,000 | 每次请求的隐藏思考成本降低约 70% |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE |
95 | 50 | 更早压缩——在长会话中获得更好质量 |
仅在需要深度架构推理时才切换到 Opus:
日常工作流命令¶
| 命令 | 使用时机 |
|---|---|
/model sonnet |
大多数任务的默认选项 |
/model opus |
复杂架构、调试、深度推理 |
/clear |
不相关任务之间(免费、即时重置) |
/compact |
逻辑任务切换时(研究完成、达成里程碑) |
/cost |
在会话期间监控 Token 支出 |
上下文窗口管理¶
重要: 不要同时启用所有 MCP。每个 MCP 工具描述都会消耗 200k 窗口中的 Token,可能使其缩减至约 70k。
- 每个项目启用少于 10 个 MCP
- 保持启用的工具少于 80 个
- 在项目设置中通过
disabledMcpServers禁用不使用的服务
WARNING: 重要注意事项¶
自定义¶
这些设置是为我的工作流量身定制的。你可以: 1. 从你觉得有用的部分开始 2. 根据你的技术栈进行修改 3. 删除不使用的部分 4. 添加属于你自己的模式
赞助者¶
本项目是免费开源的。在赞助者的支持下得以持续维护和发展。
Star 历史¶
链接¶
- 速览指南(从这里开始): The Shorthand Guide to Everything Claude Code
- 详细指南(高级): The Longform Guide to Everything Claude Code
- 关注: @affaanmustafa
- zenith.chat: zenith.chat
许可证¶
MIT —— 可自由使用,按需修改,如有可能欢迎贡献。
如果这个仓库对你有帮助,请点个 Star。请把两份指南都读完。去创造一些了不起的东西吧。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 ev/ECC