Installare e usare OpenCode

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

AI-Public consiglia OpenCode per sviluppatori, amministratori e altri utenti avanzati. OpenCode può modificare file autonomamente e sviluppare compiti. Verifica quindi sempre le modifiche proposte.

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

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 di progetto un file opencode.json.

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

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

Poi imposta la chiave API come variabile d'ambiente.

macOS e Linux

export AI_PUBLIC_CODEREN_API_KEY="aip.tua-chiave-api"

Windows

setx AI_PUBLIC_CODEREN_API_KEY "aip.tua-chiave-api"

Apri poi una nuova terminale.

Avviare OpenCode

Vai nella cartella del progetto:

cd percorso/della/tuaprogetto

Avvia OpenCode:

opencode

Usa in OpenCode la scelta del modello per selezionare il modello AI-Public Coderen se non avviene automaticamente.

Lavorare in sicurezza con OpenCode

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

Procedura consigliata:

1. Lavora in un repository git.
2. Inizia con compiti piccoli.
3. Controlla i diff prima di utilizzare il codice.
4. Testa l'applicazione dopo le modifiche.
5. Effettua commit solo delle modifiche che comprendi.

Variabili d'ambiente e OpenCode

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

AI_PUBLIC_CODEREN_API_KEY=aip.tua-chiave-api

Assicurati che OpenCode carichi davvero questa variabile d'ambiente. In PowerShell puoi impostare temporaneamente la variabile per l'attuale terminale:

$env:AI_PUBLIC_CODEREN_API_KEY="aip.tua-chiave-api"

Se vedi Authorization header with Bearer token is required, allora lo strumento non invia la chiave come Authorization: Bearer .... Se vedi Unknown parameter, rimuovi le impostazioni specifiche del provider che l'endpoint Coderen di AI-Public non supporta.