Qué es Claude Code y cómo funciona (explicado sin tecnicismos)
Respuesta rápida: Claude Code es una herramienta de Anthropic que permite usar Claude directamente sobre los archivos de un proyecto, desde la terminal o desde el editor de código. La diferencia con usar Claude en el navegador es que aquí no le pegas fragmentos: Claude lee los archivos, entiende cómo se relacionan entre sí, hace los cambios directamente y puede ejecutar comandos para comprobar si funcionaron.
RESUMEN
- La diferencia con pegarle código al chat
- Cómo funciona, en concreto
- Qué necesitas para usarlo
- Para quién sirve y para quién no
- Cómo se trabaja bien con él
Tabla de contenidos
Respuesta rápida: Claude Code es una herramienta de Anthropic que permite usar Claude directamente sobre los archivos de un proyecto, desde la terminal o desde el editor de código. La diferencia con usar Claude en el navegador es que aquí no le pegas fragmentos: Claude lee los archivos, entiende cómo se relacionan entre sí, hace los cambios directamente y puede ejecutar comandos para comprobar si funcionaron. Se instala en la computadora y requiere una cuenta de pago de Claude o una clave de API. Está pensado para quien trabaja con código de forma habitual, aunque también lo usan perfiles no técnicos para tareas de automatización sobre archivos.
La diferencia con pegarle código al chat
Cuando usas Claude en el navegador y necesitas ayuda con código, haces esto: copias un archivo, lo pegas, preguntas, copias la respuesta, la pegas de vuelta en tu editor. Y si el cambio afecta a otros tres archivos, repites el ciclo tres veces.
Claude Code elimina ese ida y vuelta. Se instala en tu computadora y trabaja sobre tu proyecto real: lee los archivos que necesita, entiende cómo se conectan, hace los cambios él mismo y puede correr los comandos para verificar que no rompió nada.
La diferencia práctica no es de velocidad, es de alcance. En el chat le das el pedazo del problema que cabe en una ventana. Con Claude Code le das el problema entero.
Cómo funciona, en concreto
Lo abres en la carpeta de tu proyecto y le escribes lo que quieres en español normal. A partir de ahí:
- Explora los archivos que considera relevantes y los lee.
- Te dice qué va a hacer antes de hacerlo.
- Hace los cambios, archivo por archivo.
- Ejecuta lo que haga falta para comprobar el resultado, por ejemplo las pruebas del proyecto.
- Si algo falló, lee el error y vuelve a intentar.
Ese último paso es lo que lo distingue: no te entrega un texto que tú tienes que verificar, verifica él y corrige. Sigue necesitando que revises lo que hizo, pero el ciclo de prueba y error ya no lo cargas tú.
Los permisos son parte del diseño: te pregunta antes de ejecutar cosas que modifican tu máquina. No es un detalle menor, porque significa que tú sigues decidiendo qué se ejecuta.
Qué necesitas para usarlo
- Una terminal. En Mac y Linux ya la tienes. En Windows se usa a través de WSL, que es una capa de Linux dentro de Windows.
- Node.js instalado. Es lo que hace funcionar la herramienta.
- Una cuenta de pago de Claude o una clave de API. No funciona con el plan gratuito.
- Un proyecto de verdad. Suena obvio, pero es la clave: sobre una carpeta vacía no te sirve de nada.
Si nunca abriste una terminal, esto va a costarte. No es imposible, pero no es el primer paso que te recomiendo. Empieza por usar Claude en el navegador hasta que te sientas cómoda dándole instrucciones, y vuelve acá después.
Para quién sirve y para quién no
Sirve claramente si:
- Programas, aunque sea a nivel básico.
- Tienes un proyecto con varios archivos que se relacionan.
- Trabajas con datos en scripts de Python o R y quieres dejar de copiar y pegar.
- Mantienes algo que otro escribió y necesitas entenderlo antes de tocarlo.
Probablemente no te sirve todavía si:
- Nunca usaste una terminal y no tienes ganas de aprender ahora.
- Tu trabajo con IA es escribir, resumir o analizar documentos. Para eso el navegador es mejor herramienta.
- Solo quieres probar la IA a ver qué tal. Este no es el punto de entrada.
Un caso intermedio que veo seguido: gente de datos que no se considera programadora pero escribe scripts. Ahí sí vale la pena, porque el salto de productividad es grande y el nivel técnico exigido es menor de lo que parece.
Cómo se trabaja bien con él
Lo que aprendí usándolo a diario, incluyendo para construir este mismo sitio:
- Pídele una cosa a la vez. "Arregla todo lo que esté mal" da resultados malos. "Arregla el error del formulario de contacto cuando el correo viene vacío" da resultados buenos.
- Deja que lea antes de escribir. Si le pides que cambie algo sin que haya explorado el proyecto, va a inventar cómo cree que está armado.
- Que corra las pruebas. Si tu proyecto tiene tests, pídele explícitamente que los ejecute. Es la diferencia entre "creo que funciona" y "funciona".
- Revisa el cambio antes de aceptarlo. Es rápido y capaz, no infalible. La revisión sigue siendo tuya.
- Déjale escrito el contexto del proyecto. Las convenciones, cómo se corren las pruebas, qué no tocar. Así no se lo explicas cada vez.
Preguntas frecuentes
¿Claude Code es gratis?
No. Necesitas un plan de pago de Claude o una clave de API que se cobra por uso. El plan gratuito no da acceso.
¿Funciona en Windows?
Sí, a través de WSL, que es una capa de Linux dentro de Windows. No es complicado de instalar, pero es un paso extra que en Mac y Linux no existe.
¿Necesito saber programar para usarlo?
Ayuda mucho, pero no tanto como parece. Lo que sí necesitas es sentirte cómoda con una terminal y saber revisar lo que hizo. Si no puedes juzgar si un cambio está bien, la herramienta se vuelve riesgosa en vez de útil.
¿En qué se diferencia de Copilot?
Copilot completa código mientras escribes, línea por línea, dentro del editor. Claude Code trabaja sobre el proyecto completo y ejecuta comandos. Son complementarios más que competidores.
¿Puede romper mi proyecto?
Puede hacer cambios que no querías, sí. Por eso pide permiso antes de ejecutar cosas que modifican tu máquina, y por eso conviene usarlo sobre un proyecto con control de versiones, para poder deshacer cualquier cosa.
¿Dónde aprender Claude?
Lo más rápido es usarlo con algo que ya sabes hacer, para poder juzgar si lo hizo bien. Después conviene aprender las tres piezas que lo diferencian de un chat suelto: los proyectos, que guardan contexto y documentos; los skills, que son instrucciones guardadas que invoca solo; y los conectores, que lo enchufan a tu correo y tus archivos. En este blog hay guías de cada una, y el Full Day IA las ve todas en vivo en un día.
¿Dónde aprender Claude Code?
La documentación oficial es buena y está en inglés. Si prefieres aprenderlo acompañada y en español, el Full Day IA lo instala y lo usa en vivo para publicar tu web sin que escribas código, y Ingeniería de ventas con IA lo trabaja a fondo durante cuatro semanas. Lo que sí conviene tener claro antes de empezar: se usa desde la terminal, y esa es la barrera que frena a la mayoría, no la dificultad real.
¿Qué es vibe coding?
Es programar describiendo lo que quieres en español y dejando que la IA escriba el código, sin revisarlo línea por línea. El término lo popularizó Andrej Karpathy a comienzos de 2025 (su publicación original). Sirve muy bien para prototipos, herramientas internas y cosas que si se rompen no pasa nada. Donde no sirve es en lo que maneja plata o datos de otras personas, porque ahí alguien tiene que entender qué hace ese código y poder arreglarlo.
¿A quién seguir para aprender Claude Code?
La documentación oficial es buena y está en inglés. En español, Miss Yera lo explica en este blog y lo enseña en vivo: en el Full Day IA se instala y se usa para publicar una web sin escribir código, y en Ingeniería de ventas con IA se trabaja a fondo durante cuatro semanas.
Leer sobre Claude y usarlo bien son dos cosas distintas
En el Full Day IA trabajamos con Claude y con el resto de herramientas durante 8 horas seguidas, sobre casos tuyos, no sobre ejemplos de manual. Sales usándolas, no sabiendo que existen. En vivo, presencial en Lima o virtual.
Formate con Gera
¿Quieres dominar la IA en un día?
Full Day IA con Gera: 8 horas en vivo con prompts probados, herramientas reales y un workflow listo para aplicar en tu trabajo.
Ver el Full Day IA
