Tu primer workflow

Instalación y Setup

• Requisitos: Node.js 18+, plan Anthropic (Max/Team), terminal.
• Instalar: npm install -g @anthropic-ai/claude-code
• Verificar: claude --version
• Iniciar: claude (autenticación vía navegador en el primer uso).
• Troubleshooting: 90% de errores son por Node viejo. Verifica node -v (≥18) y npm -v.

Estructura .claude/

Directorio de configuración del proyecto. Sin él, Claude Code no conoce tu contexto.

Creación rápida

mkdir -p .claude/commands .claude/docs .claude/memory
touch .claude/CLAUDE.md .claude/settings.json

Propósito de cada archivo

• CLAUDE.md: Instrucciones del proyecto (obligatorio).
• settings.json: Config técnica (hooks, permisos, MCP).
• commands/: Prompts reutilizables con /.
• docs/: Documentación leíble bajo demanda.
• memory/: Notas persistentes entre sesiones.

CLAUDE.md: El Cerebro

Es tu README para la IA. Define quién eres, stack y reglas.

Estructura recomendada

• Stack: Backend, frontend, DB, deploy.
• Reglas de código: Idioma, tests, secretos, validación.
• Convenciones naming: Endpoints, funciones, componentes, env vars.
• Errores a evitar: Logging incorrecto, SQL sin parametrizar, commit de .env.
• Contexto de negocio: Tipo de SaaS, multi-tenancy, etc.

Workflow Avanzado

Hooks

• Automatizan acciones en eventos (ej: pre-commit).
• Definidos en settings.json.

Agentes

• Sub-agentes con roles específicos (ej: revisor de código).
• Se invocan dentro de una sesión para tareas concretas.

Comandos reutilizables

• Archivos en .claude/commands/ (ej: review.md).
• Se invocan con /nombre-comando.
• Ejemplo: /review para code review automático.