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

openlab_7bf40019 更新于 6小时前



这个项目是什么?

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 模型。

0个评论