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

*Tags: ia, herramientas, claude, agentes*

---


> [!info] Definición Rápida
> **Claude Code** es el agente de programación de Anthropic. Lee tu código, edita varios archivos a la vez, corre comandos y se conecta a herramientas externas por MCP. Se usa desde terminal, extensiones de editor, la app de escritorio o el navegador, y comparte la misma configuración en todas esas superficies.


## ¿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 [[que-es-vibe-coding|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-y-agents-md|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|skills de agentes]].
- **[[mcp|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-codigo-con-mcp|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, con `irm https://claude.ai/install.ps1 | iex`. Comprueba la instalación con `claude --version` y empieza con `claude` dentro de la carpeta del proyecto. Si nunca has usado una terminal, lee antes [[terminal-basica|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|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|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 [[revisar-prs-de-agentes|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 `/clear` entre tareas.
- Trabajar directamente en la rama principal en lugar de una rama aparte. Ver [[ramas-y-pull-requests|ramas y pull requests]].
- Confiar en que, porque el agente corrió las pruebas, la interfaz se ve bien. Revisa la pantalla.

## Fuentes

- [Claude Code: visión general](https://code.claude.com/docs/en/overview)
- [Claude Code: referencia de comandos](https://code.claude.com/docs/en/commands)
- [Claude Code: elegir un modo de permisos](https://code.claude.com/docs/en/permission-modes)
- [Claude Code: buenas prácticas](https://code.claude.com/docs/en/best-practices)
- [Claude: página de precios](https://claude.com/pricing)


---

Source: https://www.fernandoux.com/es/wiki/ia/claude-code/