Goose con un host OpenAI personalizzato
Imposta queste quattro variabili prima di avviare Goose: Goose funzionerà con i modelli Claude, GPT e Grok tramite la tua chiave AIGROW.
Hai già un codice? Riscattalo su Accesso API, poi crea una chiave.
Shell, prima di avviare goose
export GOOSE_PROVIDER=openai
export OPENAI_HOST=https://aigrow.gg
export OPENAI_API_KEY=ag_your_key_here
export GOOSE_MODEL=claude-opus-5.5Sostituisci ag_your_key_here con una chiave presa da Accesso API.
Dove si trova l'impostazione
- Provider personalizzati, macOS e Linux
~/.config/goose/custom_providers/- Provider personalizzati, Windows
%APPDATA%\Block\goose\config\custom_providers\
Oppure un provider personalizzato
Salvalo come aigrow.json nella cartella dei provider personalizzati. Qui base_url è l’intero indirizzo di chat completions.
{
"name": "aigrow",
"engine": "openai",
"display_name": "AIGROW",
"api_key_env": "AIGROW_API_KEY",
"base_url": "https://aigrow.gg/v1/chat/completions",
"models": [
{
"name": "claude-opus-5.5",
"context_limit": 1000000
},
{
"name": "grok-4.7",
"context_limit": 500000
}
],
"supports_streaming": true,
"requires_auth": true
}Poi avvia una sessione con quel provider
Il file del provider legge la chiave da AIGROW_API_KEY.
export AIGROW_API_KEY=ag_your_key_here
goose session start --provider aigrowQuale modello usare
Inserisci l'id esattamente come è scritto qui.
- Claude Opus 5.5
claude-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.7
grok-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 Astra
gpt-6-astra - Per un modello GPT. Costa per token quanto Fable, più di Opus. Contesto: 1.050.000 token.
- Claude Fable 5.1
claude-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 Goose 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"{
"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
}Goose
Esegui un prompt indicando il modello.
goose run --model claude-opus-5.5 -t "Reply with the word ready"readyQuando non funziona
Prima gli errori di Goose, poi le risposte che l'endpoint dà a qualsiasi strumento.
- 404 a ogni richiesta
- OPENAI_HOST è la radice, https://aigrow.gg, senza nulla dopo: Goose aggiunge da solo v1/chat/completions. Se hai modificato OPENAI_BASE_PATH, reimposta v1/chat/completions.
- 401 No api key passed in
- Goose non ha caricato la chiave. Ignora una chiave scritta in config.yaml, quindi esporta OPENAI_API_KEY nella shell oppure salvala tramite Goose Desktop.
- goose configure non accetta l’id del modello
- goose configure propone solo i modelli che conosce. Imposta invece GOOSE_MODEL, oppure passa --model quando esegui goose.
- 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
Una chiave in config.yaml. Goose la legge dall’ambiente o dal suo portachiavi, mai da quel file.
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 Goose
Goose 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 Goose e su un'API personalizzata
- OPENAI_HOST include /v1?
- No. OPENAI_HOST è https://aigrow.gg, la radice, e Goose aggiunge v1/chat/completions da OPENAI_BASE_PATH. Un file di provider personalizzato è diverso: il suo base_url è l’intero indirizzo di chat completions.
- Posso aggiungere AIGROW in Goose Desktop?
- Sì. In Settings > Models > Configure providers scegli Add Custom Provider, imposta il tipo su OpenAI compatible, poi inserisci l’URL dell’API, la tua chiave e gli ID dei modelli.
- Come uso un modello che goose configure non elenca?
- Imposta GOOSE_MODEL sull’id, per esempio claude-opus-5.5, oppure avvia con goose run --model e l’id.
Fonti: Goose Providers. 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.
- OpenCodeProtocollo OpenAI
Un blocco provider in opencode.json e la chiave tramite /connect.
- ZedProtocolli Anthropic e OpenAI
Un provider compatibile con Anthropic per Claude, uno compatibile con OpenAI per GPT e Grok.
- 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 Goose 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.