Claude Code: un agente de programación que trabaja en tu repo
Claude Code es el agente de programación de Anthropic: lee tu código, edita archivos y corre comandos. Qué hace, cuánto cuesta y qué revisar antes de aceptar.
¿Qué hace exactamente?
Claude Code recibe una tarea en lenguaje natural, por ejemplo “escribe pruebas para el módulo de autenticación, córrelas y corrige los fallos”. Entonces planifica, lee los archivos que necesita, escribe cambios en varios archivos y ejecuta comandos para verificar. Trabaja directamente con git: prepara cambios, escribe mensajes de commit, crea ramas y abre pull requests.
La documentación oficial lo describe como una herramienta de programación agéntica que lee tu código base, edita archivos, corre comandos y se integra con tus herramientas de desarrollo. Lo importante para ti es que no se limita a sugerir código: lo escribe en tu proyecto, y tú decides qué aceptar.
¿Por qué le importa a un diseñador?
Porque cambia el borde entre diseñar y construir. Puedes prototipar una interacción, pedirle a Claude Code que la implemente con los componentes del proyecto y revisar el resultado en una pantalla real. Eso se conecta con la idea de vibe coding, con un matiz importante: el agente trabaja sobre un repositorio que tiene reglas, no sobre una página en blanco.
Tres piezas hacen la diferencia para un diseñador:
- CLAUDE.md: el archivo de instrucciones que Claude Code lee al inicio de cada sesión. Aquí van tus tokens, tus componentes y tus reglas. La documentación recomienda mantenerlo corto: por cada línea, pregunta si quitarla haría que Claude cometa errores; si no, bórrala. Un archivo demasiado largo hace que Claude ignore parte de las reglas.
- Skills: flujos reutilizables que empaquetas para tu equipo, como una revisión de pantalla o una lista de accesibilidad. Ver skills de agentes.
- MCP: la conexión a herramientas externas, como Figma o Notion. Con ella, el agente lee el diseño directamente. Se conecta con
claude mcp add; mira también Figma a código con MCP.
CLAUDE.md es consultivo: Claude suele seguirlo, pero no lo garantiza. Lo que debe ocurrir siempre (por ejemplo, formatear tras cada edición) se configura como hook, un comando que se ejecuta antes o después de sus acciones.
¿Cómo empezar?
La documentación oficial ofrece varias superficies:
- Terminal: la CLI completa. En macOS, Linux y WSL se instala con
curl -fsSL https://claude.ai/install.sh | bash; en Windows PowerShell, conirm https://claude.ai/install.ps1 | iex. Comprueba la instalación conclaude --versiony empieza conclaudedentro de la carpeta del proyecto. Si nunca has usado una terminal, lee antes terminal básica. - VS Code y JetBrains: extensiones con diffs en línea y revisión de planes. El plugin de JetBrains requiere instalar la CLI por separado.
- App de escritorio: para revisar cambios visualmente, correr varias sesiones lado a lado y programar tareas recurrentes. Requiere una suscripción de pago.
- Web (claude.ai/code): en el navegador, sin instalación local, útil para tareas largas o en paralelo.
La CLI pide iniciar sesión la primera vez. La documentación indica que la mayoría de las superficies requieren una suscripción de Claude o una cuenta de la consola de Anthropic.
¿Qué comandos y modos conviene conocer?
Dentro de una sesión, escribir / muestra los comandos disponibles. Estos son los más útiles al empezar, según la referencia oficial:
| Comando | Para qué sirve |
|---|---|
/init | Crea un CLAUDE.md inicial a partir de la estructura del proyecto |
/plan | Entra en modo plan: Claude lee y propone, sin editar |
/clear | Empieza una conversación con el contexto vacío |
/compact | Resume la conversación para liberar contexto |
/rewind | Restaura conversación y/o código a un punto anterior (alias: /checkpoint, /undo) |
/permissions | Gestiona qué acciones Claude puede hacer sin preguntar |
/usage | Muestra el costo de la sesión y los límites de tu plan |
Los modos de permiso definen qué puede hacer Claude sin pedirte confirmación. Se cambian con Shift+Tab en la CLI:
- Manual (valor
default): solo lee sin preguntar; pide permiso para editar o ejecutar. - acceptEdits: aprueba ediciones de archivos y comandos básicos de archivos.
- plan: solo lectura para explorar antes de cambiar. Ver modo plan.
- auto: un segundo modelo revisa las acciones en lugar de ti. Desde la versión 2.1.283 es el modo inicial en terminal y VS Code.
- dontAsk y bypassPermissions: el primero es para CI y scripts; el segundo, solo para contenedores o máquinas virtuales aisladas. No los uses en tu equipo de trabajo.
Comprueba en qué modo estás antes de pedir cambios grandes. Para entender los riesgos, mira sandboxing y permisos.
¿Cuánto cuesta?
Según la página de precios de Claude consultada el 17 de octubre de 2026:
| Plan | Precio mensual en USD | Incluye Claude Code |
|---|---|---|
| Free | 0 | No |
| Pro | 17 con facturación anual (200 pagados por adelantado); 20 si pagas mensual | Sí |
| Max | Desde 100 (elige 5x o 20x el uso de Pro) | Sí |
| Team | Asiento Standard: 20 anual o 25 mensual. Asiento Premium: 100 anual o 125 mensual | Sí |
| Enterprise | 20 por asiento con facturación anual, mínimo 20 asientos, más uso a tarifa de API | Sí |
Los límites de uso se reinician en una ventana de cinco horas y los planes de pago añaden límites semanales. Los precios pueden cambiar: revisa la página oficial antes de decidir.
¿Cuándo NO conviene Claude Code?
- Cuando el proyecto no tiene control de versiones. Sin git es difícil revisar y deshacer lo que el agente cambió, y los puntos de control de Claude no sustituyen a git.
- Cuando no entiendes el código que va a tocar. Puedes pedirle explicaciones, pero necesitas leer los cambios antes de aceptarlos.
- Cuando la tarea es de una sola línea. Si puedes describir el cambio en una frase, editarlo tú suele ser más rápido que planificarlo.
- Cuando trabajas con datos sensibles y no tienes claro qué se envía al servicio. Revisa la política de datos de tu organización.
Ejemplo
Ejemplo ilustrativo: una diseñadora quiere probar un cambio en el formulario de contacto de un sitio. Ya conectó el servidor MCP de Figma. Abre la terminal en el repo, escribe claude, entra en modo plan con Shift+Tab y pide: “Lee el formulario actual y propón cómo reordenar los campos según este marco de Figma. Usa los componentes de src/components y no crees campos nuevos.” Revisa el plan, lo aprueba y Claude hace el cambio. Ella le pide además que tome una captura de la página y la compare con el diseño. Después revisa el diff en la app de escritorio, corrige una etiqueta y hace commit en una rama aparte.
Lo que muestra el ejemplo: el valor no está en escribir el código, sino en dar un resultado verificable (la captura contra el diseño) y revisar un cambio pequeño con criterio. En un equipo, el siguiente paso es la revisión humana de los PR de agentes.
Errores comunes
- Aceptar cambios sin revisar el diff.
- Dejar el CLAUDE.md vacío y repetir las mismas reglas en cada prompt, o al revés: llenarlo hasta que Claude ignore reglas.
- Pedir cambios grandes en un solo prompt en vez de tareas pequeñas y verificables.
- No darle a Claude una forma de comprobar su trabajo (pruebas, una compilación o una captura comparada con el diseño). Sin eso, tú eres el único control.
- Mezclar tareas sin relación en la misma sesión. Usa
/clearentre tareas. - Trabajar directamente en la rama principal en lugar de una rama aparte. Ver ramas y pull requests.
- Confiar en que, porque el agente corrió las pruebas, la interfaz se ve bien. Revisa la pantalla.