Claude Code: primeros pasos sin ser programador

Hasta aquí usaste la IA dentro de una ventana de chat: tú pegas, ella responde, tú copias. Este módulo cambia el lugar donde ocurre el trabajo. Claude Code es un agente que vive en una carpeta de tu computador, lee los archivos que hay ahí, crea o modifica los que haga falta y comprueba que el resultado funcione. No necesitas saber programar para usarlo; necesitas saber describir lo que quieres y leer lo que te entrega, que es justo lo que practicaste en las partes 1 y 2.

Vamos en este orden: qué es un agente de código y para qué le sirve a un negocio, dónde corre Claude Code y qué plan necesitas, la terminal en diez minutos, la instalación y la primera sesión, y tu primera herramienta real. Si eres desarrollador, salta la parte de terminal; el resto aplica igual.

¿Qué es un agente de código y en qué se diferencia de un chat?

En un chat, el modelo solo puede responder con texto. Un agente de código tiene herramientas: puede leer un archivo, buscar dentro de una carpeta, escribir o editar archivos, ejecutar un comando y leer el resultado. Con eso deja de ser un consejero y pasa a ser alguien que hace el trabajo. La documentación de Claude Code describe su funcionamiento como un ciclo de tres fases que se mezclan: reunir contexto, actuar y verificar el resultado.

1. 1Reunir contexto. Lee los archivos de la carpeta que le indicaste, busca lo relevante y entiende cómo está armado el proyecto. No tienes que pegarle nada: los lee cuando los necesita.
2. 2Actuar. Crea o edita archivos, corre comandos (abrir un servidor de prueba, ejecutar un script, instalar una librería).
3. 3Verificar. Revisa que lo que hizo funcione: corre pruebas, vuelve a ejecutar, lee los errores y corrige. Y repite el ciclo hasta que considera que terminó, o hasta que tú lo interrumpes.

Lo hace dentro de una carpeta que tú escoges. Esa carpeta es su mundo: ve lo que hay adentro, puede ejecutar los comandos que tú podrías ejecutar y, si la carpeta es un repositorio, ve el historial de cambios. Fuera de ella no toca nada sin preguntarte. Esa frontera es tu primera herramienta de seguridad.

Para qué le sirve a un dueño de negocio que no programa:

• Herramientas internas pequeñas. Una página que calcula una cotización con tus reglas, un formulario que arma un contrato a partir de una plantilla, un tablero que lee un archivo exportado de tu sistema y muestra lo que te importa.
• Tareas con archivos. Un script que limpia la exportación de tu hoja de cálculo todos los lunes, renombra doscientas fotos según su contenido, o convierte veinte PDFs en una tabla.
• Una página web sencilla. Una landing para un servicio nuevo, con tus textos y tus fotos, que puedes publicar sin pagar una agencia por cada cambio.
• Entender lo que ya tienes. Si alguien te construyó un sistema, Claude Code te explica en lenguaje normal qué hace cada parte. Es la pregunta con la que vas a empezar.

Las automatizaciones del módulo 8 viven aquí también: lo que ahí hiciste con n8n o con tareas programadas, con Claude Code lo puedes construir como un programa pequeño que corre solo. Lo retomamos en el módulo 15.

¿Dónde corre Claude Code y qué plan necesito?

A octubre de 2026, la documentación oficial lista cuatro superficies principales: la terminal (la versión completa, y la de este módulo), extensiones para editores de código (VS Code, Cursor y los IDE de JetBrains), una aplicación de escritorio para Mac y Windows que incluye Claude Code sin instalar nada más, y la web en claude.ai/code, donde la sesión corre en la nube. Todas usan el mismo motor: lo que aprendas en una te sirve en las otras.

En cuanto al plan: según la documentación, Claude Code requiere un plan Pro, Max, Team o Enterprise de Claude, o una cuenta de Console (la de la API, con créditos prepagados). El plan gratuito no lo incluye. Si ya pagas Pro para el chat, ya lo tienes; no es un producto aparte.

¿Qué necesito saber de la terminal? (diez minutos)

La terminal es una ventana donde escribes una orden, presionas Enter y ves el resultado como texto. No tiene botones y no se puede hacer clic en las cosas: te mueves con el teclado. Parece de otra época, pero es el entorno natural de las herramientas de programación, y Claude Code es una CLI, un programa que se maneja escribiendo. Solo necesitas cinco ideas.

1. 1Abrirla. En Mac: Cmd + Espacio, escribe "Terminal", Enter. En Windows: Win + X y escoge Windows PowerShell o Terminal. Verás una línea con un cursor parpadeando: ahí escribes.
2. 2Saber dónde estás. La terminal siempre está "parada" en una carpeta. Escribe `pwd` y Enter para ver cuál (en Windows PowerShell también funciona). Esa ruta, algo como `/Users/ana/Documentos` o `C:\Users\ana\Documentos`, es la dirección completa de la carpeta.
3. 3Ver qué hay. Escribe `ls` para listar los archivos y carpetas de donde estás (en PowerShell `ls` también sirve; `dir` es el equivalente clásico de Windows).
4. 4Moverte. `cd Documentos` entra a la carpeta Documentos; `cd ..` sube a la carpeta de arriba; `mkdir cotizador` crea una carpeta nueva llamada cotizador. Si el nombre tiene espacios, ponlo entre comillas.
5. 5Ejecutar y detener. Un comando corre cuando presionas Enter. Si algo se queda corriendo y quieres pararlo, Ctrl + C. Para cerrar la terminal, escribe `exit`.

¿Cómo instalo Claude Code y hago mi primera sesión?

Estos son los pasos oficiales a octubre de 2026 (fuentes al final). Si algo falla, la guía de instalación de la documentación tiene una lista de errores con su solución; y si nunca habías abierto una terminal, Anthropic tiene una guía para principiantes enlazada abajo.

1. 1Instalar. Abre la terminal y pega una sola línea. En Mac o Linux: `curl -fsSL https://claude.ai/install.sh | bash`. En Windows PowerShell: `irm https://claude.ai/install.ps1 | iex`. No muestra progreso mientras descarga: espera hasta ver el mensaje de instalación exitosa. En Windows, la documentación recomienda instalar también Git para Windows (un instalador normal) para que Claude Code tenga todas sus herramientas.
2. 2Comprobar. Abre una terminal nueva y escribe `claude --version`. Si imprime un número de versión, quedó bien. Si dice que no reconoce el comando, la guía de instalación explica cómo arreglar la ruta.
3. 3Entrar a una carpeta y arrancar. `cd` a la carpeta del proyecto (o crea una vacía con `mkdir`) y escribe `claude`. La primera vez te pide iniciar sesión: se abre el navegador, entras con tu cuenta de Claude y vuelves a la terminal. No hay que repetirlo después.
4. 4Hablarle. Aparece el prompt de Claude Code con la versión, el modelo y la carpeta actual. Escribes en lenguaje normal y Enter. `/help` muestra los comandos; Esc interrumpe lo que esté haciendo; `exit` (o Ctrl + D dos veces) cierra la sesión.

La primera sesión tiene un guion fijo, y vale la pena seguirlo aunque tengas prisa. Primero, haz que explique la carpeta: si es un proyecto que te construyeron, es la radiografía que nunca te dieron; si es una carpeta vacía, te va a decir que está vacía, y eso también es información. Segundo, pide un cambio pequeño y visible, del tamaño de "crea una página que diga hola". Tercero, lee lo que cambió antes de aceptarlo.

Explícame este proyecto como si no supiera programar. Quiero entender:

1. Qué hace, en una frase que le diría a un cliente.
2. Qué hay en cada carpeta principal, en una línea cada una, sin tecnicismos.
3. Dónde están los textos, los precios o los datos que yo cambiaría con más frecuencia.
4. Qué comandos se usan para probarlo y para publicarlo, si lo puedes deducir de los archivos.
5. Tres cosas que te parezcan frágiles o que yo debería saber antes de pedir cambios.

No cambies ningún archivo todavía. Si algo no lo puedes saber leyendo los archivos, dímelo en vez de suponerlo.

Sobre los permisos: Claude Code tiene modos. En el modo manual te pregunta antes de editar un archivo o ejecutar un comando y te muestra el cambio exacto (las líneas que quita y las que pone) para que apruebes o rechaces. A octubre de 2026, las versiones recientes arrancan en un modo automático en el que un segundo modelo revisa las acciones en segundo plano y bloquea las riesgosas en vez de preguntarte; con Shift + Tab cambias de modo en cualquier momento. Para tus primeras sesiones, pásate al modo manual: aprobar cada cambio es lento, pero es como aprendes a leer lo que hace. Además, antes de editar un archivo, Claude Code guarda una copia: si algo salió mal, Esc dos veces vuelve a un punto anterior.

¿Cómo construyo mi primera herramienta sin programar?

La diferencia entre un juguete y una herramienta útil no está en el código; está en la descripción. Un pedido como "hazme un cotizador" produce algo genérico que vas a corregir diez veces. Una especificación de ocho líneas produce algo que se parece a lo que necesitas desde la primera versión. Es la habilidad de Descripción del módulo 4 aplicada a construir, y es el tema entero del módulo 17.

La mini especificación que te recomendamos para una herramienta de una página tiene cuatro partes: quién la usa (y en qué momento), qué entra (los datos que la persona escribe o pega), qué sale (lo que la herramienta muestra o genera) y las reglas (cómo se calcula, qué casos especiales hay, qué no debe hacer). Pide la versión más simple que funcione, en un solo archivo HTML que se abra en el navegador con doble clic, sin servidores ni bases de datos. Después iteras.

Construye la primera versión de [HERRAMIENTA: por ejemplo, "un cotizador de alquiler de equipos", "un generador de mensajes de bienvenida", "una calculadora de comisiones"].

Quién la usa: [ROL Y MOMENTO: por ejemplo, "la persona de ventas, mientras habla con el cliente por WhatsApp"].
Qué entra: [LISTA DE CAMPOS: por ejemplo, "número de días, tipo de equipo (tres opciones), si requiere transporte"].
Qué sale: [LO QUE MUESTRA: por ejemplo, "el precio total desglosado y un texto listo para copiar y pegar al cliente"].
Reglas: [CÓMO SE CALCULA Y LOS CASOS ESPECIALES: por ejemplo, "tarifa por día según el tipo; 10% de descuento a partir de 7 días; transporte vale 40.000 dentro de la ciudad; nunca mostrar precios sin IVA"].

Restricciones: un solo archivo HTML que se abra en el navegador con doble clic, sin servidor ni base de datos, en español, que funcione en el celular. Empieza por la versión más simple que cumpla las reglas. Antes de escribir código, dime en cinco líneas cómo lo vas a hacer y pregúntame lo que no esté claro.

Cuando termine, va a decirte cómo abrir el archivo. Ábrelo, úsalo como lo usaría la persona real, con casos normales y con casos raros (cero días, un número negativo, un campo vacío), y vuelve con lo que viste: "con cero días muestra un precio negativo", "el texto para el cliente debe tutear", "agrega la opción de fin de semana". Cada vuelta es un mensaje corto; no empieces de cero. Y cada vez que haga un cambio que no entiendas, usa el tercer prompt.

Explícame qué cambiaste en esta última ronda y cómo lo pruebo:

1. Lista los archivos que tocaste y, para cada uno, qué cambió y por qué, en lenguaje normal.
2. Dime exactamente qué debo hacer para probarlo yo (qué abrir, qué escribir, qué debería ver).
3. Dime qué caso NO probaste o qué supuesto hiciste que yo debería confirmar.
4. Si algo de lo que hiciste se puede romper fácil con un cambio futuro, adviértemelo.

Si quieres el recorrido oficial, el curso gratuito Claude Code 101 de Anthropic Academy (en inglés, unas doce lecciones cortas) cubre lo mismo con más detalle; está pensado para desarrolladores, pero después de este módulo lo puedes seguir.

En tu primera sesión habrás notado algo: cada vez que arrancas, Claude Code empieza de cero, sin saber qué es tu proyecto ni qué reglas tienes. El siguiente módulo, "CLAUDE.md, memoria y manejo del contexto", resuelve eso: le enseñas tu proyecto una sola vez, en un archivo, y aprendes a mantener las sesiones limpias para que no se pierda en tareas largas.