Taste hacking

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.

Captura de claude.com
claude.com · La página de Claude Code: la misma sesión corre en la terminal, la app de escritorio, el IDE o 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.

macOS, Linux o WSLshell
  1. curl -fsSL https://claude.ai/install.sh | bash
Windows · PowerShellshell
  1. irm https://claude.ai/install.ps1 | iex
Windows · CMDshell
  1. curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
macOS · Homebrewshell
  1. brew install --cask claude-code
Windows · WinGetshell
  1. 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.

Comprobarshell
  1. claude --version
  2. claude doctor

Fuente: instalación avanzada en la documentación de Claude Code, revisada el 21 de noviembre de 2026.

Captura de code.claude.com
code.claude.com · El inicio rápido oficial, ya traducido al español. Úsalo para todo lo que esta guía no cubre.

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.

Tu primera sesiónshell
  1. cd <carpeta de tu proyecto>
  2. 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.
  • /help lista los comandos, /clear empieza una conversación nueva y claude -c retoma 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.mdmarkdown
# 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

claude no 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