SuperClaude Framework:把 Claude Code 变成结构化开发平台

SuperClaude 是一个元编程配置框架(meta-programming configuration framework):通过行为指令注入(behavioral instruction injection)与组件编排(component orchestration),把 Claude Code 变成一个结构化开发平台,提供系统化的工作流自动化。

给开发者与贡献者的核心文档

方式一:pipx(推荐)

# Install from PyPI
pipx install superclaude

# Install commands (installs all 30 slash commands)
superclaude install

# Install MCP servers (optional, for enhanced capabilities)
superclaude mcp --list         # List available MCP servers
superclaude mcp                # Interactive installation
superclaude mcp --servers tavily --servers context7  # Install specific servers

# Verify installation
superclaude install --list
superclaude doctor

装完重启 Claude Code,即可使用 30 条命令,包括:

• /sc:research —— 深度网络调研(以 Tavily MCP 增强)
• /sc:brainstorm —— 结构化头脑风暴
• /sc:implement —— 代码实现
• /sc:test —— 测试工作流
• /sc:pm —— 项目管理
• /sc —— 展示全部 30 条可用命令

方式二:从 Git 直接安装

# Clone the repository
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework

# Run the installation script
./install.sh

v5.0 预告(开发中)

团队正在开发新的 TypeScript 插件系统(详见 issue #419)。发布后安装将简化为:

# This feature is not yet available
/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
/plugin install superclaude

状态:开发中,未定 ETA。

可选 MCP 加速

想要 2–3 倍执行速度和省 30–50% token,可选装 MCP 服务器(经 airis-mcp-gateway):

• Serena —— 代码理解(2–3 倍提速)
• Sequential —— token 高效推理(省 30–50% token)
• Tavily —— Deep Research 的网络搜索
• Context7 —— 官方文档查询
• Mindbase —— 跨全部会话的语义搜索(可选增强,需 "recommended" 配置档)

注:错误学习(error learning)由内置的 ReflexionMemory 提供,无需安装。MCP 安装入口:airis-mcp-gateway,细则见仓库 docs/mcp/mcp-integration-policy.md。

原文注:4.1 版本聚焦于稳定斜杠命令架构、增强 agent 能力、改进文档。(README 中版本号并存:统计区标 v4.3.0 稳定版、本节标题为 v4.1、Deep Research 标 v4.2——按原文如实保留。)

SuperClaude v4.2 引入了完整的 Deep Research 能力——与 DR Agent 架构对齐的自主、自适应、智能网络调研。四大机制:

调研命令用法(原文示例)

# Basic research with automatic depth
/research "latest AI developments 2024"

# Controlled research depth (via options in TypeScript)
/research "quantum computing breakthroughs"  # depth: exhaustive

# Specific strategy selection
/research "market analysis"  # strategy: planning-only

# Domain-filtered research (Tavily MCP integration)
/research "React patterns"  # domains: reactjs.org,github.com

调研深度分级

工具编排

Deep Research 系统智能协调多个工具:Tavily MCP(主力网络搜索与发现)、Playwright MCP(复杂内容抽取)、Sequential MCP(多步推理与综合)、Serena MCP(记忆与学习的持久化)、Context7 MCP(技术文档查询)。

README 末尾附了按类别组织的完整命令列表(8 类):

详细参考:Commands Reference。

文档矩阵(原文四栏)

• 🚀 上手:Quick Start Guide(快速跑通)、Installation Guide(详细安装)
• 📖 用户指南:Slash Commands(30 命令分类)、Agents Guide(20 agents)、Behavioral Modes(7 模式)、Flags Guide(行为控制)、MCP Servers(8 集成)、Session Management(状态存取)
• 🛠️ 开发者资源:Technical Architecture、Contributing Code、Testing & Debugging
• 📋 参考:Examples Cookbook(真实世界菜谱)、Troubleshooting(常见问题)

贡献优先级(原文表)

支持项目

作者直白地说:维护 SuperClaude 要花时间和资源——光是测试用的 Claude Max 订阅就是每月 100 美元,还不算写文档、修 bug、做功能的时间。若它对你的日常工作有价值,可通过 Ko-fi(一次性)、Patreon(按月)、GitHub Sponsors(灵活档位)支持。资助用途:Claude Max 测试($100/月)、功能开发、文档、社区支持、MCP 集成测试、基础设施托管。原文也强调:无论是否捐助,框架保持开源;贡献代码、文档或帮忙宣传同样有用。

许可证:MIT License。

术语表(增补)

元编程配置框架

不改 Claude Code 本体,而是用配置(指令文件、命令定义)改变其行为的框架——「编程那个编程你代码的东西」。

行为指令注入

把行为规则(如模式、角色)以指令文本形式注入 Claude 的上下文,从而塑造它的工作方式。

/sc:* 命令

SuperClaude 安装的斜杠命令命名空间;/sc 可列出全部 30 条。

行为模式(mode)

一组预设的工作风格开关,如 Token-Efficiency 模式可省 30–50% 上下文。

多跳推理(multi-hop)

调研时以上一轮结果为线索发起下一轮搜索,最多 5 跳,逐层逼近答案。

pipx

把 Python CLI 工具装进独立虚拟环境的安装器,避免污染系统环境。