Claude Code 开挂指南:这个开源项目让你的 AI 编程助手直接进化
这个项目是什么?
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/agent*****d ~/.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 模型。