📌 项目地址:SuperClaude-Org/SuperClaude_Framework | ⭐ 23,058 颗星 | 🔧 Python | 📜 MIT
Claude Code 的核心问题:每次会话都“失忆”
用 Claude Code 写过几个文件后,你会发现一个规律:每开一个新会话,都得重讲一遍项目规范。
“这个项目用 FastAPI,数据库用 PostgreSQL,用户 ID 用 UUIDv4,不要用自增主键。返回格式统一用 {code, message, data}。对了,错误处理要统一写在中间件里……”
你讲一遍,AI 记住了,写了几个文件。然后会话因超时或意外中断。重新启动后——它又忘了。你得再说一遍。
不是 AI 不聪明,是 Claude Code 每次会话都是独立上下文。除非你把规则写进系统 prompt 里,否则它每次都是“空脑”状态。
SuperClaude 就是为解决这个问题来的。它在 GitHub 上有 23058 颗星,说明很多人跟我一样被这个痛点折磨。
它不是增强包,是约束框架
SuperClaude 的做法不是在 Claude Code 外面包一层新功能,而是用一个配置文件体系提前告诉 AI:“这个项目的规矩是什么,遇到什么情况怎么处理。”
README 原文说它是“a meta-programming configuration framework that transforms Claude Code into a structured development platform through behavioral instruction injection and component orchestration”。翻译成人话:用文件和命令给 AI 预设行为规则,让它每次启动时自动加载。
核心机制是三份 Markdown 文件:
- PLANNING.md:定义架构规则和设计原则。比如“所有数据库操作必须走 Repository 模式”“禁止在控制器中直接操作模型”。
- TASK.md:列出当前任务优先级。比如“本周目标:完成用户模块的 CRUD 接口,修复订单查询的性能问题”。
- KNOWLEDGE.md:记录之前踩过的坑和最佳实践。比如“注意:支付回调有幂等性问题,需要加去重逻辑”。
README 强调 Claude Code“reads these files at session start”。这意味着 AI 从第一秒就知道规矩,不需要你重复。
我试了一下:在 KNOWLEDGE.md 里写了一条“用户 ID 字段必须是 UUIDv4,不用自增整数”。之后每次让 AI 生成数据库模型,它都自动用 UUID。最直观的感受是:你不需要在每一个 prompt 里强调规则,AI 自己会读。
30 个命令:把对话变成操作面板
SuperClaude 提供了 30 个以 /sc:* 开头的斜杠命令。README 说它们覆盖了“complete development lifecycle from brainstorming to deployment”。
我实际用过几个,感受很直接:
/sc:review:代码审查。原生 Claude Code 也能审,但质量不稳定——这次关注安全,下次可能只改风格。这个命令指定了审查维度,输出格式固定。结果更可预测。
/sc:debug:有一次遇到一个诡异的 null pointer 异常。发这个命令,AI 启用了更谨慎的调试模式,逐行解释变量状态,定位到了问题。比直接说“帮我找 bug”有效,因为命令预设了调试策略。
docs/user-guide/commands.md:README 提到这个文档包含“visual decision trees, detailed command comparisons, and workflow examples”,帮你判断用什么命令。我没细看,但命令参考是必读的。
对比一下交互模式的区别:
- 原生 Claude Code:你说“review this code”→AI 自由发挥,输出取决于你 prompt 的细节
- SuperClaude:你敲
/sc:review→ AI 按预设标准执行,输出格式固定
30 个命令相当于 30 个预设工作流节点。你不需要想 prompt 怎么写,选节点就行。
四维框架:命令、代理、模式、服务
README 列了框架的四维数据:
| 项目 | 数量 | 说明 |
|---|---|---|
| Commands | 30 | 斜杠命令 |
| Agents | 20 | 专门化 AI 角色 |
| Modes | 7 | 行为模式 |
| MCP Servers | 8 | 外部集成接口 |
20 个 Agents 是“Specialized AI”,7 个 Modes 是“Behavioral”模式,8 个 MCP Servers 是集成接口。README 没有详细解释每个的具体用法。我推测:Agents 负责不同角色(架构师、测试员),Modes 控制回答风格(严谨、创意),MCP 服务器用于连接外部工具。
我试了下 MCP 的安装:
superclaude mcp --list
它会列出可用的 MCP 服务器。按 README 描述,它们是“optional, for enhanced capabilities”。要不要装取决于你的项目需要集成什么外部工具——如果你只是写写代码,可以不装。
安装与两个注意事项
当前稳定版 v4.3.0。安装流程:
pipx install superclaude
superclaude install
第一行从 PyPI 安装包。第二行安装所有 30 个斜杠命令。装完后在 Claude Code 输入框敲 / 就能看到这些命令。
两个需要知道的事:
-
插件系统还没出。README 特意用大字提醒:“The TypeScript plugin system described in older documentation is not yet available (planned for v5.0)。” 意思是如果有人跟你吹 SuperClaude 的插件系统,目前版本没有,别白等。
-
不是官方项目。README 开头明确写了:“This project is not affiliated with or endorsed by Anthropic。” Claude Code 是 Anthropic 的产品,这个框架不是官方出品。Claude Code 更新时,框架可能需要适配,没有兼容性保证。
我的评价
SuperClaude 解决的核心问题是:AI 编程从自由发挥变成可控工程。方法是配置文件定义规则、命令定义操作、代理和模式定义行为风格。这三样是传统软件工程的核心要素。
它不适合所有人。如果你只写几行脚本,装 30 个命令是有点重。但如果你在用 Claude Code 写正经项目,受够了每次重设 AI 上下文,它值得一试。两万三千星不是白拿的。
最后说一个实际感受:装完之后,我发现最常用的不是某个具体命令,而是“不用再想 prompt 怎么写”这个事实。省掉的是决策成本。