Guía de incorporación · Dani

CreaRack Pro · Entorno de desarrollo Windows Última actualización: Abril 2026

Antes de empezar

Necesitarás que Edu te invite como colaborador en GitHub. Dile tu username de GitHub y él te añadirá a los dos repos:

• CreaRackSL/CreaRack-Pro → acceso Write
• CreaRackSL/CreaRackSL-workspace → acceso Write

Paso 1 · Herramientas necesarias

Instala en orden:

1.1 Git para Windows

• Descarga: https://git-scm.com/download/win
• Durante la instalación, deja todas las opciones por defecto
• Incluye Git Bash (útil como alternativa a PowerShell)

1.2 Docker Desktop

• Descarga: https://www.docker.com/products/docker-desktop/
• Requiere Windows 10/11 con WSL2 activado
• Si WSL2 no está activo, Docker Desktop lo instala automáticamente

1.3 Claude Code CLI

• Requiere Node.js 18+: https://nodejs.org/
• Una vez instalado Node.js, en PowerShell:

npm install -g @anthropic-ai/claude-code

• Necesitarás una cuenta en claude.ai con plan Max o Pro
• Autenticación:

claude login

1.4 Editor de código

VS Code recomendado: https://code.visualstudio.com/

Paso 2 · Clonar los repositorios

Abre PowerShell y ejecuta:

# Crear directorio de trabajo
mkdir C:\dev
cd C:\dev

# Clonar el código de la aplicación
git clone https://github.com/CreaRackSL/CreaRack-Pro.git

# Clonar el workspace de contexto Claude
git clone https://github.com/CreaRackSL/CreaRackSL-workspace.git

Cuando te pida credenciales usa tu username y contraseña de GitHub (o token personal si tienes 2FA activado).

Paso 3 · Arrancar el entorno de desarrollo

cd C:\dev\CreaRack-Pro

# Arrancar todos los servicios (PostgreSQL, Valkey, VictoriaMetrics)
docker compose up -d

# Verificar que todo está corriendo
docker compose ps

Deberías ver estos contenedores en estado running:

Verificar que funciona

Abre el navegador en http://localhost:8000

• Usuario: admin
• Contraseña: dev_password_123

Si ves el dashboard de CreaRack Pro, todo está correcto.

Paso 4 · Primera sesión con Claude Code CLI

cd C:\dev\CreaRack-Pro
claude

Claude Code leerá automáticamente el CLAUDE.md de la raíz del proyecto y ya conocerá todo el contexto: stack, arquitectura, convenciones y reglas del equipo.

Para verificar que ha cargado el contexto correctamente pregúntale:

¿Has leído el CLAUDE.md automáticamente al iniciar?

Debería responder con detalles del proyecto.

Paso 5 · Flujo de trabajo diario

Antes de empezar a trabajar

cd C:\dev\CreaRack-Pro
git pull origin main
docker compose up -d
claude

Durante el trabajo

Claude Code gestiona los commits. Cuando termines una tarea Claude te pedirá confirmación antes de hacer push.

Si cambias templates, JS o CSS

docker compose restart web

Ver logs en tiempo real

docker compose logs -f web

Ejecutar tests

docker compose exec web python -m pytest tests/api/ -v

Paso 6 · Coordinación con Edu

Trabajaréis en áreas distintas para minimizar conflictos:

Regla básica: antes de tocar un archivo que no es de tu área, avisa a Edu por WhatsApp/Slack.

Siempre hacer git pull antes de empezar a trabajar.

Paso 7 · Workspace de Claude (claude.ai)

Para tareas que no requieren Claude Code CLI (consultas, documentación, revisiones):

1. Abre https://claude.ai en el navegador
2. Abre C:\dev\CreaRackSL-workspace\profiles\profile-dev.md
3. Copia el bloque “prompt de inicio”
4. Pégalo como primer mensaje en una sesión nueva
5. Claude ya conoce todo el contexto del proyecto

Mantener el workspace actualizado:

cd C:\dev\CreaRackSL-workspace
git pull origin main

Referencia rápida

Problemas frecuentes

Docker Desktop no arranca → Verificar que WSL2 está activo: wsl --status en PowerShell

git push pide contraseña cada vez → Configurar credenciales: git config --global credential.helper manager

Puerto 8000 ocupado → docker compose down y volver a docker compose up -d

Claude Code no encuentra el proyecto → Verificar que estás en C:\dev\CreaRack-Pro antes de ejecutar claude

Cualquier duda, pregunta a Edu directamente o abre una sesión de Claude con el perfil DEV.