大数跨境
0
0

别只用原生 Claude Code!试试这款 SuperClaude 神器(github 万赞项目)

别只用原生 Claude Code!试试这款 SuperClaude 神器(github 万赞项目) 和平本记
2025-07-24
21


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]

  1. 先安装包
  2. 运行安装程序

官方文档地址:

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 会根据你的指令自动激活相应的专家,等到你用熟练了,不满足于只用这两个命令,想要进一步探索的时候,再去查官方文档,看看别的命令的使用方法。

【声明】内容源于网络
0
0
和平本记
0帧起手,在学习海外网站开发,把每天记在小本子上的私藏干货偷偷分享给你
内容 11
粉丝 0
和平本记 0帧起手,在学习海外网站开发,把每天记在小本子上的私藏干货偷偷分享给你
总阅读443
粉丝0
内容11