mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
850e5a69a6
- Standardize documentation structure across all sections - Fix CLI confusion and streamline user guidance - Remove fictional content and align with actual functionality - Improve technical architecture documentation - Update installation and quick-start guides - Enhance reference materials and examples 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1.5 KiB
1.5 KiB
SuperClaude Common Issues - Quick Reference 🚀
Problem Solving Guide: Most frequent issues with practical solutions.
Top 5 Quick Fixes (90% of Issues)
1. Commands Not Working in Claude Code ⚡
Problem: /sc:brainstorm doesn't work
Solution: Restart Claude Code completely
Test: /sc:brainstorm "test" should ask questions
2. Installation Verification
python3 -m SuperClaude --version # Should show 4.0.0
# If not working:
pip install --upgrade SuperClaude
python3 -m SuperClaude install
3. Permission Issues
# Permission denied errors:
pip install --user SuperClaude
# Or: sudo chown -R $USER ~/.claude
4. MCP Server Issues
/sc:analyze . --no-mcp # Test without MCP servers
node --version # Check Node.js 16+ if needed
5. Component Missing
python3 -m SuperClaude install --components core commands agents modes --force
Platform-Specific Issues
Windows:
set CLAUDE_CONFIG_DIR=%USERPROFILE%\.claude
python -m SuperClaude install --install-dir "%CLAUDE_CONFIG_DIR%"
macOS:
brew install python3 node
pip3 install SuperClaude
Linux:
sudo apt install python3 python3-pip nodejs
pip3 install SuperClaude
Verification Checklist
python3 -m SuperClaude --versionreturns 4.0.0/sc:brainstorm "test"works in Claude CodeSuperClaude install --list-componentsshows components
When Quick Fixes Don't Work
See Troubleshooting Guide for advanced diagnostics.