Come aggiungo un provider personalizzato a OpenCode?

Esegui /connect, scegli Other e salva la tua chiave con un id di provider, poi aggiungi a opencode.json un provider con quell’id, con npm impostato su @ai-sdk/openai-compatible e options.baseURL impostato su https://aigrow.gg/v1.

Dove tiene la chiave OpenCode?

In ~/.local/share/opencode/auth.json dopo /connect. opencode auth list mostra quali provider ne hanno una.

Quale pacchetto npm usa il provider?

@ai-sdk/openai-compatible, che chiama /v1/chat/completions. @ai-sdk/openai chiama /v1/responses, che l’endpoint non serve.

OpenCode con un provider personalizzato

Aggiungi questo provider a opencode.json e inserisci la tua chiave con /connect: OpenCode funzionerà con i modelli Claude, GPT e Grok tramite la tua chiave AIGROW.

Acquista credito API

Hai già un codice? Riscattalo su Accesso API, poi crea una chiave.

opencode.json nel tuo progetto

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aigrow": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AIGROW",
      "options": { "baseURL": "https://aigrow.gg/v1" },
      "models": { "claude-opus-5.5": { "name": "Claude Opus 5.5" } }
    }
  }
}

Sostituisci ag_your_key_here con una chiave presa da Accesso API.

Dove si trova l'impostazione

Un progetto: opencode.json
Ogni progetto: ~/.config/opencode/opencode.json
La chiave, dopo /connect: ~/.local/share/opencode/auth.json

Salva la chiaveIn OpenCode esegui /connect, scorri fino a Other e inserisci aigrow come id del provider.

Incolla la tua chiaveIncolla la tua chiave AIGROW quando OpenCode la richiede.

Aggiungi il providerInserisci il blocco in opencode.json. L’id del provider nel file deve corrispondere a quello digitato in /connect.

Altri modelli e un modello predefinito

Elenca tutti i modelli che vuoi nel selettore e imposta model in modo che OpenCode parta con uno di essi.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aigrow": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AIGROW",
      "options": { "baseURL": "https://aigrow.gg/v1" },
      "models": {
        "claude-opus-5.5": { "name": "Claude Opus 5.5" },
        "grok-4.7": { "name": "Grok 4.7" },
        "gpt-6-astra": { "name": "GPT-6 Astra" }
      }
    }
  },
  "model": "aigrow/claude-opus-5.5"
}

Quale modello usare

Inserisci l'id esattamente come è scritto qui.

Claude Opus 5.5claude-opus-5.5: È l’impostazione predefinita in ogni blocco di questa pagina e il modello Claude più economico qui per token inviato e ricevuto. Contesto: 1.000.000 token.
Grok 4.7grok-4.7: Il prezzo di output più basso qui. Il suo contesto è la metà di quello dei modelli Claude. Contesto: 500.000 token.
GPT-6 Astragpt-6-astra: Per un modello GPT. Costa per token quanto Fable, più di Opus. Contesto: 1.050.000 token.
Claude Fable 5.1claude-fable-5.1: Costa più di Opus per token. Confronta i due sulla classifica di coding prima di passare all’altro. Contesto: 1.000.000 token.

Il listino prezzi riporta ogni id con la sua tariffa in crediti, i prezzi dell'API di Claude riportano i prezzi di listino e la classifica per il coding confronta i modelli su prompt di programmazione.

Verifica che funzioni

Prima la chiave da sola, poi OpenCode con la chiave.

La chiave

Richiedi l'elenco dei modelli. Serve una chiave valida e non costa nulla.

curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"

Con una chiave valida ricevi l'elenco:

{
  "object": "list",
  "data": [
    { "id": "claude-opus-5.5", "object": "model", ... },
    { "id": "claude-fable-5.1", "object": "model", ... },
    { "id": "gpt-6-astra", "object": "model", ... },
    { "id": "claude-sonnet-5.5", "object": "model", ... },
    { "id": "gpt-6.1-sol", "object": "model", ... },
    { "id": "grok-4.7", "object": "model", ... },
    ...
  ],
  "has_more": false
}

OpenCode

Esegui /models, scegli un modello sotto AIGROW e invia questo prompt.

Reply with the word ready

Una configurazione funzionante risponde nella sessione:

ready

Quando non funziona

Prima gli errori di OpenCode, poi le risposte che l'endpoint dà a qualsiasi strumento.

Il provider non ha una chiave: Esegui opencode auth list. Se aigrow non compare, esegui di nuovo /connect e controlla che l’id corrisponda a quello in opencode.json.
404 con @ai-sdk/openai: Quel pacchetto chiama la Responses API, che l’endpoint non supporta. Usa @ai-sdk/openai-compatible, come nel blocco.
Il mio strumento mostra un errore 401 o di autenticazione: La chiave manca o è stata digitata in modo errato. Copiala di nuovo da Accesso API nella dashboard e assicurati che venga inviata come chiave, non come nome di un modello. Una chiave revocata dà lo stesso errore: creane una nuova e sostituiscila.
Ricevo un errore 402 o un messaggio sul credito: Il tuo saldo è esaurito. Apri Accesso API nella dashboard, riscatta un codice o acquista un altro pacchetto e la richiesta successiva andrà a buon fine. Non serve cambiare nient’altro.
Compare 404 o Unknown model: Il modello deve essere uno di quelli serviti dall’endpoint, per esempio claude-opus-5.5. Funzionano anche le grafie originali del provider (claude-opus-5-5, anthropic/claude-opus-5.5), ma un id con data o qualsiasi modello fuori dal catalogo viene rifiutato prima che la richiesta sia inoltrata, e non viene addebitato nulla. Con la tua chiave richiedi GET /v1/models per l’elenco aggiornato, oppure leggi gli id nel listino.
Le richieste vengono rifiutate con errore 429: La capacità dell’endpoint è condivisa da tutti i clienti: circa 20 richieste al minuto e 4 contemporaneamente. Ogni risposta 429 include un header retry-after, e gli SDK di OpenAI e Anthropic attendono quel tempo e riprovano da soli. In un ciclo scritto da te, attendi i secondi indicati oppure riduci la concorrenza.
Il modello al momento non è disponibile: Un 404 che indica che il modello non è al momento disponibile significa che è temporaneamente fuori servizio presso il provider a monte, non che c'è un problema con la tua chiave o il tuo saldo. Riprova tra qualche istante oppure invia la richiesta a un altro modello.
Ricevo un errore 502 o 503: Un problema temporaneo a monte o di configurazione, che non viene addebitato sul tuo saldo. Riprova la richiesta; se continua a fallire, scrivici tramite lo store e ce ne occuperemo.

Cosa non funziona tramite AIGROW

Il pacchetto @ai-sdk/openai, che chiama /v1/responses. Tutti i modelli qui funzionano con @ai-sdk/openai-compatible.
Ricerca web in tempo reale all’interno del modello. Uno strumento di ricerca web inviato con una richiesta riceve risposta da ciò che il modello già sa, senza risultati in tempo reale. Uno strumento che recupera pagine sulla tua macchina funziona comunque.
Qualsiasi endpoint oltre a questi tre: /v1/messages, /v1/chat/completions e /v1/models. La Responses API, gli embedding e il conteggio dei token rispondono 404.
I campi del router, come models, route, provider e plugins. Vengono scartati, quindi una richiesta va sempre al solo modello che indica.

Quanto costa un mese di OpenCode

OpenCode viene fatturato per token alle tariffe in crediti del listino prezzi. Un agente rinvia l'intera conversazione a ogni passaggio, quindi un compito lungo costa più di quanto suggerisca il suo ultimo messaggio; il registro attività su Accesso API mostra quanto è costata ogni richiesta.

Domande su OpenCode e su un'API personalizzata

Come aggiungo un provider personalizzato a OpenCode?: Esegui /connect, scegli Other e salva la tua chiave con un id di provider, poi aggiungi a opencode.json un provider con quell’id, con npm impostato su @ai-sdk/openai-compatible e options.baseURL impostato su https://aigrow.gg/v1.
Dove tiene la chiave OpenCode?: In ~/.local/share/opencode/auth.json dopo /connect. opencode auth list mostra quali provider ne hanno una.
Quale pacchetto npm usa il provider?: @ai-sdk/openai-compatible, che chiama /v1/chat/completions. @ai-sdk/openai chiama /v1/responses, che l’endpoint non serve.

Fonti: OpenCode Providers · OpenCode Config. Consultato il 21 ottobre 2026.

Configura un altro strumento

Claude CodeProtocollo Anthropic
Quattro variabili d’ambiente, nella shell o in settings.json.
ClineProtocollo OpenAI
Il provider OpenAI Compatible, quattro campi nella schermata delle impostazioni.
Roo CodeProtocollo OpenAI
Il provider OpenAI Compatible, con gli stessi campi di Cline.
Kilo CodeProtocollo OpenAI
Un provider personalizzato nella scheda Providers; l’elenco dei modelli si compila da solo.
ContinueProtocollo OpenAI
Una voce in models nel file config.yaml, con provider openai e un apiBase.
AiderProtocollo OpenAI
OPENAI_API_BASE e OPENAI_API_KEY, poi openai/ prima dell’id del modello.
ZedProtocolli Anthropic e OpenAI
Un provider compatibile con Anthropic per Claude, uno compatibile con OpenAI per GPT e Grok.
GooseProtocollo OpenAI
Il provider OpenAI con OPENAI_HOST, oppure un file di provider personalizzato.
Vercel AI SDKProtocolli Anthropic e OpenAI
Il provider OpenAI Compatible per ogni modello, oppure il provider Anthropic per Claude.
OpenAI Agents SDKProtocollo OpenAI
Il tuo client AsyncOpenAI, passato alle chat completions, con il tracing disattivato.
LangChainProtocolli Anthropic e OpenAI
ChatOpenAI con base_url per ogni modello, oppure ChatAnthropic per Claude.

La guida all'API comprende gli SDK, curl, gli endpoint e i limiti di frequenza.

Incolla il blocco e OpenCode funziona con il tuo credito.

Acquista un pacchetto di credito, riscatta il codice ricevuto via email su Accesso API, crea una chiave e inseriscila al posto di ag_your_key_here.

Acquista credito API Vedi prezzi e modelli