Crush

Agente en el terminal · OpenAI Chat, Anthropic Messages

Guía completa

Formato	Dónde configurar
OpenAI Chat, Anthropic Messages	crushrc (configuración Bash): ./.crushrc, ./crushrc o ~/.config/crush/crushrc; el formato antiguo crush.json está obsoleto, pero sigue funcionando

Configuración

Copia la configuración y sustituye sk-... por tu clave del panel de control de Ailoot. Es mejor guardar la clave en la variable de entorno AILOOT_API_KEY si la aplicación lo permite.

Antes de iniciar, consulte GET /v1/models con su clave de Ailoot. Elija un ID exacto de modelo cuyos métodos incluyan POST /v1/chat/completions, POST /v1/messages y úselo en la configuración. Para agentes, compruebe también las herramientas y funciones que requiere su versión del cliente.

~/.config/crush/crushrc

export AILOOT_API_KEY="sk-..."
provider add ailoot --type openai-compat \
  --base-url "https://api.ailoot.ai/v1" \
  --api-key "$AILOOT_API_KEY"

model add ailoot/deepseek-v4-pro \
  --name "DeepSeek V4 Pro (Ailoot)" \
  --context-window 1000000 \
  --default-max-tokens 32000

# formato Anthropic para Claude: URL sin /v1
provider add ailoot-claude --type anthropic \
  --base-url "https://api.ailoot.ai" \
  --api-key "$AILOOT_API_KEY"

model add ailoot-claude/claude-sonnet-5-5 \
  --name "Claude Sonnet 5.5 (Ailoot)" \
  --context-window 1000000 \
  --default-max-tokens 64000 \
  --can-reason true --supports-images false

Esta configuración lee la clave de la variable AILOOT_API_KEY. Defínela antes de iniciar la aplicación:

export AILOOT_API_KEY="sk-..."   # añade a ~/.zshrc o ~/.bashrc

setx AILOOT_API_KEY "sk-..."   # después reinicia el terminal

Modelo de ejemplo: deepseek-v4-pro. Para cualquier otro modelo, consulta el catálogo y comprueba que tenga el formato necesario.

Qué debes saber

El tipo openai-compat utiliza OpenAI Chat, con una URL que incluye /v1. El tipo anthropic utiliza Messages, con una URL sin /v1: Crush la pasa a anthropic-sdk-go, que añade /v1/messages automáticamente. El ejemplo del README de Crush con /v1 daría lugar a /v1/v1/messages y un error 404. La clave se envía en la cabecera x-api-key y Ailoot la admite. Si la lista de modelos está vacía, el proveedor openai-compat la obtiene de /v1/models. crushrc se ejecuta como código: no inicies Crush en carpetas ajenas que contengan ese archivo. En este ejemplo, Claude tiene supports-images = false: la instantánea del catálogo de 2026-09-30 declara solo texto para el formato Messages elegido. Si tu versión de Crush admite esa opción, actívala solo para un modelo cuya ficha actual declare entrada image en el formato de API elegido; la opción del cliente no añade por sí sola soporte de imágenes al modelo.

Comprobación

Para el formato OpenAI, la URL es https://api.ailoot.ai/v1 (o la ruta completa, si la aplicación pide la URL completa).
Para el formato Anthropic, la URL es https://api.ailoot.ai sin /v1.
Haz una pregunta corta. Si recibes un error, consulta el código y el Request ID y compáralos con la página Errores y límites.
Un 404 justo después de configurar casi siempre indica una URL incorrecta: sobra o falta /v1.
402: no hay suficiente saldo para la reserva. Los agentes reservan más que un chat: por qué.

Documentación de la aplicación: https://github.com/charmbracelet/crush#custom-providers

¿Tienes alguna pregunta? Envíanos el Request ID y una descripción; te ayudaremos a resolverla.Contactar con soporte