
guía en español
Claude Code para diseño
Instalarlo, abrir tu primera sesión y darle el contexto de diseño que necesita para no entregar interfaces genéricas.
Qué es Claude Code
Claude Code es el agente de código de Anthropic. Lee tu proyecto, edita archivos y corre comandos mientras le hablas en lenguaje natural. Funciona en la terminal, en una app de escritorio, dentro de VS Code y JetBrains, y en la web.

Para quien diseña, el cambio es que puede trabajar directo sobre el material final, el código, sin esperar un handoff. Esta guía cubre lo justo para empezar; la documentación oficial en español tiene el resto.
Antes de empezar
- Cuenta
- Un plan Pro, Max, Ultra, Team o Enterprise, o Claude Console. El plan gratuito no incluye Claude Code.
- Sistema
- macOS 13 o posterior, Windows 10 1809 o posterior, Ubuntu 20.04 o posterior. 4 GB de RAM.
- Sin terminal
- Si nunca usaste una, empieza con la app de escritorio y vuelve a esta guía para el contexto de diseño.
Instalar Claude Code
Abre una terminal y pega el comando de tu sistema. El instalador no muestra progreso mientras descarga; espera a que termine.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
brew install --cask claude-code
winget install Anthropic.ClaudeCode
Las tres primeras son el instalador nativo, que se actualiza solo. Homebrew y WinGet no: actualiza con brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode.
Abre una terminal nueva y comprueba la instalación. claude doctor revisa la instalación y la configuración sin abrir una sesión.
claude --versionclaude doctor
Fuente: instalación avanzada en la documentación de Claude Code, revisada el 21 de noviembre de 2026.

Tu primera sesión
Entra a la carpeta de tu proyecto y arranca Claude Code. La primera vez te pide iniciar sesión en el navegador.
cd <carpeta de tu proyecto>claude
- Pregunta antes de pedir: “¿qué hace este proyecto?” o “¿dónde están los componentes?”. Lee los archivos que necesita, no hace falta pegarle código.
- Cuando propone un cambio te lo muestra y pide permiso. Shift + Tab cambia el modo de permisos de la sesión.
/helplista los comandos,/clearempieza una conversación nueva yclaude -cretoma la última.
Darle contexto de diseño
Sin contexto, cualquier agente entrega lo mismo: el gris de siempre, tarjetas en todas partes, la tipografía por defecto. Tres piezas lo evitan.
1. CLAUDE.md
Es el archivo de instrucciones que Claude Code lee al inicio de cada sesión. Escribe /init y lo genera a partir de tu proyecto. Mantenlo por debajo de 200 líneas y agrega lo que el agente no puede descubrir solo.
2. DESIGN.md
Tu sistema de diseño en un archivo: tokens, reglas y ejemplos. Se importa desde CLAUDE.md con @DESIGN.md. Cómo escribirlo, con casos reales, está en la guía de DESIGN.md.
# CLAUDE.md
Sigue el sistema de diseño de @DESIGN.md en todo cambio de interfaz.
Antes de crear un componente, revisa si ya existe uno en components/.
Revisa cada pantalla en tema claro y oscuro, y en mobile.
3. Skills
Una skill es una carpeta con un SKILL.md en .claude/skills/<nombre>/. Sirve para tareas que repites, como revisar accesibilidad o preparar assets, y se invoca con /nombre.
Primeros pedidos de diseño
Pedidos concretos, con el resultado que esperas y lo que no debe cambiar, funcionan mejor que “mejóralo”.
- Antes de cambiar nada, explícame cómo está organizado este proyecto y qué componentes de interfaz ya existen.
- Lee DESIGN.md y rehace la página de ajustes con sus tokens. Muéstrame el plan antes de editar.
- Revisa esta pantalla en tema claro y oscuro y lista los textos con contraste insuficiente.
- El formulario de registro no muestra errores junto a cada campo. Arréglalo sin mover el botón de enviar.
Errores comunes al instalar
claudeno se encuentra- Abre una terminal nueva. Si sigue, la carpeta de instalación no está en tu PATH.
'&&' is not a valid statement separator- Estás en PowerShell: usa el comando de PowerShell, no el de CMD.
'irm' is not recognized- Estás en CMD: usa el comando de CMD.
Para cualquier otro error, la guía oficial de problemas de instalación los ordena por mensaje.
Preguntas frecuentes
¿Claude Code es gratis?
No. Necesitas un plan Pro, Max, Ultra, Team o Enterprise de Claude, o una cuenta de Claude Console con créditos. El plan gratuito de claude.ai no lo incluye.
¿Necesito saber programar?
No para empezar, pero ayuda entender qué cambió. Claude Code te muestra cada cambio antes de aplicarlo. Si nunca usaste una terminal, la app de escritorio te deja trabajar sin ella.
¿Funciona en Windows?
Sí, en Windows 10 1809 o posterior, desde PowerShell o CMD, o dentro de WSL. Instalar Git for Windows es opcional y le permite usar Bash.
¿Puedo hablarle en español?
Sí. Entiende y responde en español, y la documentación oficial también está traducida.
¿Cómo hago que respete mi diseño?
Escribe tu sistema de diseño en un DESIGN.md e impórtalo desde CLAUDE.md con @DESIGN.md. Así lo lee al inicio de cada sesión, en lugar de elegir estilos genéricos.
Sigue leyendo
O vuelve a la guía de design engineering.
Instalarlo es el paso uno
Lo que no está en la documentación es cómo pedirle lo que admiras. Taste hacking es un curso en vivo, en español, para construir con Claude Code interfaces, animaciones y videos con criterio.
Anótate a la edición 02