Vai al contenuto principale

Installare e utilizzare OpenCode

OpenCode è uno strumento di coding agente. Lo strumento è disponibile come applicazione terminale, applicazione desktop e estensione IDE.

AI-School consiglia OpenCode soprattutto per docenti, amministratori e studenti con molta esperienza di programmazione. OpenCode può operare in modo più autonomo rispetto ad Aider e può quindi eseguire rapidamente molte modifiche.

Per ulteriori informazioni, consulta il sito OpenCode e la documentazione ufficiale di OpenCode.

Quando scegliere OpenCode?​

Scegli OpenCode se l’utente:

  • ha esperienza con terminale, editor di codice e git
  • comprende come vengono modificati i file locali
  • può controllare le modifiche prima di usarle
  • vuole sviluppare compiti di programmazione più complessi

Per l’apprendimento in classe della programmazione con principianti, Aider è di solito più adatto.

Installazione​

L’installazione più semplice secondo la documentazione di OpenCode è:

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

È anche possibile installare OpenCode con Node.js:

npm install -g opencode-ai

Oppure con Homebrew su macOS e Linux:

brew install anomalyco/tap/opencode

Collegamento con Coderen​

OpenCode supporta provider personalizzati compatibili con OpenAI. Crea nella cartella del progetto un file opencode.json.

Usa al suo interno l’endpoint Coderen e i modelli consentiti:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_SCHOOL_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.4-mini",
  "small_model": "ai-school-coderen/gpt-5.4-mini"
}

Poi imposta la chiave API come variabile d’ambiente.

Puoi anche utilizzare un file .env nella cartella del progetto:

AI_SCHOOL_CODEREN_API_KEY=ais.tua-chiave-api

Verifica dopo aver aperto una nuova terminale che OpenCode riesca a leggere questa variabile. Se OpenCode non invia una chiave, AI-School riporta l’errore che è obbligato un header Authorization con token Bearer.

macOS e Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.tua-chiave-api"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.tua-chiave-api"

Poi apri una nuova terminale.

Avviare OpenCode​

Vai nella cartella del progetto:

cd percorso/della/tua/progetto

Avvia OpenCode:

opencode

Usa in OpenCode la selezione del modello per scegliere il modello AI-School Coderen se non avviene automaticamente.

Risoluzione dei problemi​

È obbligatorio l’Authorization header con Bearer token​

Questo avviso significa di solito che OpenCode non sta inviando una chiave API. Controlla:

  • che AI_SCHOOL_CODEREN_API_KEY abbia esattamente quel nome
  • se il valore inizia con ais.
  • se dopo setx hai aperto una nuova terminale
  • se il file .env si trova nella cartella del progetto da cui avvii OpenCode

Unknown parameter​

Alcuni strumenti inviano parametri specifici del provider aggiuntivi. Se visualizzi un messaggio come Unknown parameter, rimuovi quella impostazione dalla configurazione di OpenCode o usa una configurazione provider più semplice. L’endpoint Coderen si aspetta richieste chat compatibili OpenAI con modello, messaggi e le impostazioni di base usuali.

Lavorare in sicurezza con OpenCode​

Poiché OpenCode opera in modo agentico, è importante controllare le modifiche.

Pratiche consigliate:

  1. Lavorare in un repository git.
  2. Iniziare con compiti piccoli.
  3. Controllare le differenze prima di utilizzare il codice.
  4. Testare l’applicazione dopo le modifiche.
  5. Commitare solo le modifiche che si capiscono.

Per studenti con poca esperienza è sensato utilizzare OpenCode prima in modo dimostrativo sotto la guida di un docente.