Vai al contenuto principale

Installare e utilizzare OpenCode

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

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

Ulteriori informazioni sono disponibili sul sito web di OpenCode e nella documentazione ufficiale di OpenCode.

Quando scegliere OpenCode?​

Scegli OpenCode se l’utente:

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

Per l’apprendimento classico della programmazione con i principianti, Aider è solitamente 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

Collegarsi a 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.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.6-luna",
  "small_model": "ai-school-coderen/gpt-5.6-luna"
}

Poi imposta la chiave API come variabile d'ambiente.

È anche possibile utilizzare un file .env nella cartella del progetto:

AI_SCHOOL_CODEREN_API_KEY=ais.tua-chiave-api

Controlla dopo aver aperto una nuova terminale se OpenCode può 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/del/tuo/progetto

Avvia OpenCode:

opencode

Utilizza in OpenCode la scelta del modello per selezionare il modello Coderen di AI-School se non avviene automaticamente.

Risoluzione dei problemi​

L’header Authorization con token Bearer è obbligatorio​

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

  • che AI_SCHOOL_CODEREN_API_KEY si chiami esattamente così
  • che il valore inizi con ais.
  • che dopo setx tu abbia aperto una nuova terminale
  • che il file .env sia nella cartella del progetto da cui avvii OpenCode

Unknown parameter​

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

Lavorare in modo sicuro con OpenCode​

Poiché OpenCode è agentico, è importante controllare le modifiche.

Procedura consigliata:

  1. Lavora in un repository git.
  2. Inizia con compiti piccoli.
  3. Controlla le diff prima di usare il codice.
  4. Testa l’applicazione dopo le modifiche.
  5. Conferma solo le modifiche che comprendi.

Per gli studenti con poca esperienza è consigliabile utilizzare OpenCode prima in modo dimostrativo sotto la guida di un insegnante.

WhatsApp