Vai al contenuto principale

Installare e utilizzare OpenCode

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

AI-Corporate consiglia OpenCode per sviluppatori, amministratori e altri utenti avanzati. OpenCode può modificare file autonomamente e elaborare compiti. Controlla quindi sempre le modifiche suggerite.

Per ulteriori informazioni consulta il sito di OpenCode all’indirizzo OpenCode-website e la 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 Coderen​

OpenCode supporta provider personalizzabili compatibili OpenAI. Crea nella cartella di progetto un file opencode.json.

Usa in esso l’endpoint Coderen e i modelli consentiti:

{
  "$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.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-corporate-coderen/gpt-5.6-luna",
  "small_model": "ai-corporate-coderen/gpt-5.6-luna"
}

Poi imposta 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/alla/tua/progetto

Avvia OpenCode:

opencode

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

Lavorare in sicurezza con OpenCode​

Poiché OpenCode è agentic, è importante verificare le modifiche.

Procedura consigliata:

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

Variabili d'ambiente e OpenCode​

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

AI_SCHOOL_CODEREN_API_KEY=ais.tua-chiave-api

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

$env:AI_SCHOOL_CODEREN_API_KEY="ais.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-Corporate non supporta.

WhatsApp