安装步骤
安装 uv
uv 作为 python 的包管理工具
bash
curl -Ls https://astral.sh/uv/install.sh | sh
安装 SuperClaude
bash
# 项目初始化,创建配置文件
uv init
# 环境管理,创建隔离的 Python 环境
uv venv
# 激活当前项目的 Python 环境
source .venv/bin/activate
# 安装 SuperClaude 依赖
uv pip install SuperClaude
执行 SuperClaude
必须在安装了 SuperClaude
依赖的 Python 环境中执行
bash
python3 -m SuperClaude inst
会将交互式配置的相关文件直接放在 当前用户的主目录
(图中红色区域)
运行效果

常用命令及用途
开发相关命令:
- /sc:implement - 功能实现:结合智能角色激活和 MCP 集成实现功能与代码
- /sc:build - 编译和打包:构建、编译和打包项目,并进行错误处理与优化
- /sc:design - 设计相关任务:设计系统架构、API 和组件接口
分析相关命令:
- /sc:analyze - 代码和系统分析: 分析代码质量、安全性、性能和架构
- /sc:troubleshoot - 调试和问题解决:诊断并解决代码、构建或系统行为中的问题
- /sc:explain - 提供解释说明:清晰解释代码、概念或系统行为
质量相关命令:
- /sc:improve - 代码改进:对代码质量、性能和可维护性进行系统性改进
- /sc:test - 测试: 执行测试、生成测试报告并维持测试覆盖率
- /sc:cleanup - 代码清理:清理代码、移除无用代码并优化项目结构
其他实用命令:
- /sc:document - 文档编写:为特定组件或功能创建针对性文档
- /sc:git - Git 相关操作: 执行 Git 操作,包括智能提交信息和分支管理
- /sc:estimate - 任务评估:为任务、功能或项目提供开发估算
- /sc:task - 任务管理:借助智能工作流管理和跨会话持久性执行复杂任务
- /sc:index - 索引:生成全面的项目文档和知识库
- /sc:load - 资源加载:加载并分析项目上下文、配置和依赖项
- /sc:spawn - 生成或创建子任务:将复杂任务分解为协调的子任务,以高效的方式进行
特性
自动激活系统
- Persona 自动选择: 根据任务类型自动激活专家角色
- MCP 服务器协调: 智能调用 Context7、Sequential、Magic、Playwright
- Wave 模式: 复杂任务自动启用多阶段执行
高级标志参数
bash
# 思考深度控制
--think: 4K tokens 模块级分析
--think-hard: 10K tokens 系统级分析
--ultrathink: 32K tokens 架构级分析
# 效率优化
--uc: 30-50% token 压缩
--delegate: 智能任务分发
--wave-mode: 复合智能执行
# 质量保证
--validate: 操作前风险评估
--safe-mode: 保守执行模式
--loop: 迭代改进模式
实际使用示例
bash
# 构建项目,自动检测 React Native
/sc:build --focus performance
# 实现新功能,自动选择前端专家
/sc:implement "用户登录组件" --type component
# 系统级性能分析,启用深度思考
/sc:analyze --focus performance --think-hard
# 代码质量提升,使用迭代模式
/sc:improve --quality --loop --iterations 3
# 复杂架构设计,启用 Wave 模式
/sc:design "学习系统架构" --wave-mode progressive
智能协调机制
MCP 服务器自动选择
- Context7: 文档查找、最佳实践
- Sequential: 复杂分析、系统思考
- Magic: UI 组件生成、设计系统
- Playwright: 测试、性能监控
专家角色自动激活
- architect: 系统设计任务
- frontend: UI/UX 相关工作
- security: 安全审计分析
- performance: 性能优化任务