Goose con un host de OpenAI personalizado
Define estas cuatro variables antes de iniciar Goose y funcionará con modelos Claude, GPT y Grok a través de tu clave de AIGROW.
¿Ya tienes un código? Canjéalo en acceso a la API y después crea una clave.
Shell, antes de iniciar 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.5Cambia ag_your_key_here por una clave de acceso a la API.
Dónde está el ajuste
- Proveedores personalizados, macOS y Linux
~/.config/goose/custom_providers/- Proveedores personalizados, Windows
%APPDATA%\Block\goose\config\custom_providers\
O un proveedor personalizado
Guárdalo como aigrow.json en la carpeta de proveedores personalizados. Aquí base_url es la dirección completa 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
}Después inicia una sesión con él
El archivo del proveedor lee la clave de AIGROW_API_KEY.
export AIGROW_API_KEY=ag_your_key_here
goose session start --provider aigrowQué modelo usar
Escribe el id exactamente como aparece aquí.
- Claude Opus 5.5
claude-opus-5.5 - Es el modelo predeterminado en todos los bloques de esta página y el modelo Claude más barato de aquí por token enviado y recibido. Contexto: 1.000.000 tokens.
- Grok 4.7
grok-4.7 - El precio de salida más bajo de aquí. Su contexto es la mitad que el de los modelos Claude. Contexto: 500.000 tokens.
- GPT-6 Astra
gpt-6-astra - Para un modelo GPT. Cuesta lo mismo por token que Fable y más que Opus. Contexto: 1.050.000 tokens.
- Claude Fable 5.1
claude-fable-5.1 - Cuesta más por token que Opus. Compara ambos en la clasificación de programación antes de cambiar. Contexto: 1.000.000 tokens.
La lista de precios incluye cada id y su tarifa en crédito, los precios de la API de Claude muestran las tarifas oficiales y la clasificación de programación compara los modelos con consultas de código.
Comprueba que funciona
Primero la clave por sí sola y después Goose con ella.
La clave
Pide la lista de modelos. Requiere una clave válida y no cuesta nada.
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
Ejecuta un prompt indicando el modelo.
goose run --model claude-opus-5.5 -t "Reply with the word ready"readyCuando falla
Primero los errores de Goose y luego las respuestas que el endpoint da a cualquier herramienta.
- 404 en todas las solicitudes
- OPENAI_HOST es la raíz, https://aigrow.gg, sin nada después: Goose añade v1/chat/completions por su cuenta. Si cambiaste OPENAI_BASE_PATH, vuelve a ponerlo en v1/chat/completions.
- 401 No api key passed in
- Goose no cargó la clave. Ignora una clave escrita en config.yaml, así que exporta OPENAI_API_KEY en el shell o guárdala desde Goose Desktop.
- goose configure no acepta el id del modelo
- goose configure solo ofrece los modelos que conoce. Define GOOSE_MODEL en su lugar, o pasa --model al ejecutar goose.
- Mi herramienta muestra un error 401 o de autenticación
- Falta la clave o está mal escrita. Cópiala de nuevo desde Acceso a la API en el panel y asegúrate de enviarla como clave, no como nombre de modelo. Una clave revocada falla igual: crea una nueva y sustitúyela.
- Recibo un 402 o un mensaje sobre el crédito
- Tu saldo está agotado. Abre Acceso a la API en el panel, canjea un código o compra otro paquete y la siguiente solicitud se procesará. No hace falta cambiar nada más.
- Aparece 404 o Unknown model
- El modelo tiene que ser uno de los que sirve el endpoint, por ejemplo claude-opus-5.5. Las grafías propias del proveedor también funcionan (claude-opus-5-5, anthropic/claude-opus-5.5), pero un id con fecha o cualquier modelo fuera del catálogo se rechaza antes de reenviar la solicitud y no se factura nada. Solicita GET /v1/models con tu clave para ver la lista actualizada, o consulta los ids en la lista de precios.
- Las solicitudes se rechazan con un 429
- La capacidad del endpoint la comparten todos los clientes: unas 20 solicitudes por minuto y 4 simultáneas. Cada 429 incluye una cabecera retry-after, y los SDK de OpenAI y Anthropic esperan ese tiempo y reintentan por su cuenta. En un bucle propio, espera los segundos que indica o reduce la concurrencia.
- El modelo no está disponible en este momento
- Un 404 que indica que el modelo no está disponible en este momento significa que el proveedor original ha dejado de responder durante un breve periodo; no es un problema de tu clave ni de tu saldo. Reintenta en unos instantes o envía la solicitud a otro modelo.
- Recibo un 502 o un 503
- Es un fallo transitorio del proveedor o de la configuración, y no se cobra de tu saldo. Reintenta la solicitud; si sigue fallando, escríbenos a través de la tienda y lo revisaremos.
Lo que no funciona a través de AIGROW
Una clave en config.yaml. Goose la lee del entorno o de su llavero, nunca de ese archivo.
Búsqueda web en vivo dentro del modelo. Una herramienta de búsqueda web enviada con una solicitud se responde con lo que el modelo ya sabe, sin resultados en vivo. Una herramienta que obtiene páginas en tu propio equipo sigue funcionando.
Cualquier endpoint además de estos tres: /v1/messages, /v1/chat/completions y /v1/models. La Responses API, los embeddings y el recuento de tokens responden 404.
Campos de enrutador como models, route, provider y plugins. Se descartan, de modo que una solicitud siempre va al único modelo que indica.
Cuánto cuesta un mes con Goose
Goose se factura por token a las tarifas de crédito de la lista de precios. Un agente reenvía toda la conversación en cada paso, así que una tarea larga cuesta más de lo que sugiere su último mensaje; el registro de actividad de acceso a la API muestra lo que costó cada solicitud.
Preguntas sobre Goose y una API personalizada
- ¿OPENAI_HOST incluye /v1?
- No. OPENAI_HOST es https://aigrow.gg, la raíz, y Goose añade v1/chat/completions a partir de OPENAI_BASE_PATH. Un archivo de proveedor personalizado es distinto: su base_url es la dirección completa de chat completions.
- ¿Puedo añadir AIGROW en Goose Desktop?
- Sí. En Settings > Models > Configure providers, elige Add Custom Provider, define el tipo como compatible con OpenAI e indica la URL de la API, tu clave y los ids de los modelos.
- ¿Cómo uso un modelo que goose configure no muestra?
- Define GOOSE_MODEL con el id, por ejemplo claude-opus-5.5, o inicia con goose run --model y el id.
Fuentes: Goose Providers. Consultado el 21 de octubre de 2026.
Configurar otra herramienta
- Claude CodeProtocolo de Anthropic
Cuatro variables de entorno, en la shell o en settings.json.
- ClineProtocolo de OpenAI
El proveedor OpenAI Compatible, cuatro campos en la pantalla de ajustes.
- Roo CodeProtocolo de OpenAI
El proveedor OpenAI Compatible, los mismos campos que en Cline.
- Kilo CodeProtocolo de OpenAI
Un proveedor personalizado en la pestaña Providers; la lista de modelos se rellena sola.
- ContinueProtocolo de OpenAI
Una entrada de models en config.yaml, con provider openai y un apiBase.
- AiderProtocolo de OpenAI
OPENAI_API_BASE y OPENAI_API_KEY, y después openai/ antes del id del modelo.
- OpenCodeProtocolo de OpenAI
Un bloque provider en opencode.json y la clave mediante /connect.
- ZedProtocolos de Anthropic y OpenAI
Un proveedor compatible con Anthropic para Claude y uno compatible con OpenAI para GPT y Grok.
- Vercel AI SDKProtocolos de Anthropic y OpenAI
El proveedor compatible con OpenAI para todos los modelos, o el proveedor de Anthropic para Claude.
- OpenAI Agents SDKProtocolo de OpenAI
Tu propio cliente AsyncOpenAI, cambiado a chat completions y con el rastreo desactivado.
- LangChainProtocolos de Anthropic y OpenAI
ChatOpenAI con base_url para todos los modelos, o ChatAnthropic para Claude.
La guía de la API incluye los SDK, curl, los endpoints y los límites de uso.
Pega el bloque y Goose funcionará con tu crédito.
Compra un paquete de crédito, canjea el código de tu correo en acceso a la API, crea una clave y ponla en lugar de ag_your_key_here.