Qué es Crush
Crush es el agente de programación de código abierto de Charm para la terminal. Lee su configuración de un archivo crushrc, que es Bash con comandos propios de Crush. Esta configuración añade Capriole AI como un único proveedor compatible con OpenAI.
Requisitos previos
Antes de empezar, asegúrate de tener:
Instalación
Instala Crush con Homebrew:
O instálalo con npm:
Verifica la instalación:
Configuración
Validación de modelos
Crush 0.98.1 supera una prueba de lectura de archivos, escritura de archivos y respuesta final a través de Capriole AI con todos los modelos de la sección Modelos compatibles, usando la configuración siguiente.
Crea o actualiza ~/.config/crush/crushrc:
Qué hace cada ajuste:
--type openai-compat envía todos los modelos a Chat Completions. Capriole AI sirve todos estos modelos en Chat Completions.--api-key "$CAPRIOLE_AI_API_KEY" lee tu clave del entorno cuando Crush carga el archivo, y Crush la envía como token Bearer.--discover-models false limita la lista a los modelos que añades.model large es el modelo principal de programación. model small es el modelo para tareas ligeras, como los títulos de sesión.
Ejecutar Crush
Define tu clave API y luego inicia Crush desde el directorio de tu proyecto:
Pulsa Ctrl+L para cambiar de modelo. Para una ejecución no interactiva, usa crush run:
Modelos compatibles
Las referencias de modelo usan el formato capriole/<model-id>.
openai-latest y claude-latest siempre apuntan a nuestro modelo insignia más reciente de cada familia.
Solución de problemas
¿Por qué Crush devuelve un error de autenticación?
Exporta CAPRIOLE_AI_API_KEY antes de iniciar Crush. Crush lee la variable cuando carga crushrc.
¿Por qué un modelo Claude falla con Unsupported chat model_key?
En Chat Completions, usa los IDs de Claude con el prefijo anthropic/, como anthropic/claude-opus-5-5. Los IDs sin prefijo, como claude-opus-5-5, son para Anthropic Messages.
¿Por qué no se aplican los cambios de configuración?
Un archivo .crushrc o crushrc en el directorio del proyecto tiene prioridad sobre ~/.config/crush/crushrc. Comprueba si existe uno y luego reinicia Crush.
Notas
crushrc se ejecuta como un script de shell. No pegues tu clave en él.- Para añadir otro modelo de Capriole AI, añade otra línea
model add. GET https://api.caprioletech.com/v1/models devuelve la lista de todos los IDs de modelo.
- Referencias oficiales: Crush y configuración de Crush.
Última modificación el 20 de octubre de 2026
