这个项目是什么？
everything-claude-code 是一个在 GitHub 上拿到 50,000+ star 的开源项目，出自 Anthropic Hackathon 的获奖团队之手，经历了 10 个月的实际生产环境打磨。
一句话说清楚它是什么：给 AI 编程助手装「外挂」的全套配置包。
它不是换个花里胡哨的皮肤，而是从根上改变 Claude Code（以及 Cursor、Codex、OpenCode）的工作方式：
自动记忆会话上下文，不再每次都从零开始
专职子代理处理代码审查、构建报错、安全扫描
持续学习你的编码习惯，越用越懂你
Token 消耗直接砍掉 60-70%
支持跨平台：Claude Code / Cursor / OpenCode / Codex，一套装上，多端通用。

装了能干什么？核心模块拆解
先说清楚里面有什么，再讲怎么装。

① Agents（子代理）
安排了 30 个专职子代理，各司其职。比较常用的：
code-reviewer：代码质量、安全漏洞审查
planner：新功能开发的实现蓝图规划
build-error-resolver：构建报错自动修复
security-reviewer：OWASP Top 10 漏洞分析
tdd-guide：测试驱动开发流程引导
以前你跟 Claude 说「帮我审查一下代码」，它一个大模型什么都干，容易顾此失彼。现在有专职的 code-reviewer 接手，注意力更集中，结果更靠谱。
② Skills（技能/工作流）
135 个预置技能，覆盖主流开发场景：
前端：React/Next.js 最佳实践、E2E 测试、HTML 幻灯片
后端：Django、Spring Boot、Laravel、Go、Rust 全套
运维：Docker、CI/CD、数据库迁移、部署模式
AI 工程：LLM 成本优化、RAG 模式、模型路由策略
技能就是「标准化工作流说明书」，告诉 AI 做这件事的正确姿势，避免每次凭感觉乱搞。
③ Hooks（自动化触发器）
这是最实用的部分之一。
每当你执行特定操作，钩子自动触发检查：
编辑 .ts/.tsx 文件时，自动检测有没有残留 console.log
会话开始时，自动加载上次会话的上下文
提交代码前，自动扫描有没有 API Key 泄漏
文件修改后，自动跑 TypeScript 类型检查
④ Commands（快捷指令）
60 个斜杠命令，常用的：
/plan "添加用户认证" — 生成完整实现蓝图
/tdd — 测试驱动开发流程
/code-review — 代码质量审查
/build-fix — 修复构建错误
/security-scan — 安全漏洞扫描
/refactor-clean — 清理死代码
⑤ 持续学习系统
这个是亮点。
用了一段时间后，系统会自动从你的编码会话中提取规律，形成「本能（instinct）」：
/instinct-status    # 查看已学到的编码习惯
/evolve             # 把积累的本能升华成复用技能
/learn              # 当下这段会话里主动提取规律
说白了：AI 在逐渐学习「这个开发者喜欢怎么干活」，越用越顺手。

安装：完整步骤（别跳步）
前置要求：Claude Code CLI v2.1.0+，先确认版本：
claude --version
版本不够先升级：npm install -g @anthropic-ai/claude-code

第一步：安装插件
在 Claude Code 对话框里依次执行：
/plugin marketplace add affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code
这一步装好的是：30 个代理、135 个技能、60 个指令、Hooks 自动化。

第二步：安装 Rules（必须，不能跳）
这里有个坑要提醒：Claude Code 的插件系统目前不支持自动分发 Rules 文件，必须手动安装，否则 AI 不会遵守编码规范。
先克隆仓库到本地：
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
npm install
然后用安装脚本（推荐全量，按语言栈也行）：
# macOS / Linux —— 全量安装
./install.sh --profile full
 
# 只装你用的语言（二选一）
./install.sh typescript
./install.sh typescript python golang
 
# Windows PowerShell
.\install.ps1 --profile full
.\install.ps1 typescript python golang
 
# 跨平台通用方式（npm）
npx ecc-install typescript
脚本会把 agents、commands、skills、rules 等文件自动复制到 ~/.claude/ 对应目录下。
如果不想用脚本，也可以手动复制 rules 目录（注意要复制整个目录，不是目录里的文件，相对路径引用会失效）：
mkdir -p ~/.claude/rules
cp -r rules/common ~/.claude/rules/          # 通用规则，所有项目都要装
cp -r rules/typescript ~/.claude/rules/      # 按需选语言
cp -r rules/python ~/.claude/rules/
cp -r rules/golang ~/.claude/rules/

第三步：验证安装 + 开始使用
在 Claude Code 里检查已安装内容：
/plugin list everything-claude-code@everything-claude-code
试跑第一条命令（插件安装用带命名空间的格式）：
/everything-claude-code:plan "添加用户登录功能"
看到 planner 开始规划实现方案，就说明一切正常了。

进阶：Cursor / OpenCode / Codex 用户
安装脚本支持多平台目标：
./install.sh --target cursor typescript
./install.sh --target antigravity python
OpenCode 用户直接 cd 进仓库目录，执行 opencode，配置会自动加载。

国内用户特别提示：接国内模型 API 也能用
很多国内开发者用的不是 Anthropic 官方接口，而是通过兼容 API 的服务商来跑 Claude。
好消息是：everything-claude-code 对接口来源无要求，只要你的 API 端点兼容 Anthropic 协议，配个环境变量就行：
export ANTHROPIC_BASE_URL=https://你的网关地址
export ANTHROPIC_AUTH_TOKEN=你的token
claude
ECC 的 Hooks、Skills、Commands 和 Rules 全部跑在本地，模型调用走你配的接口，完全透明。
如果你需要一个稳定、低延迟的 Claude API 接入点，HAI 提供了统一模型网关服务，支持 Claude 全系列模型，按量计费，感兴趣可以到 portal.hai.network 看看详情。

Token 成本优化：必做配置
直接加到 ~/.claude/settings.json：
{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
  }
}
三个配置的实际效果：
"model": "sonnet"：从 Opus 切到 Sonnet，省 60% 费用，80% 以上的编码任务 Sonnet 完全够用
MAX_THINKING_TOKENS: 10000：把默认 32,000 的思考 token 砍掉 70%，明显降低每次调用成本
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE: 50：上下文用到 50% 就自动压缩，长会话质量更稳
需要架构设计、复杂重构这类任务时，临时切 Opus 就好，不用全程烧钱。

三个典型使用场景，开箱即用

场景 1：开发新功能
/plan "添加 OAuth 用户登录" — planner 生成完整实现蓝图
/tdd — tdd-guide 引导写测试先行
/code-review — code-reviewer 质量把关
场景 2：修复 Bug
/tdd — 先写一个能复现 Bug 的失败测试，实现修复后验证通过
/code-review — 检查有没有引入新问题
场景 3：上线前准备
/security-scan — 扫 OWASP Top 10 漏洞
/e2e — 跑关键用户流程的端对端测试
/test-coverage — 确认测试覆盖率 ≥ 80%

常见问题 Q&A
Q：Hooks 不生效，提示「Duplicate hooks file」？
不要在 .claude-plugin/plugin.json 里加 "hooks" 字段。Claude Code v2.1+ 会自动加载插件里的 hooks/hooks.json，手动声明反而触发重复检测报错。这是最高频的坑，官方已记录为已知问题。
Q：上下文越来越短，感觉 Claude 快撑不住了？
MCP 服务器太多吃 token。每个 MCP 工具的描述都会占用上下文窗口，开多了 200k 的窗口实际可用可能只剩 70k。
解决方法：在项目 .claude/settings.json 里禁掉当前用不到的 MCP：
{
  "disabledMcpServers": ["supabase", "railway", "vercel"]
}
原则：保持激活 MCP ≤ 10 个，活跃工具 ≤ 80 个。
Q：我只想用部分功能，不想全装？
完全没问题。ECC 各模块完全独立，按需复制：
# 只要 agents
cp everything-claude-code/agents/*.md ~/.claude/agents/
 
# 只要通用规则
cp -r everything-claude-code/rules/common ~/.claude/rules/
Q：支持 Cursor / OpenCode / Codex 吗？
全支持。安装时加 --target 参数：
./install.sh --target cursor typescript
./install.sh --target antigravity python

总结
everything-claude-code 本质上是把 10 个月实际生产经验提炼成的「AI 编程工作流标准化方案」，免费开源，中文文档完备（项目自带简体中文翻译）。
对国内开发者来说，有几点特别值得关注：
兼容自定义 API 端点，不强依赖 Anthropic 官方接口
安装方式灵活，按需取用，不用全量引入
Token 优化配置能实实在在省钱，尤其是团队规模使用
如果你已经在用 Claude Code，跟着上面的步骤装一遍，大概率会觉得「早装就好了」。
项目地址：github.com/affaan-m/everything-claude-code

Build with HAI｜portal.hai.network，一站接入全球顶尖 AI 模型。