¿Qué es Claude Code?

Claude Code es una herramienta de interfaz de línea de comandos (CLI) desarrollada por la empresa Anthropic y tiene la capacidad de interactuar con ficheros del sistema.

A diferencia de un chat convencional como puede ser ChatGPT o el mismo Claude en la web, Claude Code, al ser un agente de IA, cuando le pides una tarea no para hasta que la tiene finalizada o te quedas sin tokens. Con Claude Code ya no tienes que pedir una cosa, copiar código, pegar y volver a pedir, sino que el mismo agente se encarga de tocar o crear todos los ficheros necesarios hasta conseguir el objetivo solicitado.

Mi experiencia con Claude Code

Después de tanto hype con Claude Code, decidí comprobar por mí mismo si todo el ruido en las redes sociales y en la comunidad era justificado. Y debo admitir que funciona bastante bien, la verdad, es increíble. Si te enseñan toda esta magia hace 10 años, uno lo habría flipado en colorinchis.

Ahora bien, no todo es tan bonito: Claude Code también mete la gamba, y bastante. Se tiene que iterar unas cuantas veces sobre lo que se está haciendo porque la va liando, pero en resumen, hace un trabajo bastante decente. También debo decir que mis prompts son muy malos y los más simples del mundo, pero si le das unos prompts mejor construidos, la probabilidad de error se reduce drásticamente.

En conclusión: todo el hype hasta ahora es totalmente merecido.

---

Cómo instalar Claude Code

Antes de nada, para instalarlo necesitas Node.js 18+ y una cuenta en Anthropic con créditos (o una suscripción). La instalación es global con npm:

npm install -g @anthropic-ai/claude-code

Una vez instalado, te vas al directorio de tu proyecto y ejecutas:

cd tu-proyecto
claude

La primera vez te va a pedir que te autentiques con tu cuenta de Anthropic. Sigues las instrucciones, aceptas permisos y listo.

---

Comandos básicos que deberías conocer

Claude Code tiene una serie de comandos con barra / que conviene tener a mano:

Un truco que uso bastante: cuando llevas un rato largo y notas que las respuestas se vuelven raras o repite cosas, dale un /compact para que resuma el contexto y siga fresquito.

---

El fichero CLAUDE.md: la clave de todo

Si hay algo que marca la diferencia entre que Claude Code haga un trabajo decente o un trabajo bueno de verdad, es el fichero CLAUDE.md. Este archivo va en la raíz de tu proyecto y le dice a Claude cómo tiene que comportarse en ese repositorio.

Puedes meterle cosas como:

• Qué stack tecnológico usas
• Convenciones de código (nombres de variables, estructura de carpetas, etc.)
• Cómo se ejecutan los tests
• Qué NO debe tocar (ficheros de configuración sensibles, etc.)
• Patrones de código que prefieres

Un ejemplo básico:

# CLAUDE.md

## Proyecto
Blog personal con Astro + Tailwind CSS.

## Convenciones
- Componentes en src/components/
- Posts en src/content/posts/
- Estilos solo con Tailwind, nada de CSS custom
- Idioma del código: inglés. Idioma del contenido: español.

## Comandos
- `npm run dev` para desarrollo
- `npm run build` para compilar

## Reglas
- No tocar archivos en node_modules/ ni dist/
- No modificar el package.json sin preguntar
- Preferir editar archivos existentes antes de crear nuevos

Cuanto más detallado sea tu CLAUDE.md, menos veces te va a pedir confirmación y menos errores va a cometer. Es una inversión de tiempo que se paga sola.

---

Hooks: automatiza lo repetitivo

Los hooks son comandos de shell que se ejecutan automáticamente en respuesta a eventos de Claude Code. Por ejemplo, puedes configurar que cada vez que edite un fichero .ts, se ejecute el linter automáticamente. O que antes de crear un commit, pase los tests.

Se configuran en el archivo .claude/settings.json de tu proyecto:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "npm run lint:fix -- $CLAUDE_FILE_PATH"
      }
    ]
  }
}

Esto es muy útil para mantener la calidad del código sin tener que estar vigilando todo el rato. Claude edita un fichero, se lanza el linter automáticamente, y si hay errores, Claude los ve en el output y los corrige.

---

Cuánto cuesta

Actualmente utilizo una cuenta personal de unos 21€ al mes, con IVA incluído. Es una suscripción mensual, por lo que puedo darme de baja en cualquier momento. Por otro lado existen opciones superiores como el plan MAX (desde 90€ al mes más IVA), además de las modalidades TEAM y ENTERPRISE.

Aunque estés suscrito puedes añadir saldo para adquirir tokens extra, ajenos a los limites que Claude Code plantea en su suscripción estándar. El plan base incluye una cuota de uso limitada por horas y semanas. Una vez superado este límite, hay que esperar a la recarga automática o recurrir al saldo adicional.

---

Consejos para usar Claude Code según sus creadores

El otro día por X, antes llamado Twitter, vi un hilo del que dice ser el creador de Claude Code, Boris Cherny. Este buen señor quiso compartir algunos consejos para usar la herramienta, así que vamos a ver todos juntitos que se cuenta.

1. Trabaja más en paralelo

Boris sugiere que tengamos activos de 3 a 5 git worktrees a la vez, cada uno ejecutando su propia sesión de Claude Code en paralelo. Asegura que es el mayor salto de productividad posible y el consejo estrella del equipo. Boris dice que él, personalmente, usa múltiples checkouts de git, pero la mayoría del equipo prefiere los worktrees.

Para el que no conozca los worktrees, es una feature de git que te permite tener varios checkouts del mismo repo en directorios diferentes, sin tener que clonar el repo varias veces:

# Crear un worktree para una feature
git worktree add ../mi-proyecto-feature-login feature/login

# Listar los worktrees activos
git worktree list

# Eliminar un worktree cuando termines
git worktree remove ../mi-proyecto-feature-login

2. Inicia las tareas complejas en modo “Plan”

Claude Code tiene un modo plan que es más potente para analizar grandes tareas. Este tip de Boris dice que intentemos dedicar nuestra energía al diseño del plan para que la IA pueda ejecutar la implementación de one shot.

• Doble validación: Hay personas que usan Claude Code para redactar el plan y luego abren una segunda sesión para que otro agente lo revise con un rol de Staff Engineer.
• Pivotar rápido: Si algo sale mal, vuelve inmediatamente al modo plan y replantea la estrategia.
• Verificación: Recomiendan pedirle explícitamente que entre en modo plan para las etapas de verificación, no solo para la fase de construcción.

3. Invierte tiempo y tokens en tu fichero CLAUDE.md

CLAUDE.md es un archivo de configuración de contexto en el que detallamos instrucciones personalizadas se cómo debe actuar en ese repositorio. Por ello, sugieren que es muy recomendable que, después de cada corrección, finalicemos con la instrucción: “Actualiza tu CLAUDE.md para que no vuelvas a cometer ese error”. Claude Code es muy bueno escribiendo reglas para sí mismo.

Perfeccionar el fichero CLAUDE.md reduce la tasa de errores considerablemente.

4. Crea tus propias skills y súbelas a Git

Permite crear funciones personalizadas que luego puedes invocar con la barra para realizar tareas repetitivas (por ejemplo, /removeduplicatecode).

• Regla de repetición: Si haces algo más de una vez al día, conviértelo en una skill.
• Limpieza de código: Crea un comando /techdebt para localizar código duplicado al final de cada sesión.
• Contexto unificado: Configura un comando que sincronice los últimos 7 días de Slack, Google Drive y GitHub en un solo texto (context dump).

5. Solución de bugs de forma autónoma

Así es como lo hace el equipo de Anthropic:

• Integración con Slack: Pega el hilo donde se reporta el bug y simplemente di: “arréglalo”.
• Autonomía en CI: Dile: “Ve y arregla los tests de CI que están fallando”. Él encontrará el camino.
• Logs de Docker: Apunta a Claude hacia los logs de Docker para solucionar problemas en sistemas distribuidos.

6. Sube de nivel tus prompts

• Desafía a Claude: Dile: “Cuestiona estos cambios y no crees una PR hasta que supere tu examen”.
• Borrón y cuenta nueva: Después de una solución mediocre, dile: “Sabiendo todo lo que sabes ahora, descarta esto e implementa la solución elegante”. La segunda iteración suele ser mucho más limpia.
• Especificaciones detalladas: Escribe especificaciones minuciosas para eliminar cualquier ambigüedad.

7. Configuración de la terminal y el entorno

• Ghostty: Al equipo le encanta este terminal por su renderizado sincronizado y soporte de color.
• Malabares con Claude: Usa /statusline para personalizar tu barra de estado y ver siempre el uso de contexto.
• Dictado por voz: Hablas tres veces más rápido de lo que escribes y tus prompts acaban siendo mucho más detallados.

8. Usa subagentes

Este punto se enfoca en escalar la potencia delegando tareas:

• Mayor potencia: Añade la frase “use subagents” para que dedique más recursos de computación al problema.
• Limpieza de contexto: Delega tareas individuales a subagentes para mantener la ventana principal sin ruido.

9. Claude para datos y analítica

• Consultas al vuelo: Pídele que use la CLI de bq (BigQuery) para extraer y analizar métricas en tiempo real. Boris asegura que no ha escrito una sola consulta SQL a mano desde hace más de 6 meses.

10. Aprender con Claude

Boris comenta cómo usar la herramienta como tutor personal:

• Entiende el “porqué”: Activa el estilo Explanatory en /config para que explique las razones técnicas de cada cambio.
• Presentaciones y diagramas: Pídele que genere presentaciones en HTML para explicar código o que dibuje diagramas en ASCII para visualizar estructuras de la base de código.

---

Errores comunes que he visto (y cometido)

Después de un tiempo usando Claude Code, hay errores que se repiten bastante:

• No revisar lo que hace: Que sea autónomo no significa que debas aceptar todo a ciegas. Revisa los cambios antes de hacer commit. He visto cómo borra código que necesitaba “porque pensó que sobraba”.
• Prompts demasiado vagos: “Arregla esto” no es un buen prompt. “El test de UserService falla porque el mock de la base de datos no devuelve el formato correcto, revisa el fichero tests/UserServiceTest.php” es un buen prompt.
• Sesiones larguísimas sin compact: Después de mucho contexto acumulado, empieza a olvidar cosas del principio de la conversación y hace cosas raras. Un /compact a tiempo salva muchos disgustos.
• No tener CLAUDE.md: Sin este fichero, Claude Code es un tío con talento pero sin instrucciones. Hará cosas, pero a su manera, no a la tuya.
• Ignorar el coste: Es fácil dejarse llevar y cuando quieres darte cuenta llevas 15 dólares en una tarde. Controla con /cost.

---

EA! eso es todo por hoy 🍻, seguiremos trasteando estas herramientas y probaremos los consejos del bueno de Boris.

PD: Dejo el enlace al hilo de X por aquí.

---

Pon a prueba lo aprendido