OpenCode

Ultimo aggiornamento: 27 agosto 2026

OpenCode è un agente di codifica aperto con interfacce terminale, desktop e IDE. Logicc può essere impostato come proprio provider. Per i modelli GPT, consigliamo l'endpoint Responses. I percorsi Claude e Gemini tramite Chat Completions sono considerati condizionatamente compatibili.

Beta: OpenCode, la compatibilità dei provider di modelli e del gateway evolvono in modo indipendente. Testa le chiamate agli strumenti, lo streaming e il ragionamento con il percorso del modello specifico prima di utilizzare l'integrazione in modo produttivo.

Avvio rapido

1. Installa OpenCode.
2. Impostare LOGICC_API_KEY come variabile di ambiente.
3. Crea la configurazione comune con entrambi i provider Logicc.
4. Inizia OpenCode e seleziona un modello sotto /models.
5. Eseguire una richiesta di prova e quindi controllare la quota.

Requisiti

• Chiave API attiva Logicc
• Almeno un modello abilitato
• Versione attuale OpenCode
• Terminale su macOS, Linux, Windows o WSL

1. Installa OpenCode

macOS, Linux o WSL:

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

In alternativa con npm:

npm install -g opencode-ai

opencode --version

2. Imposta la chiave API

macOS, Linux o WSL:

export LOGICC_API_KEY="LA_TUA_CHIAVE_API_LOGICC"

Windows PowerShell:

$env:LOGICC_API_KEY = "LA_TUA_CHIAVE_API_LOGICC"

La chiave viene referenziata nella configurazione esclusivamente tramite la variabile d'ambiente. Non salvarlo direttamente su opencode.json o Git.

3. Controlla i modelli abilitati

curl "https://api.logicc.cloud/v1/models" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

4. Configura i provider Logicc

Crea un file opencode.json nella cartella del progetto. L'esempio seguente contiene entrambi i percorsi di accesso supportati in una configurazione comune. Non è necessario sovrascriverlo con un secondo esempio.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "logicc-responses/gpt-5.6-terra",
  "provider": {
    "logicc-responses": {
      "npm": "@ai-sdk/openai",
      "name": "Logicc API, Responses",
      "options": {
        "baseURL": "https://api.logicc.cloud/v1",
        "apiKey": "{env:LOGICC_API_KEY}"
      },
      "models": {
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra tramite Logicc"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna tramite Logicc"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol tramite Logicc"
        }
      }
    },
    "logicc-compatible": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Logicc API, Chat Completions",
      "options": {
        "baseURL": "https://api.logicc.cloud/v1",
        "apiKey": "{env:LOGICC_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5 tramite Logicc"
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro tramite Logicc"
        }
      }
    }
  }
}

@ai-sdk/openai utilizza /v1/responses ed è consigliato per i modelli GPT con chiamate allo strumento e ragionamento. @ai-sdk/openai-compatible utilizza /v1/chat/completions e viene utilizzato per altri percorsi di modelli compatibili.

Rimuovi i modelli che non sono abilitati per la tua chiave API. Altri ID attivati possono essere aggiunti utilizzando la stessa struttura in models.

5. Controlla la configurazione e avvia

macOS, Linux o WSL:

jq empty opencode.json
opencode

Su Windows, il file JSON può essere controllato utilizzando PowerShell, ad esempio:

Get-Content .\opencode.json -Raw | ConvertFrom-Json | Out-Null
opencode

Apri la selezione del modello:

/models

Una panoramica dei dati di accesso salvati mostra:

opencode auth list

Questo comando non è un controllo completo della connessione. Una connessione viene confermata solo dopo una richiesta di modello riuscita.

Compatibilità dei modelli

Responses, consigliato

Chat Completions, condizionatamente compatibili

Per Claude, un client Anthropic nativo come il Claude Code è solitamente più compatibile. Con GPT-5.6, i Function Tools possono essere rifiutati insieme al reasoning_effort tramite Chat Completions. Utilizza quindi il provider Responses o impostare lo sforzo di ragionamento su none.

Non adatto come modello di chat di codifica

• gpt-4o-transcribe e gpt-4o-mini-transcribe
• text-embedding-3-small, text-embedding-3-large e gemini-embedding-001
• gemini-3.1-flash-image e gemini-2.5-flash-image

Desktop e IDE

Lo stesso opencode.json può essere utilizzato dalle superfici OpenCode supportate. Una variabile di ambiente impostata nel terminale non è automaticamente disponibile per un desktop o un processo IDE avviato separatamente. Assicurarsi che LOGICC_API_KEY venga passato al processo tramite la gestione dei segreti dell'ambiente specifico.

Consigliamo l'interfaccia terminale per la configurazione iniziale e l'analisi degli errori.

Costi e quote

OpenCode può eseguire automaticamente molte query del modello e passaggi dello strumento. I consumi ed i costi dipendono fortemente dal modello, dalla lunghezza del contesto e dal numero di fasi di lavoro.

curl "https://api.logicc.cloud/api/governance/virtual-keys/quota" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

Budget, consumi e budget residuo sono mantenuti in euro.

Protezione dei dati

OpenCode funziona localmente con file condivisi e strumenti terminale. L'elaborazione del modello non avviene localmente. Le richieste e i file o i frammenti di codice pertinenti vengono trasferiti al provider di modelli configurato tramite l'API Logicc. Plugin, server MCP e funzioni web possono creare flussi di dati aggiuntivi.

Risoluzione dei problemi

Supporto

Se hai domande, scrivi a [email protected] con oggetto API. Condividi OpenCode versione, sistema operativo, provider, ID modello, stato HTTP, ora e testo dell'errore senza includere la chiave API.

Ulteriore documentazione:

• Centro assistenza Logicc: https://help.logicc.com/docs
• Installazione di OpenCode: https://opencode.ai/docs
• Provider OpenCode: https://opencode.ai/docs/providers