1、SuperClaude 介绍
SuperClaude 是 github 上的一个开源项目,地址:
https://github.com/SuperClaude-Org/SuperClaude_Framework
是一个用来增强 Claude Code 开发体验的框架,通俗一点来说,SuperClaude 就像是给 Claude Code 请了一个专业的开发团队,它不是替代 Claude Code,而是让它变得更聪明,更懂开发工作。[k]
而且 SuperClaude 官方仓库维护的很活跃,我在写这篇帖子的时候,发现 11 个小时之前刚提交更新代码[k]
毫无疑问,Claude Code 的编程能力非常强大,但是它更多提供的是一个通用解决方案,对于没有经验的小白来说,缺乏专业的开发方法。[k]
SuperClaude 会预定义一系列工作流整合到 claude code 中,让用户能够用更专业、更规范的方式来开发。[k]
2、如何部署和安装 SuperClaude
2.1 安装 Cloud Code
首先要确保本地已经安装了 Cloud Code,因为我们这里重点介绍 SuperClaude,关于如何安装 Cloud Code 这里不花过多的篇幅多做介绍,网上很多教程。Cloud Code 安装好之后,如果没有官方账号,可以使用 kimi k2 驱动,效果也不错。[k]
重要的步骤就是下面这一行命令[k]
1npminstall-g @anthropic-ai/claude-code
2.2 安装SuperClaude
安装方法,官网写的非常清楚,一共两步:[k]
- 先安装包
- 运行安装程序
官方文档地址:
https://github.com/SuperClaude-Org/SuperClaude_Framework/tree/master
2.2.1 先安装包
我们选择 Option B 用源码方式安装[k]
在自己的电脑上新建一个文件夹,然后执行上面的命令[k]
但是这里需要注意一下,UV 是 Python 的包管理器,跟Python 的另一个包管理器pip类似,通过包管理器去下载安装包[k]
使用上面文档中 Option A 和 Option B 的两种安装方式,这两种方式(uv add/uv sync)都假设你在一个 Python 项目目录下,有 pyproject.toml requirements.txt。[k]
但是如果我们写的是前端,使用的是 TypeScript 项目通常没有这些 Python 配置文件,就不适合用这两种方式了[k]
我们把文档往下翻,它还给我们提供了跨平台的安装方式:[k]
这种是全局安装,安装完之后,在任何目录下都能直接用 SuperClaude 命令。[k]
执行之前你要先看一下自己有没有安装 uvx 没有的话需要先安装一下,使用下面命令查看,如果出现版本号证明安装成功[k]
UVX:适合全局安装命令行工具,互不干扰,安全方便。[k]
直接在命令行执行命令,安装成功会出现 Successfully[k]
注意:[k]
安装的时候关掉魔法,否则可能安装不成功[k]
2.2.2 运行安装程序
我们上一部相当于只是把 SuperClaude 的包安装好了,还没有对他进行初始化[k]
运行安装程序之后,SuperClaude 才能正常工作,相关命令和功能才会生效。[k]
我们直接使用命令:[k]
python3 -m SuperClaude install
安装类型直接选择第一个,快速安装[k]
这是最简单、最全面的方案,包含 SuperClaude 的关键功能模块:命令(slash 命令)、核心框架、MCP 集成(如 Context7、Magic UI、Playwright)以及 Claude Code 钩子等组件。[k]
SuperClaude 是安装在我们用户目录下的 .claude 文件夹下[k]
安装成功
2.3 安装 mcp
我们前面选的是快速安装,这种安装方式会给我们安装核心框架 + 16 个斜杠命令[k]
但是一些必要的 mcp 他没有给我安装,所以需要我们自己动手去安装。[k]
需要安装的 mcp
- Context7 :官方库文档和模式抓取
- Sequential :多步骤复杂思考辅助
- Magic :现代 UI 组件生成
- Playwright :浏览器自动化与测试
安装命令:
claude mcp add --transport http context7 https://mcp.context7.com/mcp
claude mcp add sequential-thinking npx @modelcontextprotocol/server-sequential-thinking
claude mcp add playwright npx @playwright/mcp@latest
使用 claude mcp list 可以看到自己安装了哪些 mcp[k]
3、SuperClaude 核心特性
3.1 结构化命令
| 阶段 | 代表命令 | 典型 flags / 说明 |
|---|---|---|
| 开发 | /sc:implement (功能雏形) /sc:build (编译/打包) /sc:design (架构&API) | --feature, --react, --api |
| 分析 / 调试 | /sc:analyze (全局体检) /sc:troubleshoot (故障排查) /sc:explain (代码讲解) | --security, --perf, --depth |
| 质量改进 | /sc:test (TDD&覆盖率) /sc:improve (性能/重构) /sc:cleanup (死代码清理) | --tdd, --coverage, --refactor |
| 运维 / 工作流 | /sc:deploy (灰度/回滚) /sc:git (提交&Checkpoint) /sc:task (任务面板) | --env, --checkpoint, --status |
| 设计 / 文档 | /sc:document (自动文档) /sc:estimate (工时预估) | --format markdown / html |
| 自动化 | /sc:index (指令导航) /sc:load (上下文理解) /sc:spawn (生成子代理) | --persona-backend, --wave |
你会发现上面结构化命令都是用的一套以 /sc:<动作> 为前缀的命令,sc 就是 superclaude 的首字母缩写,通过这一套命令把软件开发的整个流程拆成了可复用的脚本化步骤。[k]
结构化命令构成要素:
1)动作/sc:build、/sc:test … 这些决定主流程。[k]
2)Persona--persona-architect 设定角色,把思维定向到系统设计专家[k]
3)Flags--plan 仅输出执行蓝图;--uc 启用 70 % Token 压缩,给命令添加参数[k]
4)MCP调用--c7 查官方文档(Context7);--magic 自动生成 UI 组件。[k]
也就是说,这些命令后面还可以跟参数的,superclaude 支持后面还能搭配 9 个不同领域的专家角色 + MCP 工具 + 丰富的参数组合使用,有了这一套你使用 claude code 就像有一支 AI 团队一样协同工作。[k]
案例:
假设你在一个已有的 React 项目中,需要新增一个 「订阅按钮」功能,并希望 UI 由 AI 生成,代码整合、测试覆盖、代码审查齐上。可以用下面这个命令:[k]
/sc:implement subscribe-button --react --magic --persona-frontend --tdd --coverage --plan
命令解析:[k]
/sc:implement subscribe-button- 为功能 subscribe-button 创建雏形,包括逻辑和交互设计。
- subscribe-button 是功能名字,可以自定义选取
--react- 生成一个 react 组件
--magic(Magic MCP)- 自动调用 MCP 的 Magic 模块,生成 Figma 级别设计并导出 UI 组件。
--persona-frontend- 切换到前端专家视角,AI 会用前端专家的身份来开发这个功能
--tdd --coverage- 要求 AI 使用测试驱动开发,并生成覆盖率报告,保证组件质量。
--plan- 在执行前生成完整的执行计划,展示将采取的步骤:从组件结构到测试再到代码合并。
可以看到这一整条命令,覆盖了结构化命令、Persona 角色专家、MCP UI 工具、测试控制、执行规划 ,通过这一条命名 AI 能完成从设计到开发到测试一条龙服务[k]
3.2 预定义角色
什么是预定义角色?
想象一下在一家成熟的企业中,一定会有各种各样的专家,有了这些专家的帮助,你就能更加专业高效的完成你的工作。[k]
- 当你对整个项目结构感到困惑时,你会去找架构师画蓝图。
- 当你要实现一个具体的后端接口时,你会请教后端专家。
- 当你担心密码存储是否安全时,你会拉上安全专家来做评审。
SuperClaude 也是类似,内置了 11 种专家身份,当我们使用 claude code 时,它是以一个通用 AI 的身份来回答和完成我们的任务的,有了专家身份之后,它的回答视角就更专一,输出的质量也更高。[k]
| 角色名称 | 职责描述 |
|---|---|
| architect | 🏗️ 系统设计专家 |
| frontend | 🎨 UI/UX 与无障碍专家 |
| backend | ⚙️ API 与基础设施专家 |
| security | 🛡️ 威胁建模与漏洞专家 |
| performance | ⚡ 优化与瓶颈专家 |
| analyzer | 🔍 根因调查专家 |
| qa | 🧪 测试与质量保证专家 |
| refactorer | 🔄 代码质量与清理专家 |
| devops | 🚀 基础设施与部署专家 |
| mentor | 👨🏫 教育指导专家 |
| scribe | ✍️ 专业文档专家 |
这11 个预定义角色(Persona)就是为了让 Claude 以“专家身份”参与开发,带来更专业、更聚焦的决策与输出。
我们使用的时候只需要用,--persona-角色名称即可 例如:
--persona-architect 让 AI 以系统设计专家身份参与开发
4、真实开发使用案例
1、review 代码
1)直接使用提示词让 claude code 把写完的代码 review 一下
这是我得到的 review 报告,里面有推荐改进部分:
2)我们使用 superclaude 的命令去 review 代码
/sc:analyze components/nodes/SequenceNode.tsx --focus quality --seq --persona-qa
上面命令解析:
components/nodes/SequenceNode.tsx- 我要 review 的具体代码文件,可以写多个,或者文件夹
--focus quality- 指定分析重点为代码质量。
--seq- 这是一个 MCP ,可以让 claude 系统性分析
--persona-qa- 激活“质量保证(QA)专家”角色。
综上,这条命令执行以后,superclaude 会从 QA 专家视角,去给出你代码的 review 结果
下面是 superclaude 以(QA)专家角色出的 review 报告,要严谨专业非常多
最后,superclaude 这么多命令,记不住不会用怎么办?
完全不用担心,直接上手用就行了,官方文档也说了不需要记住他们,只需要一开始从/sc:analyze 或 /sc:implement 用起来就行了
Superclaude 会根据你的指令自动激活相应的专家,等到你用熟练了,不满足于只用这两个命令,想要进一步探索的时候,再去查官方文档,看看别的命令的使用方法。


