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/ 注册联系免费体验