Documentación

goose

goose divide el endpoint en dos partes: una URL de host y una ruta de solicitud que añade por su cuenta. Indícale el origen sin ruta y deja esta última como está: así, el proveedor OpenAI integrado puede comunicarse con Claude y GPT usando una sola clave.

Settings → Models → Configure providers → OpenAI: Host URL acepta el origen sin más, porque goose añade automáticamente la ruta de solicitud (v1/chat/completions).

Configurar proveedores → OpenAI, o el entorno

# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com
Organization ID   (leave blank)
Project           (leave blank)

# …or as environment variables, which goose CLI reads too:
OPENAI_API_KEY=sk-kn-...
OPENAI_HOST=https://api.kunavo.com

# OPENAI_BASE_PATH is left unset on purpose. Its default is
# v1/chat/completions, which is the path Kunavo serves — that default is
# exactly why Host URL above carries no /v1.

La URL de host no debe llevar /v1. goose documenta OPENAI_BASE_PATH como la «Ruta de solicitud que se añade al host (el valor predeterminado es v1/chat/completions)» e indica a quienes usan un proxy que configuren OPENAI_HOST con «la raíz del proxy, sin ruta final». Esa pareja aclara cómo debe configurarse: el campo lleva el origen y la /v1 se añade mediante la ruta predeterminada. Escribir https://api.kunavo.com/v1 solicita /v1/v1/chat/completions; en la misma página se indica que un 404 se debe a una ruta incorrecta, no a la clave.

Esta configuración se obtuvo de la propia documentación de goose en la fecha indicada abajo. Kunavo no ha ejecutado goose contra su endpoint: ni una sesión, ni un turno transmitido en streaming, ni un ciclo completo de llamadas a herramientas. Una página de configuración publicada no equivale a una prueba, y no debe interpretarse como tal. La curl de abajo es la parte que puedes comprobar en diez segundos; el comportamiento del cliente depende de ti y de goose.

Kunavo no ofrece modelos de embeddings, de texto a voz ni de voz a texto, por lo que este endpoint solo responde a solicitudes de chat completions. Cualquier configuración de goose que transcriba audio o cree un índice vectorial conserva la clave de proveedor que ya tenga: dirigir el proveedor OpenAI aquí no redirige esas llamadas.

¿Aún no tienes una clave? Crea una cuenta de Kunavo, genera una clave (empieza por sk-kn-) y añade crédito desde $10; las llamadas se pagan con ese saldo y las llamadas fallidas no se facturan. El panel se abre entonces en la configuración de goose.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
En goose Desktop: barra lateral → Configuración → Modelos → Configurar proveedores → OpenAI. En la CLI: goose configure → Configurar proveedores → OpenAI.
Completa Clave de API y URL de host. Deja vacíos ID de organización y Proyecto: goose los documenta para el seguimiento del uso y la gestión de recursos en las cuentas propias de OpenAI, y Kunavo no tiene un equivalente que debas poner ahí. Haz clic en Enviar.
Elige el modelo. La nota de goose especifica que goose configure «no permite introducir nombres de modelos personalizados». Si el ID que quieres no aparece en la lista, escríbelo en goose Desktop o configura GOOSE_MODEL en config.yaml, que prevalece sobre el archivo para ese proceso.
Inicia una sesión y asígnale una tarea que requiera modificar un archivo. goose recurre a las llamadas a herramientas para casi todo lo que hace. Su propia página de proveedores advierte que un modelo sin llamadas a herramientas «solo puede completar chats» y que, para usarlo, hay que desactivar las extensiones. Por eso, una primera ejecución que lea y modifique algo te dará más información que un saludo.

Comprobado con Página de goose para configurar un proveedor LLM el 29 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en goose.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

ID de modelo	Entrada / salida de Kunavo	Dónde encaja en goose
`claude-sonnet-5`	$1.40 / $7.00	el modelo de trabajo predeterminado para sesiones que modifican archivos
`claude-opus-5`	$3.50 / $17.50	planificar un cambio en el que un error sería costoso
`claude-haiku-4-5`	$0.70 / $3.50	turnos económicos: triaje, resúmenes y el ciclo que funciona todo el día
`gpt-5-6-sol`	$2.00 / $12.00	una segunda opinión de otra familia, con la misma clave y la misma URL de host

La facturación es por token desde un saldo prepago, sin cuota mensual; consulta facturación. Con contexto repetido —que constituye la mayor parte de lo que envía un editor o cliente de chat—, la caché de indicaciones cambia más la factura que la elección del modelo.

La otra opción: el archivo de proveedor de Kunavo

goose también carga definiciones de proveedores desde archivos JSON en su directorio custom_providers. Un proveedor añadido de este modo tiene su propia entrada en el selector, su propia clave y una lista de modelos guardada, sin ocupar el espacio reservado para OpenAI. Kunavo publica uno en kunavo.com/goose/kunavo.json. Se genera a partir del catálogo activo, así que la lista incluye los modelos que Kunavo ofrece hoy; contiene el nombre de la variable de clave, nunca una clave:

terminal

# macOS / Linux — goose reads every JSON file in this directory
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# The file names the variable; the key itself never goes in the file
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

En Windows, el directorio es %APPDATA%\Block\goose\config\custom_providers\. En goose Desktop, el proveedor aparece en Configurar proveedores como Kunavo; puedes guardar allí la clave en el llavero en lugar de usar una variable de entorno.

Endpoint. El archivo configura base_url con el valor https://api.kunavo.com/v1. La documentación de goose no aclara si este campo requiere la URL base con /v1 o la ruta completa /v1/chat/completions que aparece en su ejemplo; el código fuente lo resuelve: derive_base_path convierte ambas en la misma ruta v1/chat/completions.
Los ID de GPT usan la API Responses. goose envía los ID de modelo que empiezan por gpt-5 o gpt-6 a /v1/responses y todos los demás a /v1/chat/completions. Kunavo ofrece ambos, así que los ID de Claude y GPT del archivo funcionan con una sola clave.
Solo se incluyen los modelos que admiten llamadas a herramientas. goose recurre a las herramientas en casi todos los turnos, así que el archivo omite los modelos de imagen, vídeo y audio aunque se puedan usar con la misma clave.

Se aplica la misma advertencia que en el resto de esta página: esta información procede de la documentación y el código fuente de goose; no se ha ejecutado ninguna prueba. ¿Prefieres crear el proveedor manualmente? En Configurar proveedores → Añadir proveedor personalizado, se solicitan los mismos datos: tipo OpenAI Compatible, URL de API https://api.kunavo.com/v1, tu clave sk-kn- y una lista de modelos separados por comas.

Preguntas frecuentes

¿Cómo configuro goose para usar una API personalizada compatible con OpenAI?

Usa el proveedor OpenAI integrado e indícale un host. En goose Desktop, ve a Settings → Models → Configure providers → OpenAI, donde los campos son API Key, Host URL, Organization ID y Project. En la CLI, ejecuta `goose configure` → Configure Providers → OpenAI; se te pedirán los mismos valores. También puedes usar las variables de entorno OPENAI_API_KEY y OPENAI_HOST. Si necesitas usar varios endpoints a la vez, el flujo Add Custom Provider de goose crea una entrada propia para cada uno en la lista de proveedores.

¿La URL de host de goose debe terminar en /v1?

No; añadirlo hace que la solicitud falle. goose documenta que OPENAI_BASE_PATH es la ruta de solicitud que se añade al host y que su valor predeterminado es v1/chat/completions. También indica a quienes usan un proxy que configuren OPENAI_HOST con la raíz del proxy, sin ruta final. Por tanto, el campo debe llevar el origen sin ruta: https://api.kunavo.com; la ruta predeterminada añade /v1. Un host que termina en /v1 genera una solicitud a /v1/v1/chat/completions, que devuelve 404, no un error de autenticación.

¿Por qué goose devuelve 404 después de configurar un host personalizado?

La propia respuesta de goose indica que un 404 suele significar que la ruta base no coincide con la del endpoint: la mayoría de los proxies usan v1/chat/completions, algunos usan chat/completions sin v1, y el valor que configures debe coincidir. Kunavo usa v1/chat/completions, que es la ruta predeterminada de goose. Por eso, un 404 con Kunavo suele indicar que también escribiste /v1 en el host y ahora la ruta está duplicada. Un 401 que indica que no se proporcionó ninguna clave de API es otro problema; goose documenta que se ignora la clave incluida en config.yaml.

¿Puede goose usar modelos Claude a través de un endpoint compatible con OpenAI?

Sí. El tipo de proveedor identifica un protocolo de comunicación, no un fabricante: goose envía al host configurado una solicitud de chat completion con el formato de OpenAI y transmite directamente el ID del modelo, de modo que el endpoint resuelve los ID de Claude, no goose. Ten en cuenta que goose usa mucho las llamadas a herramientas; la página de proveedores indica que un modelo sin esta función solo puede completar chats y que las extensiones deben estar desactivadas. Por tanto, elige ID compatibles con herramientas.

¿Kunavo ha probado esta configuración?

No. Se consultó la documentación de goose (21 y 29 de septiembre de 2026); de ahí proceden los nombres y el orden de los campos, y la regla de host y ruta. Para el archivo de proveedor se consultó el código fuente de goose (29 de septiembre). Kunavo no ha ejecutado una sesión de goose contra su endpoint y no afirma que en este cliente funcionen el streaming, los ciclos de llamadas a herramientas ni las extensiones. Lo único que puedes comprobar de forma aislada es si el endpoint y la clave funcionan; el comando curl de esta página permite hacerlo.

¿Hay un archivo de proveedor de Kunavo listo para goose?

Sí: https://kunavo.com/goose/kunavo.json. Guárdalo en el directorio custom_providers de goose (~/.config/goose/custom_providers/ en macOS y Linux; %APPDATA%\Block\goose\config\custom_providers\ en Windows), configura KUNAVO_API_KEY y Kunavo aparecerá en la lista de proveedores con los ID de sus modelos ya incluidos. El archivo se genera a partir del catálogo activo, así que solo enumera los modelos que Kunavo ofrece actualmente y no contiene ninguna clave.