Qué es Claude Code: 5 cosas que hace que un chat de IA no puede

Por meses usé la IA como todo el mundo: le pegaba un texto o un error a un chat, copiaba la respuesta y la pegaba de vuelta donde iba. Funcionaba, pero yo era el mensajero. Claude Code cambió eso: en vez de contestarme, abre la carpeta, hace el cambio, corre lo que haga falta y me enseña qué tocó.

Para este post no quise contarlo de memoria. Armé una carpeta de prueba (la de una agencia pequeña, con clientes, facturas, fotos y un README desordenado), corrí ahí los 5 prompts de abajo y copié lo que pasó. Todo lo que ves en las capturas es la salida real.

1. Lee y edita tus archivos
2. Corre comandos y lee el resultado
3. Skills: recetas que guarda y reusa
4. Hooks: reglas que se cumplen solas
5. Subagentes: varias tareas a la vez

Qué es Claude Code

Claude Code es el agente de programación de Anthropic. Trabaja directo sobre tus carpetas: lee tus archivos, los edita, corre comandos y se conecta a otras herramientas con MCP. A diferencia de un chat, no solo contesta: hace el trabajo y te pide permiso antes de lo delicado. Es un agente de IA, no un chatbot.

Fuente: Documentación oficial de Claude Code

Cómo elegí estas 5

No las saqué de la documentación. Son las que uso todos los días. Antes de escribir conté mis propias sesiones del 4 de junio al 12 de octubre: 195 sesiones, 957 archivos creados y 1,977 ediciones. Estas 5 son las que más uso.

Cómo las conté: leí los registros que Claude Code guarda en mi Mac y sumé solo las sesiones que abrí yo, sin subagentes, con cada archivo que creó y cada edición que hizo. En el post de la compactación hablo de 264 sesiones en 14 días de septiembre: esa cuenta mide costo, con otro filtro y otra fecha de corte, así que los dos números no se suman.

011. Lee y edita tus archivos

Con un chat copias el texto, lo pegas, copias la respuesta y la pegas de vuelta. En el tercer viaje se te escapa algo. Claude Code abre el archivo, propone el cambio y no guarda hasta que le dices que sí. Este es el README de mi carpeta de prueba, antes y después de un solo prompt:

# Agency files

This folder has all the stuff for the agency. Clients are in the clients folder, each one has a folder with their things like the logo and notes and also the contract sometimes, and invoices are in facturas which is where we put the invoices when we send them out to clients every month, and there are photos in fotos too. Templates are in plantillas. Don't delete the viejo folder because maybe we need something from there later, we are not sure yet.

# Archivos de la agencia

Esta carpeta reúne todo el material de la agencia:

- clientes/: una carpeta por cliente, con su logo, notas y, a veces, el contrato.
- facturas/: facturas enviadas a los clientes cada mes.
- fotos/: fotografías.
- plantillas/: plantillas de documentos.
- viejo/: archivos antiguos. No la borres: aún no sabemos si necesitaremos algo de ahí.

Fíjate en lo que no tocó: la sección How to use se quedó en inglés porque le pedí solo la primera. Al terminar me ofreció traducirla también.

Lee el archivo README.md de esta carpeta y reescribe la primera sección en español, más corta y más clara. Enséñame el cambio antes de guardarlo.

022. Corre comandos y lee el resultado

Con un chat, él te da el comando, tú lo corres, sale un error y vuelves a pegarle el error. Eres el mensajero entre la IA y tu computadora. Aquí le pedí que revisara la carpeta y lo hizo solo, en 9 segundos y con un solo comando:

Total archivos:
      14
--- Por extensión ---
   6 md
   3 jpg
   2 txt
   2 csv
   1 mp4
--- Top 5 más pesados ---
2500000	./fotos/video-local.mp4
1200000	./fotos/sesion-3.jpg
800000	./fotos/sesion-2.jpg

Revisa qué hay en esta carpeta: cuenta cuántos archivos hay de cada tipo y dime cuáles son los 5 más pesados. Corre los comandos que necesites y explícame qué hiciste.

033. Skills: recetas que guarda y reusa

Cada vez que repites una tarea le vuelves a explicar todo: el formato, los pasos, lo que no debe hacer. Una skill es una carpeta con un archivo SKILL.md: la receta de esa tarea. Claude Code la carga sola cuando la tarea coincide, o la llamas con /nombre.

Hoy, 21 de octubre, tengo 79 skills. Cada una es una tarea que ya no tengo que volver a explicar.

Cuando escribí este post eran 96. El 15 de octubre moví a una carpeta de archivo 25 que no usaba, porque Claude Code lee el nombre y la descripción de cada skill al abrir la sesión, y ese texto se vuelve a procesar en cada turno. Desde ese día agregué 8. La lección: una skill que no usas igual cuesta, porque se carga siempre.

Cómo lo conté: carpetas con un SKILL.md dentro de ~/.claude/skills, sin contar la de archivo. Las que traen los plugins no entran en el número.

Esta es la que escribió con el prompt de abajo. Fíjate en la regla que agregó sin que se la pidiera:

---
name: resumen-reunion
description: Convierte las notas de una reunión en un resumen
  estructurado con 3 decisiones, tareas (responsable y fecha)
  y preguntas abiertas.
---

## Reglas
- No inventes datos. Si una tarea no tiene responsable o fecha
  en las notas, escribe "Sin asignar" o "Sin fecha".
- Si algo es ambiguo, ponlo en Preguntas abiertas.

Crea una skill llamada resumen-reunion en .claude/skills/resumen-reunion/SKILL.md. Cuando le pase las notas de una reunión, debe devolver: 3 decisiones, tareas con responsable y fecha, y preguntas abiertas. Enséñame el archivo antes de guardarlo.

044. Hooks: reglas que se cumplen solas

Le pides algo diez veces (formatea el código, avísame cuando termines, no toques esta carpeta) y a la undécima se le olvida. Un hook es un comando que corre solo en un momento fijo: antes o después de editar, al terminar una tarea, al empezar la sesión. No depende de que la IA se acuerde; lo ejecuta Claude Code cada vez. Yo tengo 13, repartidos en 9 momentos de la sesión.

Cuando le pedí este hook, propuso el JSON. Le dije que lo guardara y contestó esto:

«No he podido guardarlo: la escritura en .claude/settings.json requiere un permiso que no se ha concedido.»

Yo le había dado permiso para editar archivos, pero no ese. Los archivos que cambian cómo se comporta Claude Code piden permiso aparte, y eso es lo que quieres de una herramienta que corre comandos. Lo apruebas una vez y listo.

{
  "hooks": {
    "Stop": [
      { "hooks": [
        { "type": "command",
          "command": "afplay /System/Library/Sounds/Glass.aiff" }
      ] }
    ]
  }
}

Estos son los míos, agrupados por lo que hacen:

El que más me gusta es el de aprendizaje. Antes de correr, compara la huella SHA-256 de su script con la que guardé al instalarlo. Si alguien, o la misma IA, cambió el script, el hook se niega a correr y me avisa. Un hook corre con tus permisos, sin preguntar, así que conviene que nadie lo pueda cambiar en silencio.

Crea un hook de tipo Stop en .claude/settings.json de este proyecto que toque un sonido cuando termines una tarea (en Mac usa: afplay /System/Library/Sounds/Glass.aiff). Enséñame el JSON antes de guardarlo y dime cómo probarlo.

055. Subagentes: varias tareas a la vez

Una tarea grande llena la conversación y el agente empieza a perder el hilo. Con subagentes, Claude Code reparte el trabajo: cada uno corre en paralelo con su propio contexto y le devuelve solo la conclusión. Le pedí 3 a la vez y en 18 segundos me devolvió una sola tabla:

La fila que me gustó es la tercera. Nadie le pidió revisar fechas contra nombres, pero notó que facturas/2026-08.csv tenía fecha de febrero y lo marcó para revisar antes de darlo por viejo.

Usa 3 subagentes en paralelo: uno lista los archivos de esta carpeta que no se han tocado en 6 meses, otro busca archivos duplicados por nombre, y otro busca carpetas vacías. Junta lo que encuentren en una sola tabla y no borres nada.

Pruébalo en 10 minutos

Instálalo con un comando. En Mac o Linux, abre la Terminal y pega:

curl -fsSL https://claude.ai/install.sh | bash

En Windows, en PowerShell: irm https://claude.ai/install.ps1 | iex. Después entra a una carpeta con cd, escribe claude e inicia sesión con tu cuenta. Abre una carpeta con un archivo desordenado y pega el prompt del punto 1. Si te enseñó el cambio antes de guardarlo, ya viste la diferencia con un chat.

Fuente: Documentación oficial de Claude Code (instalación)