O OPENAI_HOST inclui /v1?

Não. OPENAI_HOST é https://aigrow.gg, a raiz, e o Goose acrescenta v1/chat/completions a partir de OPENAI_BASE_PATH. Um ficheiro de fornecedor personalizado é diferente: o seu base_url é o endereço completo de chat completions.

Posso adicionar AIGROW no Goose Desktop?

Sim. Em Settings > Models > Configure providers, escolha Add Custom Provider, defina o tipo como OpenAI compatible, o URL da API, a sua chave e os ids dos modelos.

Como uso um modelo que o goose configure não lista?

Defina GOOSE_MODEL com o id, por exemplo claude-opus-5.5, ou inicie com goose run --model e o id.

Goose com um host OpenAI personalizado

Defina estas quatro variáveis antes de iniciar o Goose, e o Goose passa a funcionar com modelos Claude, GPT e Grok através da sua chave AIGROW.

Comprar crédito de API

Já tem um código? Resgate-o em Acesso à API e depois crie uma chave.

Shell, antes de iniciar o 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.5

Substitua ag_your_key_here por uma chave de Acesso à API.

Onde fica a definição

Fornecedores personalizados, macOS e Linux: ~/.config/goose/custom_providers/
Fornecedores personalizados, Windows: %APPDATA%\Block\goose\config\custom_providers\

Ou um fornecedor personalizado

Guarde isto como aigrow.json na pasta de fornecedores personalizados. Aqui, base_url é o endereço completo de 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
}

Depois inicie uma sessão com ele

O ficheiro do fornecedor lê a chave de AIGROW_API_KEY.

export AIGROW_API_KEY=ag_your_key_here
goose session start --provider aigrow

Que modelo usar

Introduza o id exatamente como está escrito aqui.

Claude Opus 5.5claude-opus-5.5: A opção predefinida em todos os blocos desta página e o modelo Claude mais barato aqui por token enviado e recebido. Contexto: 1 000 000 tokens.
Grok 4.7grok-4.7: O preço de saída mais baixo aqui. O seu contexto tem metade do tamanho dos modelos Claude. Contexto: 500 000 tokens.
GPT-6 Astragpt-6-astra: Para um modelo GPT. Custa o mesmo por token que o Fable e mais do que o Opus. Contexto: 1 050 000 tokens.
Claude Fable 5.1claude-fable-5.1: Custa mais por token do que o Opus. Compare os dois no ranking de programação antes de mudar. Contexto: 1 000 000 tokens.

A lista de preços tem todos os ids e a respetiva taxa de crédito, os preços da API do Claude indicam os preços de tabela e o ranking de programação compara os modelos em prompts de programação.

Verifique se funciona

Primeiro a chave isolada, depois o Goose com ela.

A chave

Peça a lista de modelos. Requer uma chave válida e não custa nada.

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

Uma chave válida devolve a lista:

{
  "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

Execute um prompt com o modelo indicado.

goose run --model claude-opus-5.5 -t "Reply with the word ready"

Uma configuração que funcione imprime a resposta:

ready

Quando falha

Primeiro os erros do Goose, depois as respostas que o endpoint dá a qualquer ferramenta.

404 em todos os pedidos: OPENAI_HOST é a raiz, https://aigrow.gg, sem nada depois: o Goose acrescenta v1/chat/completions por si. Se alterou OPENAI_BASE_PATH, volte a defini-lo como v1/chat/completions.
401 No api key passed in: O Goose não carregou a chave. Ignora uma chave escrita em config.yaml, por isso exporte OPENAI_API_KEY na shell ou guarde-a através do Goose Desktop.
O goose configure não aceita o id do modelo: O goose configure oferece apenas os modelos que conhece. Defina antes GOOSE_MODEL, ou passe --model ao executar o goose.
A minha ferramenta indica 401 ou erro de autenticação: A chave está em falta ou foi escrita incorretamente. Copie-a de novo em Acesso à API no painel e certifique-se de que é enviada como chave, e não como nome de modelo. Uma chave revogada falha da mesma forma: crie uma nova e substitua-a.
Recebo 402 ou uma mensagem sobre crédito: O seu saldo está vazio. Abra Acesso à API no painel, resgate um código ou compre outro pacote e o pedido seguinte será processado. Não é preciso mudar mais nada.
Aparece 404 ou Unknown model: O modelo tem de ser um dos que o endpoint disponibiliza, por exemplo claude-opus-5.5. A grafia própria do fornecedor também funciona (claude-opus-5-5, anthropic/claude-opus-5.5), mas um id com data ou qualquer modelo fora do catálogo é rejeitado antes de o pedido ser encaminhado e nada é cobrado. Peça GET /v1/models com a sua chave para obter a lista atual, ou consulte os ids na lista de preços.
Os pedidos são rejeitados com 429: A capacidade do endpoint é partilhada por todos os clientes: cerca de 20 pedidos por minuto e 4 em simultâneo. Cada resposta 429 inclui um cabeçalho retry-after, e os SDKs da OpenAI e da Anthropic esperam esse tempo e voltam a tentar por conta própria. Num ciclo seu, aguarde os segundos indicados ou reduza a concorrência.
O modelo está indisponível neste momento: Um 404 que indica que o modelo não está disponível neste momento significa que ele está brevemente em baixo no fornecedor de origem, e não um problema com a sua chave ou saldo. Tente novamente daqui a pouco ou envie o pedido para outro modelo.
Recebo um 502 ou 503: Uma falha transitória na origem ou na configuração, sem qualquer cobrança no seu saldo. Repita o pedido; se continuar a falhar, contacte-nos através da loja e vamos analisar.

O que não funciona através da AIGROW

Uma chave em config.yaml. O Goose lê-a do ambiente ou do porta-chaves, nunca desse ficheiro.
Pesquisa web em tempo real dentro do modelo. Uma ferramenta de pesquisa web enviada num pedido é respondida com o que o modelo já sabe, sem resultados em tempo real. Uma ferramenta que obtém páginas na sua própria máquina continua a funcionar.
Qualquer endpoint além destes três: /v1/messages, /v1/chat/completions e /v1/models. A Responses API, os embeddings e a contagem de tokens respondem 404.
Campos de router como models, route, provider e plugins. São descartados, por isso um pedido vai sempre para o único modelo que indica.

Quanto custa um mês de Goose

O Goose é faturado por token às taxas de crédito da lista de preços. Um agente volta a enviar a conversa inteira a cada passo, por isso uma tarefa longa custa mais do que a última mensagem sugere; o registo de atividade em Acesso à API mostra quanto custou cada pedido.

Perguntas sobre o Goose e uma API personalizada

O OPENAI_HOST inclui /v1?: Não. OPENAI_HOST é https://aigrow.gg, a raiz, e o Goose acrescenta v1/chat/completions a partir de OPENAI_BASE_PATH. Um ficheiro de fornecedor personalizado é diferente: o seu base_url é o endereço completo de chat completions.
Posso adicionar AIGROW no Goose Desktop?: Sim. Em Settings > Models > Configure providers, escolha Add Custom Provider, defina o tipo como OpenAI compatible, o URL da API, a sua chave e os ids dos modelos.
Como uso um modelo que o goose configure não lista?: Defina GOOSE_MODEL com o id, por exemplo claude-opus-5.5, ou inicie com goose run --model e o id.

Fontes: Goose Providers. Consultado em 21 de outubro de 2026.

Configurar outra ferramenta

Claude CodeProtocolo Anthropic
Quatro variáveis de ambiente, na shell ou no settings.json.
ClineProtocolo OpenAI
O fornecedor OpenAI Compatible, quatro campos no ecrã de definições.
Roo CodeProtocolo OpenAI
O fornecedor OpenAI Compatible, os mesmos campos do Cline.
Kilo CodeProtocolo OpenAI
Um fornecedor personalizado no separador Providers; a lista de modelos preenche-se sozinha.
ContinueProtocolo OpenAI
Uma entrada models no config.yaml, com provider openai e um apiBase.
AiderProtocolo OpenAI
OPENAI_API_BASE e OPENAI_API_KEY, depois openai/ antes do ID do modelo.
OpenCodeProtocolo OpenAI
Um bloco provider no opencode.json e a chave através de /connect.
ZedProtocolos Anthropic e OpenAI
Um fornecedor compatível com Anthropic para Claude, um compatível com OpenAI para GPT e Grok.
Vercel AI SDKProtocolos Anthropic e OpenAI
O fornecedor OpenAI Compatible para todos os modelos, ou o fornecedor Anthropic para o Claude.
OpenAI Agents SDKProtocolo OpenAI
O seu próprio cliente AsyncOpenAI, mudado para chat completions, com o tracing desativado.
LangChainProtocolos Anthropic e OpenAI
ChatOpenAI com base_url para todos os modelos, ou ChatAnthropic para o Claude.

O guia da API inclui os SDKs, o curl, os endpoints e os limites de utilização.

Cole o bloco e o Goose passa a funcionar com o seu crédito.

Compre um pacote de crédito, resgate o código do seu email em Acesso à API, crie uma chave e coloque-a no lugar de ag_your_key_here.

Comprar crédito de API Ver preços e modelos