Skip to content
Get packs

Guide · Open source

How to use SuperClaude_Framework: install, run commands and verify

Updated · written with AI from the project's own documentation and checked against our catalogue data

SuperClaude_Framework is an open-source configuration framework that adds structured extras to Claude Code, Anthropic's coding assistant. It installs about 30 slash commands, agent personas and behavior modes. This guide is for developers who already use Claude Code and want to install SuperClaude with pipx, check the installation, and run its commands on real tasks.

SuperClaudeSuperClaude-Org/SuperClaude_Framework · ★ 23.9k · MIT

Quick start

  1. 1Install Claude Code. Make sure Claude Code is installed, since SuperClaude only extends that tool.
  2. 2Install pipx. pipx is the prerequisite for the README's recommended install from PyPI.
  3. 3Install the package. Run pipx install superclaude to install SuperClaude from PyPI.
  4. 4Install the slash commands. Run superclaude install to install the 30 slash commands.
  5. 5Verify the setup. Run superclaude doctor to check the installation.
  6. 6Restart and try a command. Restart Claude Code, then type /sc to list commands or try /sc:research.

What you need before installing SuperClaude

SuperClaude only extends Claude Code, so you need Claude Code installed first. The recommended install path uses pipx to install the package from PyPI, so pipx must also be available on your machine.

The project is MIT licensed and written in Python. It is aimed at people comfortable running Python tools from the command line.

  • Claude Code installed and working
  • pipx installed (used for the recommended PyPI install)
  • Comfort running commands in a terminal

Install SuperClaude and its slash commands

The README's recommended route is pipx. First install the package from PyPI, then run the install command, which places the slash commands for Claude Code.

After installation, restart Claude Code so it picks up the new commands. The README says this gives you 30 commands in total.

pipx install superclaude superclaude install

Verify the installation

Run the doctor command to check the setup. The README also lists a command to show the installed components.

If a check fails, the README points to its KNOWLEDGE.md file for troubleshooting insights, which is a good next place to look.

superclaude install --list superclaude doctor

Run your first SuperClaude commands in Claude Code

Commands are typed inside Claude Code as slash commands. The README names these as useful starting points. Type /sc to show all 30 available commands.

The README describes /sc:research as deep web research that is enhanced when the Tavily MCP server is installed. The Commands Reference at docs/user-guide/commands.md documents syntax and examples for every command.

  • /sc:brainstorm: structured brainstorming
  • /sc:implement: code implementation
  • /sc:test: testing workflows
  • /sc:pm: project management
  • /sc:research: deep web research
  • /sc: show all 30 commands
/sc:research

Decide whether to add optional MCP servers

MCP servers are optional. The README says SuperClaude is fully functional without them. It also lists optional servers including Serena, Sequential, Tavily, Context7 and Mindbase, and installs them through the superclaude mcp command.

The README claims 2-3x faster execution and 30-50% fewer tokens with MCP servers. These figures are the project's own and are not verified here, so treat them as claims to test on your own work.

  • Serena: code understanding
  • Sequential: token-efficient reasoning
  • Tavily: web search for Deep Research
  • Context7: official documentation lookup
  • Mindbase: semantic search across conversations (optional)
superclaude mcp --list superclaude mcp

Know the limits of the current version

The README says the TypeScript plugin system described in older documentation is not yet available and is planned for v5.0 with no ETA. Current installation uses the slash command method shown above.

The README also lists a direct install from Git with a clone and an install.sh script, which is an alternative to pipx.

  • The v5.0 plugin system is not yet available
  • Direct Git install uses the install.sh script in the cloned repository

What people use it for

  • Running a repeatable research workflow with /sc:research before starting a feature
  • Using /sc:implement and /sc:test to structure coding and testing tasks in a project
  • Keeping a consistent set of slash commands across several projects
  • Trying a structured brainstorming step with /sc:brainstorm before writing code

Frequently asked questions

Is SuperClaude free?

SuperClaude_Framework is released under the MIT licence, as shown in the project's README badge. The README also asks for optional financial support through Ko-fi, Patreon and GitHub Sponsors, which is not required to use the framework.

What do I need to install SuperClaude?

You need Claude Code, since SuperClaude only extends that tool, and pipx for the recommended install from PyPI. The project is written in Python, so you should be comfortable running Python tools from the command line.

How do I check that SuperClaude installed correctly?

Run superclaude doctor after installation. You can also run superclaude install --list to see the installed components, as listed in the README.

Do I need MCP servers to use SuperClaude?

No. The README says SuperClaude is fully functional without MCP servers. MCP servers are optional and add enhancements such as Tavily-powered web research.

Is SuperClaude the same as Claude Code?

No. Claude Code is Anthropic's coding assistant. SuperClaude is a separate configuration framework that adds commands, personas and modes to it. The project states it is not affiliated with or endorsed by Anthropic.

What are alternatives to SuperClaude?

The source lists Claude Code Templates and Awesome Claude Code as comparable projects. Look at their READMEs to compare which preset workflows and templates each one offers.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

SuperClaude suits developers who already use Claude Code and want preset slash commands and a consistent structure across projects. It is a poor fit if you do not use Claude Code, need the planned v5.0 plugin system now, or expect a guaranteed speedup, since the README's performance figures depend on optional MCP servers and are not verified.

Install options & downloads