Goose com Claude e GPT: API própria no CLI e no Desktop

O Goose é um agente de IA de código aberto, criado originalmente pela Block, que roda na sua própria máquina como ferramenta de linha de comando (goose CLI) e como aplicativo de desktop (goose Desktop). Ele edita arquivos, executa comandos e se conecta a outras ferramentas por meio de extensões (servidores MCP). O Goose não vem com um modelo: você conecta um provedor de LLM, e cada passo de uma sessão é uma requisição cobrada por esse provedor.

Este guia foi conferido com a documentação e o código-fonte do Goose 1.54 (outubro de 2026).

A APIVAI oferece uma única chave para Claude e GPT, cobrada por token (abaixo dos preços oficiais na maioria dos modelos), a partir de um saldo que você mesmo recarrega. A mesma chave funciona no formato da OpenAI e no da Anthropic, então serve para os dois provedores integrados do Goose que importam aqui.

As duas configurações de host aceitam apenas a raiz do servidor. O Goose junta o host com um caminho de requisição: v1/chat/completions (de OPENAI_BASE_PATH), v1/responses ou v1/messages. Um host terminado em /v1 gera /v1/v1/... e um 404.

Escolha OpenAI se quiser uma configuração para todos os modelos. Com esse provedor, o Goose envia os modelos das famílias GPT-5 e GPT-6 para a Responses API (v1/responses) e os demais, como o Claude, para v1/chat/completions; a APIVAI atende os dois endpoints. Escolha Anthropic se você usa só o Claude: o Goose ativa o cache de prompts automaticamente para modelos Claude no provedor Anthropic, então o contexto repetido é cobrado pelo preço de leitura do cache, $0.12 por milhão de tokens no Claude Sonnet 4.6, em vez do preço cheio de entrada. A gravação em cache custa $1.44 por milhão.

1. Cadastre-se em apivai.com com seu e-mail.
2. Recarregue a partir de $10 com cartão, cripto, Alipay ou WeChat Pay. Não há teste grátis nem assinatura.
3. No Dashboard, crie uma chave e copie. Defina um limite de orçamento se quiser um teto rígido para o que o Goose pode gastar.

1. Execute goose configure.
2. Selecione Configure Providers e pressione Enter.
3. Escolha OpenAI.
4. Quando ele pedir OPENAI_API_KEY, cole sua chave da APIVAI.
5. Em Would you like to configure advanced settings? responda Yes e preencha as perguntas conforme a tabela. Pule as demais (organização, projeto, cabeçalhos personalizados, tempo limite) com Enter.
6. Escolha o modelo na lista, pesquise por ele ou selecione Enter a model not listed... e digite o ID exato.
7. Comece a trabalhar com goose session.

Em versões mais antigas do Goose, a pergunta do host aparece logo depois da chave, sem a pergunta de configurações avançadas; os valores são os mesmos. O Goose guarda a chave no chaveiro do sistema (ou em secrets.yaml se não houver chaveiro), nunca em config.yaml.

Confira quais IDs a sua chave pode usar:

Modelos são adicionados e retirados com o tempo, então copie os IDs dessa lista ou da página de preços.

Execute goose configure de novo, escolha Configure Providers e depois Anthropic. Cole a mesma chave como ANTHROPIC_API_KEY, responda Yes às configurações avançadas, defina ANTHROPIC_HOST como https://api.apivai.com e escolha um modelo Claude. Não adicione /v1: o Goose envia as requisições da Anthropic para o host mais v1/messages, ou seja, https://api.apivai.com/v1/messages. Veja mais sobre o formato da Anthropic na página do proxy da API do Claude.

1. Abra a barra lateral, clique em Settings, abra a aba Models e clique em Configure providers.
2. Clique em OpenAI, informe sua chave da APIVAI e defina o host (OPENAI_HOST) como https://api.apivai.com. Clique em Submit.
3. Em Models, clique em Switch models, escolha o provedor OpenAI, selecione Use custom model, digite claude-sonnet-4-6 e clique em Select model.

Você também pode clicar em Add Custom Provider no fim da lista de provedores: em Provider Type escolha OpenAI Compatible, em Display Name escreva APIVAI, em API URL informe https://api.apivai.com/v1, cole a chave, liste os IDs de modelo em Available Models (separados por vírgula) e clique em Create Provider. Assim a APIVAI fica separada de uma configuração real da OpenAI.

No Windows PowerShell, use $env:OPENAI_HOST = "https://api.apivai.com" e assim por diante. As variáveis de ambiente substituem o arquivo de configuração naquele processo. Não coloque a chave de API em config.yaml: o Goose não lê chaves de provedores dali.

Preços por 1M de tokens de entrada / saída em 2026-10-10:

O Goose depende de chamadas de ferramentas para tudo o que faz, então use modelos com esse suporte; todos os da tabela têm. Modelos GPT precisam do provedor OpenAI ou de um provedor personalizado OpenAI Compatible.

Cada turno de uma sessão do Goose reenvia a conversa, os resultados das ferramentas e as instruções das extensões, então os tokens de entrada são a maior parte do gasto. Dois exemplos calculados:

• Uma sessão de trabalho com o Claude Sonnet 4.6: cerca de 30 requisições de 30.000 tokens de entrada e 1.500 de saída cada. Custo: $1.29 com a APIVAI, $3.38 no preço oficial.
• Um mês com duas sessões dessas por dia durante 22 dias (1.320 requisições): $56.91 com a APIVAI, $149 no preço oficial. Uma pequena recipe diária no Claude Haiku 4.5 (10 requisições de 10.000 tokens de entrada e 1.000 de saída, 220 por mês) custa $1.26.

Esses valores não consideram o cache de prompts do provedor Anthropic. Tokens de raciocínio contam como tokens de saída. Os seus números reais por requisição estão no Dashboard. Para uma comparação mais ampla, leia os preços da API do Claude em 2026.

• 401 Unauthorized: a chave está errada, foi excluída ou passou do limite de orçamento, ou foi colocada em config.yaml, onde o Goose a ignora. Execute goose configure de novo ou defina OPENAI_API_KEY / ANTHROPIC_API_KEY.
• 404 Not Found: /v1 errado. OPENAI_HOST e ANTHROPIC_HOST são https://api.apivai.com sem caminho, e OPENAI_BASE_PATH fica em v1/chat/completions. Não defina OPENAI_BASE_URL e OPENAI_HOST com valores conflitantes.
• Modelo não encontrado: use o ID exato, como claude-sonnet-4-6, e não um nome de exibição. Compare com GET /v1/models.
• Respostas vazias ou truncadas: o raciocínio vem ativado por padrão e consome tokens de saída. Defina GOOSE_MAX_TOKENS como 8192 (no mínimo 4096).
• 429 Too Many Requests: o limite padrão é de 60 requisições por minuto por chave. Espere um pouco ou peça ao suporte para aumentá-lo.

Há mais informações sobre os formatos de requisição na documentação e na página de API compatível com OpenAI.

Sim. Uma chave da APIVAI funciona com todos os modelos. Com o provedor OpenAI, basta mudar GOOSE_MODEL ou trocar de modelo no aplicativo.

O Goose monta a URL com o host mais OPENAI_BASE_PATH, que já começa com v1/. A requisição completa vai para https://api.apivai.com/v1/chat/completions.

Use OpenAI para os modelos GPT ou para uma configuração única. Use Anthropic para trabalhar só com o Claude, em que o Goose ativa o cache de prompts; o host dele também é https://api.apivai.com.

Não. A APIVAI atende apenas modelos de chat; o chat, as chamadas de ferramentas e as extensões funcionam, mas qualquer recurso que precise de um modelo de embeddings deve usar outro provedor.

Não. O conteúdo das requisições e respostas não é registrado; só ficam guardados dados de uso como modelo, tokens e custo, para a cobrança.

Sim. Veja o guia do Aider e o guia do OpenCode.

Crie uma conta, recarregue a partir de $10 e cole sua chave no Goose.