¿Qué es Claude Code y para qué sirve?
Claude Code es un chat con inteligencia artificial (Claude, de Anthropic) que vive en la Terminal de tu Mac. En lugar de abrir una app o un navegador, escribes tu pregunta o pedido directamente ahí, y Claude te responde — generando código, revisando diseños, sugiriendo componentes, etc.
Como diseñador, puedes usarlo para:
- Describir un diseño y que Claude genere el código HTML/CSS/React.
- Pedirle que revise la accesibilidad de un componente (contraste, labels, tamaños de toque).
- Convertir tus ideas de Figma en código real.
- Hacer que un botón o layout sea responsive para móviles.
Necesitas una cuenta Claude activa (Pro, Max o Team). Al iniciar por primera vez, Claude te pedirá hacer login en el navegador — es un paso de 30 segundos.
Una carpeta por proyecto
Claude Code lee y escribe archivos dentro de la carpeta donde lo abres. Por eso recomendamos crear una carpeta distinta para cada proyecto en el que trabajes (cada cliente, cada campaña, cada sitio). Si mezclas varios proyectos en una sola carpeta, Claude puede confundir archivos de un cliente con los de otro.
Una organización simple que funciona bien
Crea la carpeta nueva directo desde el Finder: clic derecho en un espacio vacío → Nueva carpeta → ponle el nombre del proyecto. Después solo entras a esa carpeta cada vez que trabajes en ese cliente.
Conoce la Terminal
La Terminal es una app que ya viene instalada en tu Mac. En lugar de hacer clic en botones, escribes comandos de texto. No hay nada que romper — si escribes algo mal, simplemente te dice que no entendió.
Cómo abrirla
- Presiona Cmd + Espacio
- Escribe Terminal
- Presiona Enter. Aparecerá una ventana oscura con texto.
Puedes pegar texto en la Terminal con Cmd + V, igual que en cualquier otra app.
Cómo llegar a la carpeta de tu proyecto
Antes de escribir claude, la Terminal necesita estar "parada" dentro de la carpeta de tu proyecto. Hay tres formas de lograrlo — usa la que te resulte más cómoda.
Método A — el más fácil: clic derecho desde Finder
- Abre el Finder y entra a la carpeta de tu proyecto.
- Haz clic derecho (o Ctrl + clic) en cualquier espacio vacío dentro de la carpeta.
- Busca "Nueva Terminal en la carpeta". En la mayoría de los Mac aparece directo en el menú; si no la ves, revisa el submenú "Servicios".
- Se abrirá una Terminal ya ubicada dentro de esa carpeta, lista para escribir claude.
Activa el servicio desde Ajustes del Sistema → Teclado → Atajos de teclado → Servicios y marca "Nueva Terminal en la carpeta" dentro de "Archivos y carpetas".
Método B — arrastrar la carpeta (truco rápido)
Si ya tienes una Terminal abierta, puedes evitar escribir la ruta completa a mano:
- Escribe cd seguido de un espacio, pero no presiones Enter todavía.
- Arrastra la carpeta de tu proyecto desde el Finder y suéltala dentro de la ventana de la Terminal.
- La ruta completa aparece sola. Presiona Enter.
Método C — navegar escribiendo comandos
No necesitas memorizar nada, pero estos son los únicos comandos que usarás:
| Comando | ¿Qué hace? |
|---|---|
| claude | Inicia el chat con Claude Code |
| pwd | Muestra en qué carpeta estás |
| ls | Lista los archivos de la carpeta actual |
| cd NombreCarpeta | Entra a una carpeta |
| cd .. | Sube un nivel (sale de la carpeta actual) |
| node -v | Verifica que Node.js está instalado |
Escribe solo las primeras letras del nombre de la carpeta (por ejemplo cd Pro) y presiona Tab — la Terminal completa el resto automáticamente. Si hay varias carpetas que empiezan igual, presiona Tab dos veces para ver todas las opciones y sigue escribiendo hasta diferenciarlas. Te ahorra errores de tipeo, sobre todo con nombres largos o con acentos.
Instala Node.js
Node.js es un motor que Claude Code necesita para funcionar. Solo se instala una vez y no tienes que volver a pensar en él.
- Ve a nodejs.org
- Haz clic en el botón verde "Download Node.js (LTS)"
- Abre el archivo que se descargó (termina en .pkg) y sigue el instalador — igual que cualquier app de Mac.
- Cuando termine, abre la Terminal y escribe: node -v
Así se ve la página de descarga — busca el botón verde de la versión LTS.
Si ves un número como v22.0.0 o v24.0.0, todo está listo.
npm se instala automáticamente junto con Node.js. Es el "App Store" de herramientas de programación — lo usarás para instalar Claude Code en el siguiente paso.
Instala Claude Code
Con Node.js listo, instalar Claude Code es un solo comando. Cópialo tal cual en la Terminal y presiona Enter:
Verás texto moviéndose mientras se descarga. Cuando regrese el prompt, ya terminó. Verifica que quedó instalado:
Si muestra un número de versión, ¡listo! Si aparece "command not found", cierra la Terminal, vuelve a abrirla e intenta de nuevo.
No agregues la palabra sudo antes del comando. Eso puede causar errores de permisos y complicar las cosas.
Empieza a usar Claude Code
Asegúrate de estar dentro de la carpeta de tu proyecto (ver Paso 1) y luego escribe:
La primera vez que lo ejecutes, se abrirá el navegador para que inicies sesión con tu cuenta de Anthropic. Después de eso, cada vez que escribas claude dentro de la carpeta de un proyecto ya estarás dentro del chat.
El prompt > es donde escribes tu pedido.
Ejemplos de cosas que puedes pedirle:
- "Crea una landing page en React con un navbar y un banner hero."
- "Convierte este diseño de Figma en código JSX con Tailwind CSS."
- "Haz que este componente sea responsive para móviles."
- "Revisa la accesibilidad de este formulario: ¿tiene buen contraste? ¿están los labels bien puestos?"
- "Genera una paleta de colores accesible basada en azul marino y naranja."
Para salir del chat, escribe exit y presiona Enter, o usa Ctrl + D.
Visual Studio Code (VS Code)
VS Code es un editor de código gratuito que hace la experiencia mucho más cómoda: ves tus archivos, el código generado y el chat de Claude, todo en la misma pantalla. No es obligatorio, pero lo recomendamos.
Instalar VS Code
- Ve a code.visualstudio.com
- Haz clic en "Download for Mac"
- Abre el archivo descargado y arrastra Visual Studio Code a tu carpeta Aplicaciones.
- Abre VS Code desde Aplicaciones.
Instalar la extensión de Claude Code
- En VS Code, presiona Cmd + Shift + X
- En el buscador que aparece, escribe Claude Code
- Haz clic en Instalar
El panel de la derecha es el chat de Claude — escribe ahí igual que en la Terminal.
VS Code también tiene su propia terminal incorporada. La abres con Ctrl + ` (la tecla del acento grave, arriba del Tab). Desde ahí puedes escribir claude igual que en la Terminal normal de Mac.
Referencia rápida
Secuencia de instalación (una sola vez)
- Descargar e instalar Node.js desde nodejs.org
- En Terminal: npm install -g @anthropic-ai/claude-code
- Verificar: claude --version
- (Opcional) Instalar VS Code + extensión Claude Code
Uso diario
- Crea o abre la carpeta de tu proyecto
- Abre la Terminal ahí (clic derecho → Nueva Terminal en la carpeta)
- Escribe claude y presiona Enter
- Escribe tu pedido y presiona Enter
Tab autocompleta nombres de carpetas mientras escribes cd. Arrastrar una carpeta del Finder a la Terminal inserta su ruta completa. Y clic derecho → Nueva Terminal en la carpeta te evita escribir comandos por completo.
Comandos de Claude dentro del chat
- /help — muestra todos los comandos disponibles
- /code-review — pide a Claude que revise el código actual
- exit — cierra la sesión de Claude
Claude Code requiere macOS 13 (Ventura) o posterior. Si tu Mac es más antiguo, la instalación no funcionará. Puedes verificar tu versión en: Menú Apple → Acerca de este Mac.