🚀 OpenClaude Portable — Guida Rapida all'Installazione
Cos'è?
OpenClaude Portable ti permette di usare un agente AI di coding completo (basato su Claude Code) direttamente da una chiavetta USB o da una cartella qualsiasi — senza installare nulla sul PC.
✅ Requisiti di Sistema
PiattaformaRequisitoWindowsWindows 10 o superiore (Node.js è incluso)Linuxcurl (già presente di default)macOScurl (già presente di default)
Spazio su disco: ~150 MB per il motore + Node.js. Se usi modelli Ollama offline, servono da 800 MB a 8 GB in più.
📥 Installazione
1. Scarica il progetto
Vai su 👉 https://github.com/techjarves/OpenClaude-Portable e clicca su Code → Download ZIP, oppure clona con:
2. Avvia il programma
Windows: doppio clic su START.bat
Linux/macOS: apri il terminale nella cartella e digita:
chmod +x start.sh
./start.sh
3. Prima esecuzione
Al primo avvio viene scaricato automaticamente Node.js (~25 MB) e il motore OpenClaude (~5 MB). Poi ti verrà chiesto di scegliere il provider AI e inserire la tua API key.
I lanci successivi partono direttamente, senza ripetere il setup.
🤖 Provider AI Supportati
ProviderCostoDove prendere la keyNVIDIA NIMGratuito (1.000 crediti/mese)build.nvidia.comOpenRouterGratuito + modelli a pagamentoopenrouter.aiGoogle GeminiPiano gratuito disponibileaistudio.google.comAnthropic ClaudeA pagamentoconsole.anthropic.comOpenAIA pagamentoplatform.openai.comOllamaGratuito, offlineollama.com
🛠️ Errori Comuni e Soluzioni
❌ Node.js not found
→ Lancia START.bat — lo scarica in automatico.
❌ EADDRINUSE: port 11435
→ C'è ancora aperta una sessione precedente. Riavvia START.bat, il proxy viene chiuso automaticamente.
❌ 'D_ARGS' is not recognized
→ Hai una versione vecchia. Scarica l'ultima versione dal repository.
❌ Risposta di Ollama lentissima
→ Usa un modello più leggero come gemma3:1b, oppure copia i modelli su un SSD locale invece che sulla USB.
❌ API key rifiutata
→ Verifica la chiave sul sito del provider e reinseriscila scegliendo l'opzione 4 – Change Provider dal menu.
❌ Porta 3000 già in uso
→ La dashboard è già attiva! Apri direttamente il browser su http://localhost:3000
❌ openclaude non trovato in PowerShell
→ Usa .\RESUME.bat <session-id> invece di chiamare openclaude direttamente.
💡 Consiglio Finale
Se usi Ollama su chiavetta USB 2.0 e i tempi di risposta sono lenti, copia la cartella data/ollama/ sul tuo SSD locale: la differenza è notevole. Il proxy interno riduce già i tempi da 60-120 secondi a 5-20 secondi su hardware solo-CPU.
1
0 comments
Techtonic Techtonic
4
🚀 OpenClaude Portable — Guida Rapida all'Installazione
powered by
TechTonic AI Lab
skool.com/enzo-di-roma-3126
Community del canale TechTonic per creare siti, UI e progetti digitali con l’AI. Workflow reali, prompt, tool e test su Antigravity.
Build your own community
Bring people together around your passion and get paid.
Powered by