Claude Code en español: cómo empezar sin saber programar

Desde diciembre de 2025 construyo todo con Claude Code, y se lo pido en español. Pagos, correos, grupos de WhatsApp, propuestas para clientes y los agentes que dirigen mis proyectos: todo salió de conversaciones en español con esta herramienta. La pregunta que más me hacen es si funciona igual de bien en español. Funciona, y esta es la guía que uso con gente que nunca ha programado.

Qué es Claude Code

Claude es la IA de Anthropic. En el chat de Claude le preguntas algo y te responde. Claude Code es distinto: trabaja dentro de una carpeta de tu computadora. Lee los archivos, los crea, los cambia, corre programas, instala lo que falte y publica el resultado en internet.

La diferencia práctica es esta: el chat te dice cómo hacer una página web; Claude Code la hace, la prueba y te da el enlace.

Qué necesitas

• Una cuenta de Claude con plan de pago. El plan gratis no incluye Claude Code. El plan Pro alcanza para empezar.
• Una laptop con Mac o Windows donde puedas instalar programas.
• Unos 20 minutos para la primera vez.

No necesitas saber programar ni abrir la terminal.

Dónde se usa

Claude Code está en cuatro lugares:

• La app de escritorio (Mac y Windows). Es la que recomiendo para empezar: se instala como cualquier programa y no hay que tocar la terminal.
• La terminal, para quien ya está cómodo ahí.
• Dentro de editores de código como VS Code y JetBrains.
• En la web, en claude.ai/code, trabajando sobre un repositorio en la nube.

Todo lo que sigue usa la app de escritorio.

Cómo instalarlo

1. Descarga la app en claude.ai/download e instálala.
2. Ábrela e inicia sesión con tu cuenta de Claude.
3. Si te pregunta si quiere instalar Git (o las "command line tools" en Mac), acepta. Es la herramienta que guarda versiones de tu trabajo y solo se instala una vez.
4. Abre una carpeta nueva para tu primer proyecto, por ejemplo mi-primer-proyecto.

Listo. Ya puedes escribirle.

Tu primer pedido

Copia esto, cambiando el nombre:

Crea una página web sencilla y bonita que diga en grande "Hola, soy Ana y estoy construyendo con IA". Dale un diseño moderno.

Vas a ver los archivos aparecer mientras trabaja. Después pídele un cambio:

Cambia el fondo a azul oscuro, el texto a blanco y pon mi nombre en el título de la pestaña.

Ese segundo pedido es el que importa. Ahí se siente lo que es dirigir en vez de programar.

Cómo pedirle las cosas

Lo que más diferencia a quien avanza de quien se traba no es el inglés ni la técnica. Es cómo pide.

• Describe el resultado, no el código. "Quiero que la gente pueda reservar un cupo y que me llegue un correo" funciona mejor que intentar adivinar términos técnicos.
• Un cambio a la vez. Pide, mira, corrige. Diez pedidos cortos le ganan a uno largo.
• Si sale un error, pégalo entero. No lo interpretes ni lo resumas: cópialo completo y escribe "me salió este error, arréglalo". Es el método que más uso, todavía hoy.
• Pídele que te explique. "Explícame qué hiciste, sin términos técnicos" es un pedido válido, y así se aprende rápido.
• Dale contexto como a una persona. Para quién es, qué problema resuelve, qué no debe tocar. Mientras más sepa, menos adivina.

Los permisos

Por defecto, Claude Code pide permiso antes de cada acción: crear un archivo, correr un comando, instalar algo. Al principio está bien ver esas preguntas para entender qué hace.

Cuando ya confías en el flujo, la app tiene un modo que deja que trabaje sin preguntar. Úsalo solo dentro de la carpeta de tu proyecto, no en carpetas con documentos importantes, y revisa lo que hizo al final.

Publicar en internet

Para que tu proyecto tenga una dirección pública, crea una cuenta gratis en Vercel con el mismo correo y pídele a Claude:

Conecta esta computadora a mi cuenta de Vercel y guíame por lo que aparezca. Si falta instalar algo, instálalo tú y explícame qué hiciste.

Después:

Publica este proyecto en producción y dame la dirección pública.

Abre ese enlace en tu celular. Eso que tienes en la mano lo publicaste tú.

Problemas comunes

• La app no abre en Mac la primera vez: clic derecho sobre la app y "Abrir".
• Te pregunta si instala Node: acepta. Lo necesita la herramienta que publica en Vercel.
• Pide permiso a cada rato: revisa el modo de permisos en la barra donde escribes.
• "Command not found" u otro error raro: pégale el error completo y pídele que instale lo que falte y vuelva a intentar.

Lo que viene después

Con lo de arriba ya puedes construir cosas útiles para tu trabajo: una página, un formulario que guarda respuestas, un tablero con tus números, una herramienta que tu equipo usa a diario. Yo empecé igual, y hoy algunos de mis proyectos los dirige un agente que trabaja solo cada día.

Si prefieres aprenderlo en persona, en Panamá lo enseño en un día: cada quien sale con su app publicada. Está en el curso de IA en Panamá.