Goose con Claude y GPT: API propia en CLI y Desktop

Goose es un agente de IA de código abierto, creado originalmente por Block, que se ejecuta en tu propio equipo como herramienta de línea de comandos (goose CLI) y como aplicación de escritorio (goose Desktop). Edita archivos, ejecuta comandos y se conecta a otras herramientas mediante extensiones (servidores MCP). Goose no incluye un modelo: conectas un proveedor de LLM y cada paso de una sesión es una solicitud que factura ese proveedor.

Esta guía se comprobó con la documentación y el código fuente de Goose 1.54 (octubre de 2026).

APIVAI te da una sola clave para Claude y GPT, facturada por token (por debajo de los precios oficiales en la mayoría de los modelos), desde un saldo que recargas tú. La misma clave funciona en el formato de OpenAI y en el de Anthropic, así que sirve para los dos proveedores integrados de Goose que importan aquí.

Los dos ajustes de host solo admiten la raíz del servidor. Goose une el host con una ruta de solicitud: v1/chat/completions (de OPENAI_BASE_PATH), v1/responses o v1/messages. Un host que termina en /v1 produce /v1/v1/... y un 404.

Elige OpenAI si quieres una configuración para todos los modelos. Con este proveedor, Goose envía los modelos de las familias GPT-5 y GPT-6 a la Responses API (v1/responses) y los demás, como Claude, a v1/chat/completions; APIVAI sirve ambos endpoints. Elige Anthropic si solo usas Claude: Goose activa automáticamente la caché de prompts para los modelos Claude en el proveedor Anthropic, así que el contexto repetido se cobra al precio de lectura de caché, $0.12 por millón de tokens con Claude Sonnet 4.6, en lugar del precio completo de entrada. Escribir en caché cuesta $1.44 por millón.

1. Regístrate en apivai.com con tu correo.
2. Recarga desde $10 con tarjeta, cripto, Alipay o WeChat Pay. No hay prueba gratuita ni suscripción.
3. En el Dashboard, crea una clave y cópiala. Ponle un límite de presupuesto si quieres un tope firme para lo que puede gastar Goose.

1. Ejecuta goose configure.
2. Selecciona Configure Providers y pulsa Enter.
3. Elige OpenAI.
4. Cuando te pida OPENAI_API_KEY, pega tu clave de APIVAI.
5. En Would you like to configure advanced settings? responde Yes y rellena las preguntas según la tabla. Salta las demás (organización, proyecto, cabeceras personalizadas, tiempo de espera) con Enter.
6. Elige el modelo de la lista, búscalo o selecciona Enter a model not listed... y escribe el ID exacto.
7. Empieza a trabajar con goose session.

En versiones antiguas de Goose, la pregunta del host aparece justo después de la clave, sin la pregunta de ajustes avanzados; los valores son los mismos. Goose guarda la clave en el llavero del sistema (o en secrets.yaml si no hay llavero), nunca en config.yaml.

Comprueba qué IDs puede usar tu clave:

Los modelos se añaden y se retiran con el tiempo, así que copia los IDs de esta lista o de la página de precios.

Vuelve a ejecutar goose configure, elige Configure Providers y luego Anthropic. Pega la misma clave como ANTHROPIC_API_KEY, responde Yes a los ajustes avanzados, pon ANTHROPIC_HOST en https://api.apivai.com y elige un modelo Claude. No añadas /v1: Goose envía las solicitudes de Anthropic al host más v1/messages, es decir, a https://api.apivai.com/v1/messages. Encontrarás más sobre el formato de Anthropic en la página del proxy de la API de Claude.

1. Abre la barra lateral, pulsa Settings, abre la pestaña Models y pulsa Configure providers.
2. Pulsa OpenAI, introduce tu clave de APIVAI y pon el host (OPENAI_HOST) en https://api.apivai.com. Pulsa Submit.
3. En Models, pulsa Switch models, elige el proveedor OpenAI, selecciona Use custom model, escribe claude-sonnet-4-6 y pulsa Select model.

También puedes pulsar Add Custom Provider al final de la lista de proveedores: en Provider Type elige OpenAI Compatible, en Display Name escribe APIVAI, en API URL pon https://api.apivai.com/v1, pega la clave, enumera los IDs de modelo en Available Models (separados por comas) y pulsa Create Provider. Así APIVAI queda separado de una configuración real de OpenAI.

En Windows PowerShell, usa $env:OPENAI_HOST = "https://api.apivai.com" y así sucesivamente. Las variables de entorno prevalecen sobre el archivo de configuración en ese proceso. No pongas la clave de API en config.yaml: Goose no lee de ahí las claves de los proveedores.

Precios por 1M de tokens de entrada / salida a fecha de 2026-10-10:

Goose depende de las llamadas a herramientas para todo lo que hace, así que usa modelos que las admitan; todos los de la tabla lo hacen. Los modelos GPT necesitan el proveedor OpenAI o un proveedor personalizado OpenAI Compatible.

Cada turno de una sesión de Goose reenvía la conversación, los resultados de las herramientas y las instrucciones de las extensiones, así que los tokens de entrada son la mayor parte del gasto. Dos ejemplos calculados:

• Una sesión de trabajo con Claude Sonnet 4.6: unas 30 solicitudes de 30.000 tokens de entrada y 1.500 de salida cada una. Coste: $1.29 con APIVAI, $3.38 a precios oficiales.
• Un mes con dos sesiones así al día durante 22 días (1.320 solicitudes): $56.91 con APIVAI, $149 a precios oficiales. Una pequeña receta diaria con Claude Haiku 4.5 (10 solicitudes de 10.000 tokens de entrada y 1.000 de salida, 220 al mes) cuesta $1.26.

Estas cifras no incluyen la caché de prompts del proveedor Anthropic. Los tokens de razonamiento se cuentan como tokens de salida. Tus cifras reales por solicitud están en el Dashboard. Para una comparación más amplia, lee los precios de la API de Claude en 2026.

• 401 Unauthorized: la clave es incorrecta, se eliminó o superó su límite de presupuesto, o está en config.yaml, donde Goose la ignora. Vuelve a ejecutar goose configure o define OPENAI_API_KEY / ANTHROPIC_API_KEY.
• 404 Not Found: /v1 incorrecto. OPENAI_HOST y ANTHROPIC_HOST son https://api.apivai.com sin ruta, y OPENAI_BASE_PATH se queda en v1/chat/completions. No pongas valores contradictorios en OPENAI_BASE_URL y OPENAI_HOST.
• Modelo no encontrado: usa el ID exacto, como claude-sonnet-4-6, no un nombre comercial. Compáralo con GET /v1/models.
• Respuestas vacías o truncadas: el razonamiento está activado por defecto y consume tokens de salida. Pon GOOSE_MAX_TOKENS en 8192 (mínimo 4096).
• 429 Too Many Requests: el límite por defecto es de 60 solicitudes por minuto por clave. Espera un poco o pide a soporte que lo amplíe.

Hay más información sobre los formatos de solicitud en la documentación y en la página de API compatible con OpenAI.

Sí. Una clave de APIVAI sirve para todos los modelos. Con el proveedor OpenAI solo cambias GOOSE_MODEL o cambias de modelo en la aplicación.

Goose construye la URL con el host más OPENAI_BASE_PATH, que ya empieza por v1/. La solicitud completa va a https://api.apivai.com/v1/chat/completions.

Usa OpenAI para los modelos GPT o para una sola configuración. Usa Anthropic para trabajar solo con Claude, donde Goose activa la caché de prompts; su host también es https://api.apivai.com.

No. APIVAI sirve solo modelos de chat; el chat, las llamadas a herramientas y las extensiones funcionan, pero cualquier función que necesite un modelo de embeddings debe usar otro proveedor.

No. El contenido de las solicitudes y respuestas no se registra; solo se conservan datos de uso como el modelo, los tokens y el coste para la facturación.

Sí. Consulta la guía de Aider y la guía de OpenCode.

Crea una cuenta, recarga desde $10 y pega tu clave en Goose.