OpenCode si inserisce in una classe di strumenti che oggi è già matura: agenti di coding in grado di leggere il contesto del progetto, ragionare sulla codebase e intervenire in modo operativo sui file. In questo senso non cambia il paradigma, ma offre un’alternativa open source e model-agnostic a chi vuole più controllo sull’ambiente in cui lavora.
Per me il punto non è tanto "fare le cose che non potevo fare prima", quanto avere più libertà nel decidere come organizzare il workflow: quale modello usare, dove eseguire l’agente, quanto integrarlo nell’editor e quanto lasciarlo lavorare sul repository. È una differenza che conta soprattutto quando stai costruendo un setup sostenibile, ripetibile e adatto a progetti reali.
Cos'è e Perché Usarlo
OpenCode è un agente di coding AI open source disponibile come interfaccia da terminale (TUI), app desktop o estensione IDE. A differenza di Claude Code, ti dà piena libertà nella scelta del modello AI e nessun vendor lock-in.
OpenCode nasce dall'idea di rendere il coding agentivo accessibile a tutti, senza dipendere da un unico provider cloud. Puoi collegarlo a OpenAI, Anthropic, Gemini, oppure girare tutto in locale con Ollama -ideale per chi lavora su codice sensibile o vuole zero latenza cloud.
Installazione
Hai diverse opzioni, scegli quella più comoda per il tuo ambiente (https://opencode.ai/):
- npm / pnpm / yarn / bun: `npm install -g opencode`
- Homebrew (macOS/Linux): consigliato il tap ufficiale per avere release aggiornate
- Windows: disponibile via Chocolatey, Scoop o npm
- Docker: ottimo per ambienti isolati o CI
- Prerequisito: un terminale moderno come WezTerm, Ghostty, Alacritty o Kitty per avere la TUI al massimo.
Configurazione del Provider AI
Al primo avvio, esegui
nella TUI per collegare il tuo provider preferito. Se è la prima volta, il team consiglia OpenCode Zen con una lista curata di modelli testati, con prezzi competitivi rispetto ai provider diretti.
Modelli Gratuiti: Programmare a Costo Zero
Uno dei punti di forza di OpenCode è che include modelli gratuiti fin dal piano base, senza bisogno di inserire una carta di credito. Questo lo rende ideale per sperimentare o per quando hai esaurito i crediti del tuo provider principale.
I Modelli Disponibili Gratuitamente
Tramite OpenCode Zen hai accesso immediato a una selezione di modelli open weight ottimizzati per il coding (ottieni una API Key gratuita su opencode.ai/zen e collegala con `/connect` dalla TU):
- MiniMax M2.5 / M2.7: buon bilanciamento tra velocità e qualità
- GLM-5.1 (Big Pickle): forte nel coding di web app
- Qwen3.5 / Qwen3.6 / Qwen3.7: versatile, buon supporto al codice strutturato
e alcuni per i quali non occorre nemmeno la chiave, come
- Kimi K2.5 / K2.6: eccellente per reasoning e generazione di codice
- DeepSeek V4 Flash: ottimo per task veloci, latenza bassa
Il Piano Go: Open Source a Basso Costo
Se vuoi più richieste e nessuna preoccupazione per i limiti, OpenCode Go parte da $5 il primo mese, poi $10/mese. Include accesso generoso (5 ore di utilizzo) a tutti i modelli open source sopra elencati, ed è utilizzabile anche con altri agenti come Claude Code.
Consiglio per i junior developer: inizia con i modelli gratuiti di Zen per imparare il workflow agentivo senza spendere nulla. Una volta capito il meccanismo di Plan/Build mode, valuta se passare a un modello premium per progetti più complessi.
Inizializzazione del Progetto
Spostati nella root del tuo progetto ed esegui:
OpenCode analizzerà la codebase e creerà un file `AGENTS.md`. Questo file è fondamentale: aiuta l'agente a capire la struttura del progetto, le convenzioni di codice e il contesto tecnico. Trattalo come un briefing che daresti a un nuovo sviluppatore del team.
Il Workflow Consigliato
Il flusso di lavoro più efficace si articola in tre fasi:
- Plan mode (premi Tab) - disabilita le modifiche e chiedi all'agente di pianificare come implementerà la feature. Itera il piano dandogli feedback, anche tramite immagini drag & drop nel terminale.
- Build mode (premi di nuovo Tab) - dai il via all'implementazione vera e propria.
- Undo / Redo - se il risultato non ti convince, usa /undo per annullare e rifinire il prompt, poi /redo per riprovare.
Consiglio pratico: parla all'agente come se stesse descrivendo un task a un developer junior del tuo team. Più dettagli dai, migliore sarà l'output.
Funzionalità Avanzate
- Condivisione conversazioni: puoi generare un link alla sessione corrente e condividerlo con il tuo team
- Comandi personalizzati: crea shortcut per operazioni ripetute nel tuo workflow
- Agenti specializzati (funzionalità "Oh My OpenCode"): puoi usare agenti separati per pianificazione, ricerca nella codebase e implementazione
- Modalità offline con Ollama: perfetto per progetti privati o ambienti senza accesso a internet
Integrazione con VS Code
Se usi VS Code (o i suoi fork come Cursor, Windsurf, VSCodium), OpenCode si integra direttamente nell'editor senza dover aprire un terminale separato.
Installazione dell'Estensione
Hai due strade:
- Automatica: apri il terminale integrato di VS Code, esegui opencode e l'estensione si installa da sola
- Manuale: cerca "OpenCode" nel Marketplace di VS Code e clicca su Install
Se il comando automatico fallisce, verifica che la CLI opencode sia disponibile nel PATH. Su Mac/Linux puoi farlo con Cmd+Shift+P.
Funzionalità Principali
L'estensione ufficiale (`sst-dev.opencode`) ti dà accesso a queste funzionalità direttamente nell'editor:
- Quick Launch: Ctrl+Esc (Windows/Linux) o Cmd+Esc (Mac) - apre OpenCode in un pannello terminale split
- Nuova sessione: Ctrl+Shift+Esc - avvia una sessione fresh senza chiudere quella corrente
- Context awareness: condivide automaticamente la selezione o il tab attivo con l'agente
- File Reference: Alt+Ctrl+K inserisce riferimenti precisi ai file (es. @File#L37-42)
La Versione Beta con Chat Sidebar
Esiste anche una versione beta (`sst-dev.opencode-v2`) con un'interfaccia di chat nella sidebar - simile a GitHub Copilot Chat - con gestione delle sessioni multiple, selezione del modello direttamente dall'UI e supporto alle immagini trascinate nella chat.
Workflow Mouse-Free Consigliato
Per un'esperienza completamente da tastiera, puoi personalizzare `keybindings.json`:
Questo ti permette di aprire OpenCode con Ctrl+K Ctrl+O e alternare il pannello terminale con Ctrl+J, senza mai toccare il mouse.
Vantaggio chiave: con VS Code + OpenCode sulla stessa directory, le sessioni sono organizzate per progetto in automatico - nessuna confusione su "quale istanza stava lavorando su quale repo".
Conclusioni
OpenCode rappresenta un cambio di paradigma nel modo in cui gli sviluppatori interagiscono con l'AI nel loro workflow quotidiano. Non è solo un autocomplete intelligente - è un vero agente autonomo che pianifica, implementa e corregge, lasciando a te il controllo delle decisioni architetturali.
I motivi per cui vale la pena adottarlo oggi sono chiari:
- Zero costi per iniziare: i modelli gratuiti di Zen sono più che sufficienti per capire il potenziale dello strumento
- Nessun vendor lock-in: puoi cambiare modello in qualsiasi momento, anche in locale con Ollama
- Si integra dove già lavori: terminale, VS Code, o app desktop, senza stravolgere il tuo setup
- Open source e trasparente: puoi leggere il codice, contribuire e fidarti di come gestisce i tuoi file
Se sei uno sviluppatore che insegna o guida un team junior, OpenCode ha un vantaggio ulteriore: il meccanismo Plan → Build → Undo/Redo è didatticamente prezioso. Abitua a pensare prima di scrivere codice, a scomporre i problemi e a ragionare sulle conseguenze di ogni modifica - esattamente le competenze che vogliamo trasferire a chi sta imparando.
Il mio consiglio è di iniziare con un progetto piccolo ma reale, non un tutorial: una feature che hai rimandato da settimane, un refactoring che sai di dover fare. OpenCode dà il meglio su problemi concreti, non su esercizi artificiali.
Commenti
Posta un commento