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

URL: https://agentvera.dev/es/blog/how-to-use-crush/ · Publicado: 2026-11-17

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.

**En resumen:**

- Instala con brew install charmbracelet/tap/crush, npm install -g @charmland/crush o winget install charmbracelet.crush, ejecuta crush en un proyecto, pulsa Ctrl+L para elegir modelo y pega una clave o inicia sesión.
- Crush pregunta antes de llamar a herramientas y te deja permitir una para toda la sesión. crush run sirve para tareas puntuales y entrada por pipe; crush -C o crush -s <id> retoma una sesión.
- Desde la v0.88 la configuración vive en un archivo crushrc (Bash con comandos de Crush); crush.json sigue funcionando, pero está obsoleto. Crush lee AGENTS.md, CRUSH.md y CLAUDE.md por su cuenta.

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](https://github.com/charmbracelet "Charm en GitHub"), 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

```bash
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

```bash
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):

```bash
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:

```bash
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

```bash
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:

```bash
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](/es/blog/claude-md-agents-md/ "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ón | Precio | Notas |
|---|---|---|
| Crush | Gratis | Con tus propias claves o modelos locales |
| Hyper de pago por uso | Desde 5 $ prepago | Modelos de pesos abiertos alojados por Charm |
| Planes mensuales de Hyper | De 10 $ a 200 $ al mes | Créditos semanales con una ventana móvil de 5 horas |
| Tu propia clave | El precio de tu proveedor | Anthropic, 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/ "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](/es/agents/crush/ "Crush en AgentVera") 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](/es/features/mcp-manager/ "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](/es/features/workspace/ "Workspace") junto a otros agentes y revisa sus cambios con la [revisión de código](/es/features/code-review/ "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](/es/download/ "Descargar 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](https://github.com/charmbracelet/crush "README de Crush"), [documentación de configuración](https://github.com/charmbracelet/crush/tree/main/docs/config "Configuración de Crush"), [versiones](https://github.com/charmbracelet/crush/releases "Versiones de Crush"), [licencia](https://github.com/charmbracelet/crush/blob/main/LICENSE.md "Licencia de Crush"), [Hyper](https://hyper.charm.land "Hyper de Charm").

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

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito ejecuta 2 agentes a la vez. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/
