Claude Code power-up installer - SuperClaude + Spec Kit + Claude-Z + Claude HUD
npm install zuppaclaude


> ⚡ Claude Code için tek komutla kurulum paketi - SuperClaude + Spec Kit + Claude-Z + Claude HUD
---
ZuppaClaude, Claude Code deneyiminizi güçlendiren araçları tek komutla kurar:
| Araç | Açıklama |
|------|----------|
| ⚡ SuperClaude | 30+ slash komutu ile gelişmiş iş akışları |
| 📋 Spec Kit | Spec-driven development CLI aracı |
| 🌐 Claude-Z | z.ai backend desteği (opsiyonel) |
| 📊 Claude HUD | Gerçek zamanlı durum göstergesi (opsiyonel) |
| 📝 CLAUDE.md | Optimize edilmiş sistem talimatları |
#### 📦 NPM ile (Önerilen)
``bash`
npx zuppaclaude
Veya global kurulum:
`bash`
npm install -g zuppaclaude
zuppaclaude
#### 🐚 Shell ile
🍎 macOS / 🐧 Linux:
`bash`
curl -fsSL https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/install.sh | bash
🌍 Alternatif (jsDelivr CDN):
`bash`
curl -fsSL https://cdn.jsdelivr.net/gh/hasankaantan/zuppaclaude@main/install.sh | bash
🪟 Windows:
`powershellWinget ile (önerilen)
winget install Anthropic.ClaudeCode
$3
Kurulum scripti eksik bağımlılıkları otomatik kontrol eder:
| Gereksinim | Açıklama |
|------------|----------|
| 💻 OS | macOS, Linux veya Windows 10+ |
| 📦 Node.js | 18.0 veya üzeri |
| 🐍 Python | 3.8 veya üzeri |
| 📂 git | Versiyon kontrol |
| 🤖 Claude Code | v2.x (önerilir) |
$3
1. 🔄 Claude Code'u yeniden başlat
2. ⚡ SuperClaude test et:
`
/sc:help
`3. 📋 Spec Kit test et:
`bash
specify --help
`4. 🌐 Claude-Z test et (kurulduysa):
`bash
claude-z
`$3
#### 🎯 Planlama & Tasarım
| Komut | Açıklama |
|-------|----------|
|
/sc:brainstorm | 💡 Fikir geliştirme |
| /sc:design | 🏗️ Mimari tasarım |
| /sc:estimate | ⏱️ Zaman/kaynak tahmini |
| /sc:spec-panel | 📑 Spesifikasyon paneli |#### 💻 Geliştirme
| Komut | Açıklama |
|-------|----------|
|
/sc:implement | ⚙️ Kod implementasyonu |
| /sc:build | 🔨 Build ve derleme |
| /sc:improve | ✨ Kod iyileştirme |
| /sc:explain | 📖 Kod açıklama |#### 🧪 Test & Kalite
| Komut | Açıklama |
|-------|----------|
|
/sc:test | 🧪 Test oluşturma |
| /sc:analyze | 🔍 Kod analizi |
| /sc:troubleshoot | 🐛 Hata ayıklama |
| /sc:reflect | 🪞 Retrospektif |#### 📊 Proje Yönetimi
| Komut | Açıklama |
|-------|----------|
|
/sc:task | ✅ Görev yönetimi |
| /sc:workflow | 🔄 İş akışı yönetimi |
| /sc:pm | 📈 Proje yönetimi |$3
`bash
specify init # 🚀 Proje başlat
specify constitution # 📜 Proje kuralları
specify spec # 📋 Fonksiyonel gereksinimler
specify plan # 📐 Teknik plan
specify tasks # ✅ Görev breakdown
`$3
Kurulum sırasında Z.AI API key'inizi girmeniz istenir (z.ai adresinden alın).
`bash
z.ai backend ile Claude Code çalıştır
claude-z
`🔌 Sağladığı MCP Serverlar:
| Server | Açıklama |
|--------|----------|
|
web-search-prime | 🔍 Gelişmiş web arama |
| web-reader | 📄 Web sayfası okuma |
| zread | 📚 Doküman okuma |
| zai-mcp-server | 🔗 Z.AI MCP entegrasyonu |$3
Claude Code'a gerçek zamanlı statusline ekler. Kurulum sırasında etkinleştirmeyi seçebilirsiniz.
📈 Gösterdikleri:
- 📊 Context window kullanımı
- 🔧 Aktif araçlar ve dosya işlemleri
- 🤖 Çalışan agent'lar
- ✅ Todo/görev ilerlemesi
⚙️ Kurulum sonrası:
`bash
setup-claude-hud # Talimatları gösterir
`Ardından Claude Code içinde:
`
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup
`$3
ZuppaClaude kurulumunuzun sağlığını kontrol edin:
`bash
npx zuppaclaude doctor # 🔍 Sistem kontrolü
`Veya Claude Code içinden:
`
/zc:doctor
`🔍 Kontrol Edilen Öğeler:
| Kategori | Kontroller |
|----------|------------|
| 💻 Sistem | OS, Node.js versiyonu, disk alanı |
| 🤖 Claude Code | Versiyon, güncellik, dizin |
| 📦 ZuppaClaude | Versiyon, güncellik, ayarlar |
| 🧩 Bileşenler | SuperClaude, Spec Kit, Claude-Z, HUD, rclone |
| 🔧 Bağımlılıklar | Git, Python, Pip |
| 🌐 Ortam | Environment variables |
$3
ZuppaClaude seçimlerinizi kaydeder ve tekrar kurulumda otomatik kullanır.
📦 NPM ile:
`bash
npx zuppaclaude settings show # 👁️ Ayarları görüntüle
npx zuppaclaude settings export ~/backup.json # 💾 Dışa aktar
npx zuppaclaude settings import ~/backup.json # 📥 İçe aktar
npx zuppaclaude settings reset # 🔄 Fabrika ayarları
`🐚 Shell ile:
`bash
./zc-settings.sh show # 👁️ Ayarları görüntüle
./zc-settings.sh export ~/backup.json # 💾 Dışa aktar
./zc-settings.sh import ~/backup.json # 📥 İçe aktar
./zc-settings.sh reset # 🔄 Fabrika ayarları
`✨ Özellikler:
| Özellik | Açıklama |
|---------|----------|
| 💾 Otomatik kayıt | Kurulum sonrası tercihler kaydedilir |
| ⚡ Hızlı kurulum | Önceki ayarlarla tek komutla kurulum |
| 🔐 API key koruması | Base64 encoded saklama |
| 🛡️ Uninstall koruması | Kaldırırken ayarları koruma opsiyonu |
$3
Claude Code session'larınızı ve ayarlarınızı yedekleyin. Context kaybı, format veya compacting durumlarında kullanışlı.
🔄 Tam Yedekleme (Sessions + Ayarlar):
`bash
npx zuppaclaude backup # 💾 Lokal tam yedek
npx zuppaclaude backup --cloud gdrive # ☁️ Google Drive'a yedekle
npx zuppaclaude restore # ♻️ Yedekten geri yükle
npx zuppaclaude restore --cloud gdrive # ☁️ Cloud'dan geri yükle
`📋 Sadece Session İşlemleri:
`bash
npx zuppaclaude session list # 📋 Tüm session'ları listele
npx zuppaclaude session backup # 💾 Sadece session'ları yedekle
npx zuppaclaude session backups # 📦 Mevcut yedekleri listele
`$3
Google Drive, Dropbox, OneDrive, S3, SFTP ve 40+ cloud servise yedekleme.
`bash
Kurulum
brew install rclone # macOS
rclone config # Remote ayarla (gdrive, dropbox vs.)Kullanım
npx zuppaclaude cloud setup # 📖 Kurulum talimatları
npx zuppaclaude cloud remotes # 📋 Mevcut remote'ları listele
npx zuppaclaude backup --cloud gdrive # ☁️ Yedekle ve upload et
npx zuppaclaude cloud backups gdrive # 📦 Cloud'daki yedekleri listele
`✨ Özellikler:
| Özellik | Açıklama |
|---------|----------|
| 🔒 Güvenli restore | Mevcut session'lar üzerine yazılmaz |
| 📜 Tam yedek | Sessions + Settings + History |
| ☁️ 40+ cloud | rclone ile Google Drive, Dropbox, S3, SFTP... |
| 🔐 Encryption | rclone encryption desteği |
$3
PRD (Product Requirements Document) dosyasındaki user story'leri otomatik olarak implement eden otonom AI agent döngüsü.
🚀 Başlatma:
`bash
npx zuppaclaude ralph init # 📁 Proje dosyalarını oluştur
npx zuppaclaude ralph run # 🔄 Döngüyü başlat (varsayılan: 10 iterasyon)
npx zuppaclaude ralph run 20 # 🔄 20 iterasyon ile çalıştır
npx zuppaclaude ralph status # 📊 PRD durumunu göster
`📂 Dosyalar:
| Dosya | Açıklama |
|-------|----------|
|
prd.json | User story'ler ve pass/fail durumu |
| ralph-prompt.md | Her iterasyona verilen talimatlar |
| progress.txt | Öğrenilen şeyler (kalıcı bellek) |
| AGENTS.md | Kod pattern'leri ve convention'lar |🔄 Nasıl Çalışır:
1. PRD'den en yüksek öncelikli incomplete story'yi seçer
2. Minimal, focused değişiklikler yapar
3. Quality check'leri çalıştırır (typecheck, lint, test)
4.
progress.txt'e öğrenilenleri yazar
5. Story'yi passes: true olarak işaretler
6. Sonraki iterasyona geçer> 💡 snarktank/ralph projesinden esinlenilmiştir.
$3
📦 NPM ile:
`bash
npx zuppaclaude uninstall
`🐚 Shell ile:
🍎 macOS / 🐧 Linux:
`bash
curl -fsSL https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/uninstall.sh | bash
`🪟 Windows:
`powershell
irm https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/uninstall.ps1 | iex
`$3
| Dosya | 🍎🐧 macOS/Linux | 🪟 Windows |
|-------|------------------|------------|
| ⚡ SuperClaude |
~/.claude/commands/sc/ | %USERPROFILE%\.claude\commands\sc\ |
| 📝 Konfigürasyon | ~/.claude/CLAUDE.md | %USERPROFILE%\.claude\CLAUDE.md |
| 🌐 Claude-Z | ~/.local/bin/claude-z | %USERPROFILE%\.local\bin\claude-z.cmd |
| 📊 Claude HUD | ~/.local/bin/setup-claude-hud | %USERPROFILE%\.local\bin\setup-claude-hud.cmd |
| 🔧 Z.AI Config | ~/.config/zai/ | %USERPROFILE%\.config\zai\ |
| ⚙️ Ayarlar | ~/.config/zuppaclaude/ | %USERPROFILE%\.config\zuppaclaude\ |---
🇬🇧 English
$3
ZuppaClaude installs tools to supercharge your Claude Code experience with a single command:
| Tool | Description |
|------|-------------|
| ⚡ SuperClaude | 30+ slash commands for enhanced workflows |
| 📋 Spec Kit | Spec-driven development CLI tool |
| 🌐 Claude-Z | z.ai backend support (optional) |
| 📊 Claude HUD | Real-time status display (optional) |
| 📝 CLAUDE.md | Optimized system instructions |
$3
#### 📦 Via NPM (Recommended)
`bash
npx zuppaclaude
`Or install globally:
`bash
npm install -g zuppaclaude
zuppaclaude
`#### 🐚 Via Shell
🍎 macOS / 🐧 Linux:
`bash
curl -fsSL https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/install.sh | bash
`🌍 Alternative (jsDelivr CDN):
`bash
curl -fsSL https://cdn.jsdelivr.net/gh/hasankaantan/zuppaclaude@main/install.sh | bash
`🪟 Windows:
`powershell
With Winget (recommended)
winget install Anthropic.ClaudeCodeor PowerShell script
irm https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/install.ps1 | iex
`$3
The installer automatically checks for missing dependencies:
| Requirement | Description |
|-------------|-------------|
| 💻 OS | macOS, Linux, or Windows 10+ |
| 📦 Node.js | 18.0 or higher |
| 🐍 Python | 3.8 or higher |
| 📂 git | Version control |
| 🤖 Claude Code | v2.x (recommended) |
$3
1. 🔄 Restart Claude Code
2. ⚡ Test SuperClaude:
`
/sc:help
`3. 📋 Test Spec Kit:
`bash
specify --help
`4. 🌐 Test Claude-Z (if installed):
`bash
claude-z
`$3
#### 🎯 Planning & Design
| Command | Description |
|---------|-------------|
|
/sc:brainstorm | 💡 Idea development |
| /sc:design | 🏗️ Architectural design |
| /sc:estimate | ⏱️ Time/resource estimation |
| /sc:spec-panel | 📑 Specification panel |#### 💻 Development
| Command | Description |
|---------|-------------|
|
/sc:implement | ⚙️ Code implementation |
| /sc:build | 🔨 Build and compile |
| /sc:improve | ✨ Code improvement |
| /sc:explain | 📖 Code explanation |#### 🧪 Testing & Quality
| Command | Description |
|---------|-------------|
|
/sc:test | 🧪 Test creation |
| /sc:analyze | 🔍 Code analysis |
| /sc:troubleshoot | 🐛 Debugging |
| /sc:reflect | 🪞 Retrospective |#### 📊 Project Management
| Command | Description |
|---------|-------------|
|
/sc:task | ✅ Task management |
| /sc:workflow | 🔄 Workflow management |
| /sc:pm | 📈 Project management |$3
`bash
specify init # 🚀 Initialize project
specify constitution # 📜 Project rules
specify spec # 📋 Functional requirements
specify plan # 📐 Technical plan
specify tasks # ✅ Task breakdown
`$3
During installation, you'll be asked for your Z.AI API key (get it from z.ai).
`bash
Run Claude Code with z.ai backend
claude-z
`🔌 Provided MCP Servers:
| Server | Description |
|--------|-------------|
|
web-search-prime | 🔍 Enhanced web search |
| web-reader | 📄 Web page reading |
| zread | 📚 Document reading |
| zai-mcp-server | 🔗 Z.AI MCP integration |$3
Adds a real-time statusline to Claude Code. You can enable it during installation.
📈 What it shows:
- 📊 Context window usage
- 🔧 Active tools and file operations
- 🤖 Running agents
- ✅ Todo/task progress
⚙️ After installation:
`bash
setup-claude-hud # Shows instructions
`Then inside Claude Code:
`
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup
`$3
Check your ZuppaClaude installation health:
`bash
npx zuppaclaude doctor # 🔍 System health check
`Or from within Claude Code:
`
/zc:doctor
`🔍 What it Checks:
| Category | Checks |
|----------|--------|
| 💻 System | OS, Node.js version, disk space |
| 🤖 Claude Code | Version, updates, directory |
| 📦 ZuppaClaude | Version, updates, settings |
| 🧩 Components | SuperClaude, Spec Kit, Claude-Z, HUD, rclone |
| 🔧 Dependencies | Git, Python, Pip |
| 🌐 Environment | Environment variables |
$3
ZuppaClaude saves your choices and automatically uses them on reinstall.
📦 Via NPM:
`bash
npx zuppaclaude settings show # 👁️ View settings
npx zuppaclaude settings export ~/backup.json # 💾 Export
npx zuppaclaude settings import ~/backup.json # 📥 Import
npx zuppaclaude settings reset # 🔄 Reset to defaults
`🐚 Via Shell:
🍎🐧 macOS/Linux:
`bash
./zc-settings.sh show # 👁️ View settings
./zc-settings.sh export ~/backup.json # 💾 Export
./zc-settings.sh import ~/backup.json # 📥 Import
./zc-settings.sh reset # 🔄 Reset to defaults
`🪟 Windows:
`powershell
.\zc-settings.ps1 show
.\zc-settings.ps1 export ~\backup.json
.\zc-settings.ps1 import ~\backup.json
.\zc-settings.ps1 reset
`✨ Features:
| Feature | Description |
|---------|-------------|
| 💾 Auto-save | Preferences saved after installation |
| ⚡ Quick reinstall | One-command reinstall with previous settings |
| 🔐 API key protection | Base64 encoded storage |
| 🛡️ Uninstall protection | Option to preserve settings when uninstalling |
$3
Backup your Claude Code sessions and settings. Useful for context loss, formatting, or conversation compacting.
🔄 Full Backup (Sessions + Settings):
`bash
npx zuppaclaude backup # 💾 Local full backup
npx zuppaclaude backup --cloud gdrive # ☁️ Backup to Google Drive
npx zuppaclaude restore # ♻️ Restore from backup
npx zuppaclaude restore --cloud gdrive # ☁️ Restore from cloud
`📋 Session-only Operations:
`bash
npx zuppaclaude session list # 📋 List all sessions
npx zuppaclaude session backup # 💾 Backup sessions only
npx zuppaclaude session backups # 📦 List available backups
`$3
Backup to Google Drive, Dropbox, OneDrive, S3, SFTP, and 40+ cloud services.
`bash
Setup
brew install rclone # macOS
rclone config # Configure remote (gdrive, dropbox, etc.)Usage
npx zuppaclaude cloud setup # 📖 Setup instructions
npx zuppaclaude cloud remotes # 📋 List configured remotes
npx zuppaclaude backup --cloud gdrive # ☁️ Backup and upload
npx zuppaclaude cloud backups gdrive # 📦 List cloud backups
`✨ Features:
| Feature | Description |
|---------|-------------|
| 🔒 Safe restore | Existing sessions are not overwritten |
| 📜 Full backup | Sessions + Settings + History |
| ☁️ 40+ clouds | Google Drive, Dropbox, S3, SFTP via rclone |
| 🔐 Encryption | rclone encryption support |
$3
Autonomous AI agent loop that implements user stories from a PRD (Product Requirements Document) automatically.
🚀 Getting Started:
`bash
npx zuppaclaude ralph init # 📁 Create project files
npx zuppaclaude ralph run # 🔄 Start loop (default: 10 iterations)
npx zuppaclaude ralph run 20 # 🔄 Run with 20 iterations
npx zuppaclaude ralph status # 📊 Show PRD status
`📂 Files:
| File | Description |
|------|-------------|
|
prd.json | User stories with pass/fail status |
| ralph-prompt.md | Instructions for each iteration |
| progress.txt | Learnings (persistent memory) |
| AGENTS.md | Code patterns and conventions |🔄 How it Works:
1. Selects highest priority incomplete story from PRD
2. Makes minimal, focused changes
3. Runs quality checks (typecheck, lint, test)
4. Documents learnings in
progress.txt
5. Marks story as passes: true
6. Moves to next iteration> 💡 Inspired by snarktank/ralph
$3
📦 Via NPM:
`bash
npx zuppaclaude uninstall
`🐚 Via Shell:
🍎 macOS / 🐧 Linux:
`bash
curl -fsSL https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/uninstall.sh | bash
`🪟 Windows:
`powershell
irm https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/uninstall.ps1 | iex
`$3
| File | 🍎🐧 macOS/Linux | 🪟 Windows |
|------|------------------|------------|
| ⚡ SuperClaude |
~/.claude/commands/sc/ | %USERPROFILE%\.claude\commands\sc\ |
| 📝 Configuration | ~/.claude/CLAUDE.md | %USERPROFILE%\.claude\CLAUDE.md |
| 🌐 Claude-Z | ~/.local/bin/claude-z | %USERPROFILE%\.local\bin\claude-z.cmd |
| 📊 Claude HUD | ~/.local/bin/setup-claude-hud | %USERPROFILE%\.local\bin\setup-claude-hud.cmd |
| 🔧 Z.AI Config | ~/.config/zai/ | %USERPROFILE%\.config\zai\ |
| ⚙️ Settings | ~/.config/zuppaclaude/ | %USERPROFILE%\.config\zuppaclaude\ |$3
#### ❌ "specify" command not found
🍎🐧 macOS/Linux: Add to
~/.zshrc or ~/.bashrc:
`bash
export PATH="$HOME/.local/bin:$PATH"
`
🪟 Windows: Restart PowerShell or add %USERPROFILE%\.local\bin to PATH.#### ❌ SuperClaude commands not showing
🔄 Restart Claude Code completely (quit and reopen).
#### ❌ Execution Policy Error (Windows)
`powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
``---
| Project | Author |
|---------|--------|
| Claude Code | Anthropic |
| SuperClaude Framework | SuperClaude Org |
| Spec Kit | GitHub |
| z.ai | Z.AI |
| Claude HUD | Jarrod Watts |
| Ralph | Snarktank |
MIT