SuperClaude 安装和使用指南
SuperClaude 通过一个综合的配置框架,将 Claude Code 从通用 AI 助手转变为专业开发利器。这个开源项目提供了 19 个专用命令和 9 个认知角色,能够实现一致的、基于证据的开发工作流,同时将令牌使用量减少高达 70%。
该框架完全在本地运行,无任何外部依赖,是需要结构化 AI 辅助来贯穿整个开发生命周期的专业开发者的隐私友好解决方案。
SuperClaude 是什么
SuperClaude 是一个配置框架,而不是可执行软件 。它通过在 ~/.claude/
安装一个复杂的模板系统来工作,为 Claude Code 提供专业的思维模式、结构化命令和基于证据的方法论。
该系统包含四个核心组件:CLAUDE.md (主配置)、RULES.md (治理和实践)、PERSONAS.md (9 个认知原型)和 MCP.md(模型上下文协议操作)。这些组件协同工作,创建一个一致的开发伙伴,根据您的具体需求调整其专业知识。
主要差异化特性包括通过 Context7 集成的自动文档查找、用于上下文保存的基于 git 的检查点系统,以及在保持质量的同时显著减少令牌消耗的 UltraCompressed 模式。
安装要求和过程
前置条件:
- 必须安装并认证 Claude Code
- Git 配置有用户信息
- 支持的平台:Linux、macOS、Windows Subsystem for Linux (WSL)
基本安装只需三个命令:
bash
git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude
./install.sh
安装程序自动检测您的平台,为安全创建备份,并提供高级选项进行自定义:
bash
./install.sh --dir /custom/path # 自定义安装目录
./install.sh --update # 更新现有安装
./install.sh --dry-run --verbose # 安装前预览更改
./install.sh --verify # 验证安装完整性
安装验证确保一切正常工作:
bash
ls -la ~/.claude/ # 应该显示 4 个主要配置文件
ls -la ~/.claude/commands/ # 应该显示 17 个命令文件加索引
通过在 Claude Code 中打开任何项目并尝试以下命令来测试安装:
bash
/user:analyze --code
/persona:architect
九个认知角色系统
SuperClaude 的角色系统提供特定领域的专业知识,可以作为通用标志在所有命令中激活。每个角色体现了不同的思维模式和核心信念:
架构师 (--persona-architect
) 专注于系统设计和可扩展性,相信系统必须为变化而设计。用于规划大型系统和架构决策。
前端 (--persona-frontend
) 优先考虑用户体验和可访问性,相信用户需求胜过技术优雅。对于 UI/UX 工作和 React 开发至关重要。
后端 (--persona-backend
) 强调可靠性和性能,将其视为一切的使能器。对于服务器端开发和 API 设计至关重要。
安全 (--persona-security
) 专门从事威胁建模和安全编码实践,坚持认为安全必须是内置的,而不是后加的。对于安全审查和漏洞评估不可或缺。
分析师 (--persona-analyzer
) 擅长根本原因分析和基于证据的调试,理解每个症状都有多个潜在原因。非常适合复杂调试和调查。
其余角色(QA 、性能 、重构师 、导师)分别为测试、优化、代码改进和学习场景提供专业视角。
19 个专用命令
SuperClaude 将其命令组织成覆盖完整开发生命周期的逻辑类别:
开发命令 包括 /user:build
用于通用项目构建,带有 --react
、--api
和 --tdd
等标志;/user:dev-setup
用于环境配置;/user:test
用于综合测试工作流。
分析和改进命令 提供 /user:analyze
用于多维度代码分析,/user:troubleshoot
用于根本原因分析调试,/user:improve
用于代码和性能增强,/user:explain
用于深度技术解释。
运维命令 涵盖部署(/user:deploy
)、迁移(/user:migrate
)、安全扫描(/user:scan
)、项目评估(/user:estimate
)、维护(/user:cleanup
)和 git 工作流管理(/user:git
)。
设计和工作流命令 包括 /user:design
用于系统架构,/user:spawn
用于创建专门的子代理,/user:document
用于文档生成,/user:load
用于项目上下文加载。
通用标志和 MCP 集成
通用标志 在所有命令中工作以控制行为。规划标志 如 --plan
在运行前显示执行计划,而思考标志(--think
、--think-hard
、--ultrathink
)控制分析深度,从标准(约 4K 令牌)到关键(约 32K 令牌)。
MCP 服务器控制 提供对模型上下文协议工具的精细控制:--c7
启用 Context7 文档查找,--seq
激活 Sequential 思维进行复杂分析,--magic
启用 Magic UI 构建器,--pup
控制 Puppeteer 浏览器自动化。
**关键要求:**SuperClaude 不包含 MCP 服务器。您必须在 Claude Code 的 MCP 设置中单独安装 Context7、Sequential、Magic 和 Puppeteer 才能使用这些标志。
主要功能和令牌优化
UltraCompressed 模式 (--uc
)提供框架标志性的 70% 令牌减少,同时保持质量。这使用电报式压缩,删除冠词和连词,使用符号(→、&、@、w/、+、-)和缩写(cfg、fn、impl、env、dev、auth、API)。
基于证据的方法论执行"研究优先"政策,要求在实施前进行官方文档查找。这防止了无根据的声明,确保所有陈述都有证据支持。
基于 Git 的检查点能够导航回工作流中的任何点,保持项目历史并实现安全实验和无缝回滚功能。
使用模式和工作流
基本使用遵循自然模式:
bash
# 加载项目上下文并以架构师视角分析
/user:load --depth deep
/user:analyze --architecture --persona-architect
# 构建 React 应用,包含测试和 Magic UI 组件
/user:build --react --magic --tdd
# 使用专门角色进行安全审查
/user:scan --security --persona-security --owasp
高级工作流链接多个命令和角色:
bash
# 完整功能开发周期
/persona:architect → /user:design --api --ddd
/persona:backend → /user:build --api --tdd
/persona:frontend → /user:build --react --magic
/persona:qa → /user:test --coverage --e2e
/persona:security → /user:scan --security --deps
/user:deploy --env staging --plan
令牌优化策略使用 UltraCompressed 模式进行成本效益操作:
bash
/user:analyze --code --uc
/user:document --api --uc
/user:explain --depth expert --uc
重要警告和故障排除
常见安装问题 包括命令不工作(使用 ls ~/.claude/commands/
验证 - 应显示 17 个文件)、安装失败(使用 ./install.sh --verify
诊断)和角色激活问题(确保正确的标志语法 --persona-<名称>
)。
MCP 相关错误通常表示缺少 MCP 服务器。在使用相关标志之前,请在 Claude Code 的 MCP 设置中单独安装 Context7、Sequential、Magic 和 Puppeteer。
维护命令保持 SuperClaude 更新:
bash
# 更新 SuperClaude
cd SuperClaude && git pull && ./install.sh --update
# 备份配置
cp -r ~/.claude/ ~/.claude.backup.$(date +%Y%m%d)
# 完全卸载
rm -rf ~/.claude/
调试 SuperClaude 本身使用内省命令:
bash
/user:analyze --introspect # 调试 SuperClaude 行为
/user:troubleshoot --introspect --seq # 优化框架性能
/user:improve --introspect --persona-performance # 框架优化
国内直连镜像站推荐
cc-vibecoding.vip/ 注册联系免费体验