Claude Code 开挂指南:这个开源项目让你的 AI 编程助手直接进化

1 阅读7分钟

原创 Hybrid AI Hub 


图片


这个项目是什么?

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 github.com/affaan-m/ev…

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 全部跑在本地,模型调用走你配的接口,完全透明。


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