Installare e utilizzare OpenCode

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

AI-Corporate consiglia OpenCode per sviluppatori, amministratori e altri utenti avanzati. OpenCode può modificare file in autonomia e sviluppare compiti. Controlla quindi sempre le modifiche proposte.

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

Installazione

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

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

Puoi installare OpenCode anche con Node.js:

npm install -g opencode-ai

Oppure con Homebrew su macOS e Linux:

brew install anomalyco/tap/opencode

Collegamento a Codering

OpenCode supporta provider personalizzati compatibili con OpenAI. Crea una cartella di progetto con un file opencode.json.

Usa in quel file l’endpoint Coderen e i modelli autorizzati:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-corporate-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Corporate Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_CORPORATE_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-corporate-coderen/gpt-5.4-mini",
  "small_model": "ai-corporate-coderen/gpt-5.4-mini"
}

Imposta poi la chiave API come variabile d’ambiente.

macOS e Linux

export AI_CORPORATE_CODEREN_API_KEY="aic.tua-chiave-api"

Windows

setx AI_CORPORATE_CODEREN_API_KEY "aic.tua-chiave-api"

Apri poi una nuova terminale.

Avvio di OpenCode

Vai nella cartella del progetto:

cd percorso/del/tuo/progetto

Avvia OpenCode:

opencode

Usa in OpenCode la scelta del modello per selezionare il modello AI-Corporate Coderen se non è già selezionato automaticamente.

Lavorare in sicurezza con OpenCode

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

Procedura consigliata:

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

Variabili d'ambiente e OpenCode

Per OpenCode puoi memorizzare la chiave API Coderen in un file .env locale nella cartella di progetto:

AI_SCHOOL_CODEREN_API_KEY=ais.tua-api-sleutel

Assicurati che OpenCode carichi davvero questa variabile d’ambiente. In PowerShell puoi impostare la variabile anche temporaneamente per la sessione corrente:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.tua-api-sleutel"

Se vedi Authorization header with Bearer token is required, la tool potrebbe non inviare la chiave come Authorization: Bearer .... Se vedi Unknown parameter, rimuovi le impostazioni specifiche del provider che l’endpoint Coderen di AI-Corporate non supporta.