La Bóveda de Manu Lizama
Guía · Claude Code

4 vicios de Claude Code y cómo arreglarlos

Cuatro herramientas para cuatro malos hábitos de los agentes de código: Ponytail, OmniRoute, Graphify y Agent Skills de Addy Osmani, con sus comandos oficiales y sus límites.

Nivel IntermedioTiempo 25 minCoste GratisWindows y Mac
Una guía de Manu Lizama · @manulizamaes
  1. 01Identifica tu vicioCuatro síntomas, cuatro herramientas. Empieza por el que más te cuesta.
  2. 02Instala solo eseCada sección trae los comandos del repositorio oficial.
  3. 03Prueba en un proyectoComprueba que te ayuda antes de añadir la siguiente.
01 / 06

Los cuatro vicios

No son fallos de Claude Code en sí: son hábitos que aparecen cuando no le pones límites.

El vicioLo que notasEl arreglo
Escribe de másPides algo sencillo y te llena el proyecto de códigoPonytail
Se queda sin cuotaLlegas al límite de un proveedor y se para tu trabajoOmniRoute
Busca a ciegasRastrea archivos para responder dudas sobre tu proyectoGraphify
Va con prisasSe salta la especificación, las pruebas o la revisiónAgent Skills

Son proyectos de terceros, no de Anthropic. Los plugins y las herramientas que instales se ejecutan en tu ordenador: descárgalos solo de sus repositorios oficiales.

02 / 06

Vicio 1: escribe de más. Ponytail

Antes de escribir código, le obliga a comprobar si hace falta o si ya existe algo que lo resuelva.

Necesitas tener node en el PATH. Pega estos dos comandos dentro de Claude Code, por separado:

Claude Code
/plugin marketplace add DietrichGebert/ponytail
Claude Code
/plugin install ponytail@ponytail

Queda activo en cada sesión. Estos son los comandos principales:

ComandoQué hace
/ponytail lite, full o ultraCambia la intensidad.
/ponytail offLo apaga.
/ponytail-reviewRevisa tus cambios: fallos, seguridad, pruebas y qué sobra.
/ponytail-auditHace la misma revisión de todo el repositorio.
/ponytail-helpMuestra la ayuda rápida.

Su autor publica estas cifras de Ponytail 5: un 53 % menos de código, un 41 % menos de tiempo, un 26 % menos de coste y un 45 % menos de tokens, en 39 tareas con Opus 5.5 y 5 pasadas cada una. Son pruebas del propio proyecto, no una medición independiente.

Con Claude Code 2.1.290 o superior muestra una banda sobre el cuadro de texto con coste y tokens. Se oculta con /ponytail band. Su regla es no recortar nunca validación, gestión de errores, seguridad ni accesibilidad.

03 / 06

Vicio 2: se queda sin cuota. OmniRoute

Pasarela local que reparte tus peticiones entre las cuentas que conectes y cambia de proveedor si uno falla.

Necesitas Node.js 22 (22.22.2 o superior) o 24.

Terminal
npm install -g omniroute
omniroute
  1. Abre http://localhost:20128.
  2. En Providers, conecta una cuenta o una clave.
  3. Configura Claude Code con este comando:
Terminal
omniroute configure claude

No crea cuota de la nada. Cada proveedor mantiene sus propios límites y condiciones, algunos piden tarjeta o aprobación, y una instalación nueva puede no tener rutas disponibles. Si eliges otro modelo, responde ese modelo, no Claude.

Si quieres más detalle, lo explico también en 5 herramientas para Claude Code.

04 / 06

Vicio 3: busca a ciegas. Graphify

Convierte tu proyecto en un mapa que Claude puede consultar en vez de buscar archivo por archivo.

Necesitas Python 3.10 o superior y uv (o pipx).

Terminal
uv tool install graphifyy
graphify install

El paquete se escribe graphifyy, con dos y griegas. Su autor avisa de que otros paquetes graphify de PyPI no son suyos. El comando sí es graphify.

Dentro de Claude Code, crea el mapa de la carpeta actual:

Claude Code
/graphify .

Para que Claude consulte el mapa antes de buscar, ejecuta esto una vez en el proyecto:

Terminal
graphify claude install

Ya puedes hacerle preguntas:

Claude Code
/graphify query "what connects auth to the database?"
  • Código: se analiza en tu ordenador, sin IA y sin enviar nada fuera.
  • Documentos, PDF e imágenes: pasan por el modelo de tu asistente, así que gastan uso.
  • Vídeo y audio: se transcriben en local.
  • Para quitarlo: graphify uninstall. Con --purge borra también graphify-out/.

Hay una versión de pago en la nube, Graphify Cloud, pero para todo lo anterior no la necesitas.

05 / 06

Vicio 4: va con prisas. Agent Skills

25 skills de Addy Osmani que llevan al agente por todas las fases: definir, planificar, construir, probar, revisar y publicar.

Pega estos dos comandos dentro de Claude Code, por separado:

Claude Code
/plugin marketplace add addyosmani/agent-skills
Claude Code
/plugin install agent-skills@addy-agent-skills

Si falla por SSH, usa la dirección HTTPS en el primer comando:

Claude Code
/plugin marketplace add https://github.com/addyosmani/agent-skills.git

Trae 9 comandos:

ComandoPara qué
/specDefinir qué vas a construir antes de escribir código.
/planDividirlo en tareas pequeñas.
/buildConstruirlo por partes.
/testDemostrar que funciona.
/constraintsFijar el nivel de calidad.
/agent-skills:reviewRevisar antes de fusionar. Lleva prefijo porque /review ya existe.
/webperfAuditar el rendimiento web.
/code-simplifySimplificar el código.
/shipPublicar.

Las skills también se activan solas según lo que estés haciendo. Por ejemplo, al diseñar una API o al construir una interfaz.

06 / 06

Cómo probarlas sin liarte

  1. Elige un vicio, el que más tiempo o dinero te cuesta.
  2. Instala solo su herramienta.
  3. Pruébala en un proyecto de verdad durante unos días.
  4. Si te ayuda, pasa a la siguiente. Si no, desinstálala.

Así, si algo cambia, sabrás qué herramienta ha sido.

Lo que pasaSolución
El plugin de Ponytail no arrancaComprueba que node está en el PATH y abre una sesión nueva.
No encuentra el comando graphifyEjecuta uv tool update-shell y abre otra terminal.
/plugin install de Agent Skills da error de SSHUsa la dirección HTTPS de su sección.
OmniRoute no encuentra rutaConecta un proveedor: una instalación nueva puede no tener ninguna.
Si un comando no coincide, manda el repositorio oficial de cada herramienta.

¿Te ha servido? Recibe la siguiente antes que nadie

Una guía nueva cada semana, directa a tu correo.

Uso tu correo solo para enviarte guías y novedades. Puedes darte de baja cuando quieras.

Más de la Bóveda

  • 5 herramientas para Claude Code · Modelos, memoria, ahorro y mejora continua

    GuíaIntermedio

    OmniRoute, Claude Mem, Headroom, Claude Code Setup y Task Observer: qué hace cada una, cómo se instala y qué debes mirar antes de dejarla activa.

    30 min Gratis Windows · Mac
  • Arena Skill · Cuando Claude no da con la respuesta, que compitan

    GuíaIntermedio

    Una skill gratuita de Claude Code que da la misma tarea a 100 subagentes con estrategias distintas y los enfrenta en un torneo hasta que queda una sola respuesta. Con modo rápido de 16 para el día a día.

    5 min Gratis (gasta uso de tu plan) Windows · Mac
  • Edita tus vídeos con Claude · Cowork para ordenar, skills para editar

    GuíaIntermedio

    Una carpeta con material, referencias y resultados, Claude Cowork para organizar el trabajo y skills reales para subtítulos, animaciones, audio y análisis de vídeos. Le das 5 vídeos editados y aprende tu estilo.

    45 min Plan de Claude + ElevenLabs Windows · Mac

Ver toda la Bóveda →

Sígueme en Instagram @manulizamaesCada reel trae su guía aquí.
Manu Lizama

Bienvenido a la Bóveda

Guías, repos y prompts de IA para tu negocio, cada semana

Nueva guíaArena Skill: 100 Claudes compitiendo

Recibe la próxima guía antes que nadie

Uso tu correo solo para enviarte guías y novedades. Puedes darte de baja cuando quieras.