Crush

La configuración de Crush es Bash — un único `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"` en un crushrc coloca el agente de terminal de Charm sobre Claude y GPT.

# A crushrc is Bash, not a settings file. Everything here is executed.
provider add kunavo \
  --type openai-compat \
  --base-url "https://api.kunavo.com/v1" \
  --api-key "${KUNAVO_API_KEY:?set KUNAVO_API_KEY}"

model add kunavo/claude-sonnet-5 \
  --name "Claude Sonnet 5" \
  --context-window 1000000 \
  --default-max-tokens 32000 \
  --price-input 1.4 \
  --price-output 7

model add kunavo/claude-haiku-4-5 \
  --name "Claude Haiku 4.5" \
  --context-window 200000 \
  --default-max-tokens 16000 \
  --price-input 0.7 \
  --price-output 3.5

model large kunavo/claude-sonnet-5
model small kunavo/claude-haiku-4-5

Paso a paso

1. Crea una clave en /app/keys y cópiala: se muestra una sola vez. Expórtala como KUNAVO_API_KEY o léela desde un gestor de contraseñas directamente en la configuración.
2. Coloca el bloque anterior en ~/.config/crush/crushrc. Crush lee ./.crushrc, luego ./crushrc y después el archivo global, así que un proyecto puede prevalecer sobre la configuración de la máquina; además, un repositorio que hayas clonado puede incluir uno.
3. Inicia crush y pulsa ctrl+l para abrir el selector de modelos. Las líneas model large y model small anteriores ya fijan ambas opciones, así que el selector sirve para cambiar de modelo y no para configurarlo.
4. Si prefieres no registrar los ids manualmente: el descubrimiento automático se ejecuta cuando la lista de modelos de un proveedor openai-compat está vacía o cuando pasas --discover-models true. Kunavo responde a GET /v1/models, así que la lista se completa automáticamente y tus propios campos model add prevalecen en caso de conflicto.
5. Ejecuta una tarea acotada y luego consulta el cargo que tu cuenta registró en /app/billing. La cifra que aparece en la terminal es un cálculo basado en los números de --price-* que introdujiste; el registro de cargos es la factura.

Comprobado con La sección Custom Providers de Crush el 21 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 Crush.

# 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.