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-Public consiglia OpenCode per sviluppatori, amministratori e altri utenti avanzati. OpenCode può modificare file in modo autonomo e sviluppare compiti. Controlla quindi sempre le modifiche proposte.

Maggiori informazioni si trovano sul sito OpenCode e nella documentazione ufficiale di OpenCode.

Installazione​

La procedura di 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

Collegarsi a Coderen​

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

In esso usa 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.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-public-coderen/gpt-5.6-luna",
  "small_model": "ai-public-coderen/gpt-5.6-luna"
}

Poi imposta la chiave API come variabile d'ambiente.

macOS e Linux​

export AI_PUBLIC_CODEREN_API_KEY="aip.il-tuo-api-key"

Windows​

setx AI_PUBLIC_CODEREN_API_KEY "aip.il-tuo-api-key"

Apri poi una nuova terminale.

Avvio di OpenCode​

Vai nella cartella del progetto:

cd percorso/della/tua/progetto

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 una 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 le modifiche che comprendi.

Variabili d'ambiente e OpenCode​

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

AI_PUBLIC_CODEREN_API_KEY=aip.il-tuo-api-key

Assicurati che OpenCode carichi effettivamente questa variabile d'ambiente. In PowerShell puoi impostare temporaneamente la variabile per la sessione corrente:

$env:AI_PUBLIC_CODEREN_API_KEY="aip.il-tuo-api-key"

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.

WhatsApp