Invita a un amigo y consigue 1 mes de Pro gratisCómo funciona

Cómo usar Crush: guía paso a paso del agente de código de Charm

Cómo usar Crush, el agente de código de Charm en la terminal: instalar, elegir proveedor o modelo local, aprobar herramientas, crush run, sesiones y crushrc.

Solviera Teknoloji 7 min de lectura

Para usar Crush, el agente de código de Charm, lo instalas con brew install charmbracelet/tap/crush (o con npm, winget y otros), ejecutas crush dentro de un proyecto, pulsas Ctrl+L para elegir un modelo y pegas una clave de API o inicias sesión, y luego describes la tarea. Crush pregunta antes de ejecutar herramientas y, desde la versión 0.88, su configuración vive en un archivo crushrc en lugar de crush.json.

Esta guía cubre Crush a noviembre de 2026 (versión 0.101): instalación, proveedores y modelos locales, la interfaz, aprobaciones, crush run, sesiones, configuración, archivos de contexto, MCP y costes.

Qué es Crush

Crush es un agente de código para la terminal creado por Charm, el equipo detrás de Bubble Tea y otras herramientas de terminal, y se nota: tiene una de las interfaces más pulidas de su categoría. Funciona con casi cualquier modelo: Anthropic, OpenAI, Gemini, OpenRouter, Groq, xAI, Bedrock, Vertex, Azure, modelos locales y el propio servicio Hyper de Charm. Puedes cambiar de modelo en mitad de una sesión sin perder el contexto.

Crush todavía no ha llegado a la versión 1.0 y publica una versión menor más o menos cada semana, con builds nightly entre medias. Su licencia es FSL-1.1-MIT: el código fuente es público y cada versión pasa a licencia MIT más adelante, pero hoy no es una licencia de código abierto aprobada por la OSI.

Paso 1: instalar

brew install charmbracelet/tap/crush      # macOS and Linux
npm install -g @charmland/crush           # any platform with Node
winget install charmbracelet.crush        # Windows
go install github.com/charmbracelet/crush@latest

También hay paquetes para Arch (yay -S crush), Nix, FreeBSD y Scoop, además de repositorios apt y yum en repo.charm.sh. Crush funciona en macOS, Linux, Windows (PowerShell y WSL) y los BSD.

Paso 2: elegir un modelo

cd my-project
crush

Pulsa Ctrl+L para abrir el selector de modelos, elige un proveedor y pega su clave. Crush también lee claves del entorno, por ejemplo ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY u OPENROUTER_API_KEY. Si prefieres usar una suscripción en vez de una clave, ejecuta crush login con copilot, openai (un plan de ChatGPT), grok o hyper.

Para un modelo local, añade un proveedor en tu configuración (paso 6):

provider add ollama --type ollama --base-url "http://localhost:11434/v1/"

Crush obtiene su lista de modelos de Catwalk, un catálogo comunitario que se actualiza solo; crush models muestra lo que hay disponible y crush update-providers lo refresca.

Paso 3: trabajar en una sesión

Describe la tarea con tus palabras. Las teclas que conviene aprender primero:

  • Ctrl+P (o /) abre la paleta de comandos: resumir la sesión, inicializar el proyecto, activar o desactivar servidores MCP y skills, cambiar el tema.
  • Ctrl+L cambia de modelo; Ctrl+N empieza una sesión nueva y Ctrl+S lista las sesiones.
  • @ menciona un archivo; Ctrl+F añade un archivo o una imagen; Ctrl+V pega una imagen.
  • Shift+Tab recorre los modos, incluido el modo Plan, en el que Crush define los pasos antes de editar.
  • Ctrl+O abre tu editor para escribir un mensaje largo; Ctrl+G muestra la ayuda; Ctrl+C sale.

Paso 4: aprobaciones y modo yolo

Crush pregunta antes de cada llamada a una herramienta. En el diálogo, a la permite una vez, s permite esa herramienta durante el resto de la sesión, d la rechaza y t muestra el diff. Los comandos de solo lectura como ls o git status se ejecutan sin preguntar.

Para que deje de preguntarte por herramientas de confianza, permítelas en la configuración; para ocultar una herramienta por completo, deniégala:

permissions allow view ls grep edit
permissions deny bash

crush --yolo (o -y, o Ctrl+Y dentro de una sesión) se salta las confirmaciones, pero sigue bloqueando los comandos que Crush considera peligrosos. -yy activa el modo sysadmin, que también los permite. Reserva ambos para contenedores y máquinas desechables.

Paso 5: crush run para tareas puntuales

crush run "add a unit test for the price formatter"
git diff | crush run "review this diff for bugs"
cat README.md | crush run "tighten the wording" > README.new.md

-m elige el modelo (provider/model), -q oculta el indicador de progreso y -s <id> o -C continúa una sesión. crush run no tiene salida JSON, así que, si necesitas resultados estructurados, pide el formato en el prompt y compruébalo.

Paso 6: crushrc y configuración

Desde la versión 0.88, Crush lee su configuración de un archivo crushrc: un script Bash con comandos de Crush que ejecuta el propio intérprete de Crush, para que se comporte igual en Windows. Busca .crushrc o crushrc en el proyecto y ~/.config/crush/crushrc a nivel global, y combina lo que encuentra; si hay conflicto, gana el proyecto. Un ejemplo pequeño:

model large anthropic/claude-sonnet-5-5
model small anthropic/claude-haiku-5-5
permissions allow view ls grep
mcp add docs --type http --url https://example.com/mcp
lsp add go --command gopls

crush.json y .crush.json siguen funcionando, pero están obsoletos y no reciben funciones nuevas. crush dirs muestra dónde guarda Crush su configuración y sus datos.

Una advertencia: un crushrc es código. Todo lo que esté dentro de $(...) se ejecuta al arrancar Crush, así que lee el archivo antes de abrir Crush en un repositorio que no conoces.

Paso 7: AGENTS.md, MCP y LSP

Archivos de contexto. Crush lee AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules y .github/copilot-instructions.md sin configurar nada, además de ~/.config/crush/CRUSH.md para todos los proyectos. Initialize Project en la paleta de comandos examina el repositorio y escribe un AGENTS.md. Nuestra guía de CLAUDE.md y AGENTS.md explica qué poner en él.

MCP. Crush admite servidores stdio, HTTP y SSE, incluido el inicio de sesión con OAuth. Añádelos con mcp add en crushrc y actívalos o desactívalos desde la paleta.

LSP. Los servidores de lenguaje le dan a Crush los mismos diagnósticos que ve tu editor. Añade uno con lsp add o deja que option auto-lsp los configure.

Lo que cuesta Crush (a noviembre de 2026)

OpciónPrecioNotas
CrushGratisCon tus propias claves o modelos locales
Hyper de pago por usoDesde 5 $ prepagoModelos de pesos abiertos alojados por Charm
Planes mensuales de HyperDe 10 $ a 200 $ al mesCréditos semanales con una ventana móvil de 5 horas
Tu propia claveEl precio de tu proveedorAnthropic, OpenAI, Gemini, OpenRouter y más

Crush envía métricas de uso seudónimas por defecto; define CRUSH_DISABLE_METRICS=1 o DO_NOT_TRACK=1 para desactivarlas.

Errores habituales

  • Seguir guías de crush.json. La mayoría de los tutoriales anteriores a agosto de 2026 solo muestran JSON. Sigue funcionando, pero las opciones nuevas llegan a crushrc.
  • Yolo cambió en la v0.100. --yolo ahora bloquea los comandos peligrosos en lugar de preguntar; los scripts que dependían del comportamiento anterior pueden necesitar -yy.
  • Trailers en los commits. Crush añade por defecto un trailer Assisted-by a los commits. Cámbialo con option attribution-trailer-style.
  • Portapapeles en Linux. Copiar y pegar requiere wl-copy o xclip/xsel.
  • Dónde están los logs. crush logs --tail 50 muestra qué ha fallado; los logs están en la carpeta .crush del proyecto.

Ejecutar Crush junto a otras CLI en AgentVera

Si Crush es el único agente que usas, puede que su propia interfaz te baste. La cosa se complica cuando Crush corre junto a Claude Code, Codex o Gemini CLI en el mismo proyecto. AgentVera es una app de escritorio que ejecuta estas CLI una al lado de otra en terminales reales, con tus propias instalaciones y claves. El soporte de Crush funciona así:

  • Una sesión por agente. AgentVera encuentra la sesión que crea Crush mediante crush session list --json y la reabre con --session <id> en los siguientes arranques, así que la conversación sobrevive a un reinicio de la app.
  • Una cuenta por agente. Cada cuenta de Crush en Ajustes → Cuentas tiene su propia carpeta de datos y su propio crush login, y puedes añadir claves de Anthropic, OpenAI, OpenRouter o Gemini.
  • MCP y conflictos. Los servidores del gestor de MCP de AgentVera llegan a Crush a través de su configuración, y AgentVera añade su propio hook para ver qué archivos toca cada agente.
  • Paneles y revisión. Ejecuta Crush en la cuadrícula del workspace junto a otros agentes y revisa sus cambios con la revisión de código.

El plan gratuito ejecuta 2 agentes a la vez e incluye MCP, Git, Docker, SSH, revisión de código y ahorro de tokens. Pro cuesta 9,99 $ al mes y no tiene límite de agentes; si nunca has tenido una prueba, tu primer inicio de sesión en la app activa Pro durante 7 días sin tarjeta. Para probarlo, descarga AgentVera.

Conclusión

Empezar con Crush lleva dos pasos: instalarlo y ejecutar crush, y luego elegir un modelo con Ctrl+L. A partir de ahí, la configuración que importa está en crushrc: qué herramientas pueden ejecutarse sin preguntar, qué modelos usar para tareas grandes y pequeñas, y qué servidores MCP y de lenguaje cargar. Ten un AGENTS.md en el proyecto y Crush, como la mayoría de los agentes, lo seguirá.

Fuentes: Crush en GitHub, documentación de configuración, versiones, licencia, Hyper.

Preguntas frecuentes

¿Crush es gratis?

Usar Crush no cuesta nada: pones tus propias claves de API o un modelo local. Charm también vende Hyper, un proveedor alojado de modelos de pesos abiertos, con planes mensuales de 10 $ a 200 $ o crédito prepago desde 5 $ a noviembre de 2026. Crush usa la licencia FSL-1.1-MIT, una licencia de código disponible cuyas versiones pasan a MIT más adelante.

¿Crush funciona con modelos locales?

Sí. Añade un proveedor de Ollama, LM Studio, llama.cpp o LiteLLM en crushrc, por ejemplo provider add ollama --type ollama --base-url "http://localhost:11434/v1/", y Crush descubre sus modelos.

¿Cómo retomo una sesión de Crush?

crush -C (o --continue) reabre la sesión más reciente del proyecto, y crush -s <id> reabre una concreta. crush session list las muestra, y Crush imprime el comando para retomarla cuando sales.

¿Crush lee CLAUDE.md o AGENTS.md?

Ambos. Crush lee AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules y .github/copilot-instructions.md si existen. Initialize Project en la paleta de comandos te escribe un AGENTS.md.

¿Qué hace crush --yolo?

Se salta las confirmaciones, pero sigue bloqueando los comandos que Crush considera peligrosos. -yy (modo sysadmin) también los permite. Reserva ambos para entornos desechables.

Reúne a tus agentes en un mismo escritorio.

Descarga AgentVera gratis; tus CLI instaladas ya están listas.

Más artículos