Vai al contenuto
Configurazione

Windows (WSL)

Anche se OpenCode puo essere eseguito direttamente su Windows, consigliamo di usare Windows Subsystem for Linux (WSL) per la migliore esperienza. WSL fornisce un ambiente Linux che funziona in modo ottimale con le funzionalita di OpenCode.

  1. Installa WSL

    Se non l’hai ancora fatto, installa WSL seguendo la guida ufficiale Microsoft.

  2. Installa OpenCode in WSL

    Dopo aver configurato WSL, apri il terminale WSL e installa OpenCode usando uno dei metodi di installazione.

    Terminale
    curl -fsSL https://opencode.ai/install | bash

  3. Usa OpenCode da WSL

    Vai nella directory del progetto (accedi ai file Windows tramite /mnt/c/, /mnt/d/, ecc.) ed esegui OpenCode.

    Terminale
    cd /mnt/c/Users/YourName/project
opencode

Se preferisci usare l’app desktop di OpenCode ma vuoi eseguire il server in WSL:

  1. Avvia il server in WSL con --hostname 0.0.0.0 per consentire connessioni esterne:

    Terminale
    opencode serve --hostname 0.0.0.0 --port 4096

  2. Collega l’app desktop a http://localhost:4096

Per la migliore esperienza web su Windows:

  1. Esegui opencode web nel terminale WSL invece che in PowerShell:

    Terminale
    opencode web --hostname 0.0.0.0

  2. Accedi dal browser Windows su http://localhost:<port> (OpenCode stampa l’URL)

Eseguire opencode web da WSL garantisce accesso corretto al file system e integrazione del terminale, restando comunque accessibile dal browser Windows.

WSL puo accedere a tutti i file Windows tramite la directory /mnt/:

  • Unita C: → /mnt/c/
  • Unita D: → /mnt/d/
  • E cosi via…

Esempio:

Terminale
cd /mnt/c/Users/YourName/Documents/project
opencode

  • Tieni OpenCode in esecuzione su WSL per i progetti salvati su unita Windows: l’accesso ai file e immediato
  • Usa l’estensione WSL di VS Code insieme a OpenCode per un flusso di lavoro integrato
  • Configurazione e sessioni di OpenCode sono salvate nell’ambiente WSL in ~/.local/share/opencode/