SuperClaude v4 설치 가이드 (PowerShell 7)

# 모든 요구 사항 한 번에 확인
Write-Host "=== 사전 요구 사항 확인 ===" -ForegroundColor Cyan

# PowerShell 버전
$psVersion = $PSVersionTable.PSVersion
Write-Host "PowerShell: $psVersion" -ForegroundColor $(if ($psVersion.Major -ge 7) { "Green" } else { "Red" })

# Python 버전
try {
    $pythonVersion = python --version 2>&1
    Write-Host "Python: $pythonVersion" -ForegroundColor Green
} catch {
    Write-Host "Python: 설치 필요" -ForegroundColor Red
}

# pipx 버전
try {
    $pipxVersion = pipx --version 2>&1
    Write-Host "pipx: $pipxVersion" -ForegroundColor Green
} catch {
    Write-Host "pipx: 설치 필요" -ForegroundColor Red
}

# Claude Code 버전
try {
    $claudeVersion = claude --version 2>&1
    Write-Host "Claude Code: $claudeVersion" -ForegroundColor Green
} catch {
    Write-Host "Claude Code: 설치 필요" -ForegroundColor Red
}

#!/bin/bash
echo "=== 사전 요구 사항 확인 ==="

# Ubuntu 버전
echo -n "Ubuntu: "
lsb_release -d | cut -f2

# Python 버전
echo -n "Python: "
python3 --version 2>/dev/null || echo "설치 필요"

# uv 버전
echo -n "uv: "
uv --version 2>/dev/null || echo "설치 필요"

# Claude Code 버전
echo -n "Claude Code: "
claude --version 2>/dev/null || echo "설치 필요"

# uv 설치
curl -LsSf https://astral.sh/uv/install.sh | sh

# PATH 적용 (자동으로 ~/.bashrc에 추가됨)
source ~/.bashrc

# 설치 확인
uv --version

# npm으로 설치
npm install -g @anthropic-ai/claude-code

# 또는 공식 설치 스크립트
curl -fsSL https://claude.ai/install.sh | sh

# 설치 확인
claude --version

# winget으로 설치 (권장)
winget install Microsoft.PowerShell

# 설치 후 새 터미널에서 확인
pwsh
$PSVersionTable.PSVersion

# winget으로 Python 설치
winget install Python.Python.3.12

# 설치 확인
python --version

# pip 업그레이드
python -m pip install --upgrade pip

# pipx 설치
python -m pip install --user pipx

# PATH에 pipx 추가
python -m pipx ensurepath

# 터미널 재시작 후 확인
pipx --version

# npm으로 설치
npm install -g @anthropic-ai/claude-code

# 또는 공식 설치 스크립트
irm https://claude.ai/install.ps1 | iex

# 설치 확인
claude --version

# 현재 사용자에 대해 스크립트 실행 허용
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 확인
Get-ExecutionPolicy -List

# SuperClaude 설치
pipx install superclaude

# 슬래시 명령어 설치 (30개)
superclaude install

# 설치 상태 확인
superclaude doctor

# 저장소 클론
git clone https://github.com/anthropics/superclaude.git

# 디렉토리 이동
cd superclaude

# 설치
pip install --user -e .

# uv 설치 (sudo 불필요)
curl -LsSf https://astral.sh/uv/install.sh | sh

# PATH 적용
source ~/.bashrc

# SuperClaude 설치
uv tool install superclaude

# 슬래시 명령어 설치
superclaude install

# 설치 확인
superclaude doctor

# 대화형 설치 (권장)
superclaude mcp

# 특정 서버만 설치
superclaude mcp --servers tavily context7

# 모든 서버 설치
superclaude mcp --all

# SuperClaude 진단 도구
superclaude doctor

# 해결: PATH 재설정
python -m pipx ensurepath

# 터미널 재시작 또는 PATH 새로고침
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

# 해결 1: pipx 경로 확인
pipx list

# 해결 2: 재설치
pipx uninstall superclaude
pipx install superclaude

# 해결 1: 명령어 재설치
superclaude install --force

# 해결 2: Claude Code 완전 재시작
# Windows: 작업 관리자에서 Claude 프로세스 종료 후 재실행

# 해결: PowerShell 7에서 UTF-8 강제 설정
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

# 영구 설정: 프로필에 추가
Add-Content $PROFILE '[Console]::OutputEncoding = [System.Text.Encoding]::UTF8'

# 1. 기존 v3 완전 제거
pipx uninstall superclaude

# 2. 잔여 파일 삭제
$claudeDir = "$env:APPDATA\Claude"
Remove-Item "$claudeDir\commands" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "$claudeDir\*.md" -Force -ErrorAction SilentlyContinue

# 3. v4 새로 설치
pipx install superclaude
superclaude install

# 해결: PATH 적용
source ~/.bashrc

# 또는 직접 PATH 추가
export PATH="$HOME/.local/bin:$PATH"

# 영구 설정 확인
grep '.local/bin' ~/.bashrc || echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

# 해결 1: uv 재설치
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

# 해결 2: 캐시 삭제 후 재설치
rm -rf ~/.cache/uv
uv tool install superclaude

# 해결: uv tool 경로 확인
uv tool list

# 재설치
uv tool uninstall superclaude
uv tool install superclaude

# pipx로 설치한 경우
pipx upgrade superclaude

# 슬래시 명령어도 업데이트
superclaude install --upgrade

pipx uninstall superclaude

winget install Microsoft.PowerShell
winget install Python.Python.3.12
python -m pip install --user pipx
python -m pipx ensurepath

pwsh
pipx install superclaude
superclaude install
superclaude doctor

superclaude mcp

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

uv tool install superclaude
superclaude install
superclaude doctor

superclaude mcp

claude
> /sc:research [주제]
> /sc:implement [기능]