Se bazzichi nell’ambiente dello sviluppo software, avrai sicuramente notato come gli assistenti AI da terminale stiano diventando compagni di lavoro fondamentali. Tra le varie soluzioni OpenCode è senza dubbio uno degli strumenti più interessanti e “facili” anche per iniziare.
In questo articolo vedremo cos’è OpenCode, quali sono i suoi principali punti di forza, come installarlo su e quali sono i migliori consigli pratici per iniziare subito a usarlo al massimo delle sue potenzialità.
Cos’è OpenCode e quali sono i suoi vantaggi principali?
OpenCode è un agente di programmazione AI open source progettato principalmente per il terminale, ma disponibile anche come applicazione desktop o estensione per IDE come VS Code, Cursor, Windsurf e VSCodium.
A differenza di altre soluzioni proprietarie o fortemente legate al cloud, OpenCode adotta un approccio local-first focalizzato sulla privacy: non memorizza il tuo codice né i tuoi dati di contesto, e tutta l’elaborazione avviene in locale o mediante chiamate API dirette verso i provider AI che scegli di utilizzare. Inoltre, sei proprietario al 100% di tutto il codice prodotto .
Ecco i vantaggi chiave che lo rendono così apprezzato:
- Indipendenza dal provider: Puoi collegare oltre 75 provider LLM diversi tramite Models.dev, compresi i modelli di OpenAI (GPT), Claude, Google (Gemini), il piano di abbonamento curato OpenCode Go a $10/mese o OpenCode Zen, fino a soluzioni locali via Ollama o llama.cpp.
- Supporto per strumenti e contesti avanzati: Integra nativamente server LSP (Language Server Protocol) per caricare i contesti di tipo corretto, server MCP, regole di permesso dettagliate ed esecuzione multi-agente in parallelo sullo stesso progetto.
- Integrazione flessibile nell’ambiente di lavoro: Puoi usarlo direttamente nel terminale via TUI (Terminal User Interface), via riga di comando per esecuzioni non interattive o script (
opencode run), tramite server HTTP headless e SDK ufficiale JS/TS, oppure integrato nel tuo editor di codice preferito.
Come installare OpenCode
L’installazione di OpenCode su sistemi Ubuntu, Debian e derivate (come Linux Mint, Pop!_OS o Elementary OS) è semplice e offre diverse opzioni in base alle tue preferenze di sistema.
1. Installazione rapida da terminale (Consigliata)
Il metodo più rapido e diretto per Ubuntu/Debian è utilizzare lo script di installazione ufficiale tramite curl:
curl -fsSL https://opencode.ai/install | bashBashQuesto script scarica automaticamente il binario compilato corretto per la tua architettura e lo posiziona nel PATH di sistema.
2. Tramite Node.js / Bun / pnpm / yarn
Se hai già installato Node.js o Bun sulla tua macchina puoi installare la CLI di OpenCode a livello globale:
Con npm:
npm install -g opencode-aiBashCon Bum:
bun install -g opencode-aiBashCon pnpm o Yarn:
pnpm install -g opencode-ai
# oppure
yarn global add opencode-aiBash3. Tramite Homebrew su macOS
Se utilizzi Homebrew su macOS, puoi fare riferimento al tap ufficiale di OpenCode per ottenere sempre le release più recenti:
brew install anomalyco/tap/opencodeBash4. Tramite Docker (per test isolati)
Se desideri provare OpenCode in un ambiente containerizzato senza intaccare il sistema operativo locale:
docker run -it --rm ghcr.io/anomalyco/opencodeBashInstallazione su altri sistemi e IDE
- Windows: La scelta raccomandata è l’uso di WSL (Windows Subsystem for Linux) con Ubuntu/Debian, che garantisce prestazioni ideali e piena compatibilità con OpenCode. In alternativa puoi usare Scoop (
scoop install opencode) o Chocolatey (choco install opencode). - Integrazione IDE (VS Code, Cursor, Windsurf, VSCodium): Ti basta aprire il terminale integrato dell’editor ed eseguire il comando
opencode: l’estensione si installerà automaticamente. In alternativa, puoi cercarla nel Marketplace dell’IDE e fare clic su “Install”.
Come Avviare Opencode da Terminale
Una volta avviato il terminale, come si comprende dall’installazione è fortemente indicato l’uso della shell in Bash o ZSH, basterà digitare “opencode” ed apparirà al posto del classico prompt la schermata di avvio:

Per accedere al menu delle varie opzioni, premendo il tasto “/” vedrete comparire a video il lunghissimo elenco delle varie voci. Tra le voci di importanza sicuramente /model è tra i più importanti, poiché potrete scegliere il modello di LLM. Mentre con la combo Ctrl+P avrete accesso alle scorciatoie da tastiera per accedere velocemente ad altre funzionalità.
I migliori consigli per iniziare ad usare OpenCode come un pro
Una volta completata l’installazione, muovere i primi passi è semplicissimo. Ecco i suggerimenti più utili per sfruttarlo al meglio fin dal primo giorno:
1. Inizializza ogni progetto con /init
La prima cosa da fare quando apri OpenCode all’interno della cartella di un repository è lanciare il comando /init OpenCode analizzerà la struttura del tuo progetto e genererà un file AGENTS.md (o agent.md) nella radice del repository. Questo file servirà all’agente per comprendere lo scopo del codice ed evitare di dovergli rispiegare il contesto ogni volta.
2. Padroneggia l’alternanza tra modalità Plan e Build (Tab)
Premendo il tasto Tab nell’interfaccia puoi passare da una modalità all’altra:
- Modalità Plan (Pianificazione): È in sola lettura, quindi l’agente non può modificare i tuoi file. Analizza la codebase e definisce una strategia di implementazione . Un ottimo trucco è utilizzare un modello computazionalmente più potente durante questa fase per pianificare l’architettura nei minimi dettagli.
- Modalità Build (Sviluppo): È la modalità predefinita, ha permessi di lettura/scrittura ed esegue concretamente le modifiche ai file e i comandi necessari per mettere in atto il piano.
3. Fai riferimento ai file con @ e sfrutta l’agente Explore
Non serve copiare e incollare i percorsi dei file nella chat: ti basta digitare la chiocciola @ per selezionare e allegare direttamente i file al tuo prompt. Inoltre, digitando @Explore (oppure eseguendo opencode run --agent explore), invocherai un subagente specializzato in sola lettura capace di esplorare gli script del progetto e spiegarti la loro funzione senza rischiare di alterare i file.
4. La rete di salvataggio: /undo e /redo
Se l’agente apporta una modifica al codice che non ti soddisfa o commette un errore in modalità Build, niente panico! Digitando /undo ripristini la sessione al messaggio precedente e annulli le modifiche apportate ai file. Questo è possibile perché OpenCode gestisce la cartella di lavoro come un repository Git. Se cambi idea, puoi usare /redo per ripetere l’azione annullata.
5. Definisci istruzioni globali o locali
Oltre al file di istruzioni del singolo progetto creato con /init, puoi definire un file agent.md a livello globale. Qui puoi impostare regole di comportamento che valgano sempre, a prescindere da dove apri OpenCode: ad esempio le tue convenzioni di stile, specifiche regole su Git o l’istruzione tassativa di chiedere sempre l’autorizzazione o non cancellare mai file
6. Configura i permessi in opencode.json
Per evitare che l’agente esegua modifiche o comandi delicati a tua insaputa, puoi creare un file opencode.json (a livello di progetto o globale). In questo file puoi impostare in modo esplicito per quali strumenti richiedere conferma (ad esempio impostando "edit": "ask" o "bash": "ask")
7. Crea comandi ed agenti personalizzati
Se ti ritrovi a ripetere spesso determinate istruzioni, puoi chiedere a OpenCode di guidarti nella creazione di Comandi Personalizzati dedicati. Inoltre, puoi creare subagenti personalizzati inserendo file markdown all’interno della cartella .opencode/agents/ del progetto. In questo modo puoi configurare agenti specializzati (ad esempio per la ricerca dei bug o la code review) assegnando loro permessi distinti e modelli specifici per ottimizzare l’uso dei token.
Conclusione
OpenCode rappresenta un’ottima combinazione tra potenza agentica, flessibilità nella scelta dei modelli AI e rispetto per la privacy del codice. Non è chiaramente l’unico sul mercato, gli stessi Claude e Chat-GPT hanno i loro code-agent sul terminale, tuttavia questo è agnostico rispetto al fatto di doversi affrancare a un’azienda. Non secondario poi il costo, oltre ad una selezione di modelli gratuiti che spesso vengono rilasciati per tempi brevi al fine di testing e che possono essere usati per task secondari, il costo del servizio è decisamente competitivo se si utilizzano modelli Open Weight come i cinesi Qwen, Deepsek et similari.
Link
Pagina ufficiale: https://opencode.ai
Pagina GitHub: https://github.com/anomalyco/opencode



