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>
67 lines
1.5 KiB
Markdown
67 lines
1.5 KiB
Markdown
# 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
|
|
```bash
|
|
python3 -m SuperClaude --version # Should show 4.0.0
|
|
|
|
# If not working:
|
|
pip install --upgrade SuperClaude
|
|
python3 -m SuperClaude install
|
|
```
|
|
|
|
### 3. Permission Issues
|
|
```bash
|
|
# Permission denied errors:
|
|
pip install --user SuperClaude
|
|
# Or: sudo chown -R $USER ~/.claude
|
|
```
|
|
|
|
### 4. MCP Server Issues
|
|
```bash
|
|
/sc:analyze . --no-mcp # Test without MCP servers
|
|
node --version # Check Node.js 16+ if needed
|
|
```
|
|
|
|
### 5. Component Missing
|
|
```bash
|
|
python3 -m SuperClaude install --components core commands agents modes --force
|
|
```
|
|
|
|
## Platform-Specific Issues
|
|
|
|
**Windows:**
|
|
```cmd
|
|
set CLAUDE_CONFIG_DIR=%USERPROFILE%\.claude
|
|
python -m SuperClaude install --install-dir "%CLAUDE_CONFIG_DIR%"
|
|
```
|
|
|
|
**macOS:**
|
|
```bash
|
|
brew install python3 node
|
|
pip3 install SuperClaude
|
|
```
|
|
|
|
**Linux:**
|
|
```bash
|
|
sudo apt install python3 python3-pip nodejs
|
|
pip3 install SuperClaude
|
|
```
|
|
|
|
## Verification Checklist
|
|
- [ ] `python3 -m SuperClaude --version` returns 4.0.0
|
|
- [ ] `/sc:brainstorm "test"` works in Claude Code
|
|
- [ ] `SuperClaude install --list-components` shows components
|
|
|
|
## When Quick Fixes Don't Work
|
|
See [Troubleshooting Guide](troubleshooting.md) for advanced diagnostics. |