Setup de equipo nuevo desde cero

CreaRack Pro · Instalación del entorno de trabajo (Windows) Última actualización: 03-09-2026 (menú de arranque del acceso directo: Fable por defecto, Opus + Fable asesor como ahorro de crédito; los subagentes nunca en Fable). Anterior: 13-08-2026 (raíz de trabajo PARAMETRIZADA — el método ya no asume C:\dev; Python añadido a prerequisitos; hooks de sesión descritos con el esquema consolidado s99; paso nuevo del menú Correo; nota de la estación compartida de Dani/Txell). Anterior: 03-08-2026 (dieta de plugins + gate Regla 0 en plugin method). Base: 24-05-2026 (s82 · fuente única creada para acabar con el drift entre los 3 onboardings)

Esta es la guía ÚNICA de instalación desde cero. Sirve para cualquier miembro del staff (Edu, Dani, Txell o futuros fichajes). El proceso de instalación es idéntico para todos — solo cambian tus datos personales y tu token, que están tabulados abajo.

Lo específico de tu rol (qué pedirle a Claude, tus áreas de foco, tu flujo diario) NO está aquí: vive en tu ficha personal → [[workspace—onboarding—onboarding-edu]] · [[workspace—onboarding—onboarding-dani]] · [[workspace—onboarding—onboarding-txell]].

Sigue los pasos 1 → 5 en orden, en una terminal PowerShell 7. Cada paso te deja listo para el siguiente. Si algo falla, no improvises: copia el error y pásaselo a Edu o a tu propio Claude.

La raíz de trabajo (nuevo 13-08-2026)

Todos los repos del equipo viven juntos bajo una carpeta raíz de tu perfil:

El método deriva sus rutas de donde está clonado (parametrización 13-08-2026): scripts, hooks y settings funcionan igual en cualquier raíz. En esta guía, <raíz> significa tu raíz de trabajo.

Estación compartida Dani/Txell: el plan de esa máquina (2 perfiles Windows en un “terminal server”, software base a nivel máquina, ejecución del onboarding por SSH con los “turnos de Edu” para credenciales) está en [[decision—20260812—estacion-compartida-dani-txell]]. Esta guía sigue siendo la fuente de los pasos; aquella, del despliegue concreto.

Antes de empezar

• Ordenador con Windows 11 y conexión a internet.

• Una cuenta de GitHub (el Paso 2 la crea si no la tienes). Edu te invitará al Org CreaRackSL como Owner.

• Suscripción a Claude (plan Max) — incluye Claude Code.

• 3 credenciales que te pasa Edu por canal privado (Signal, 1Password), nunca por email ni chat público:

  1. BibToken — tu Bearer token personal (uno distinto por miembro). Identifica al usuario en el MCP del workspace.
  2. CfAccessClientId — Service Token Client ID de Cloudflare Access (el mismo para los 3).
  3. CfAccessClientSecret — Service Token Client Secret de CF Access (el mismo para los 3). Solo se muestra una vez al crearlo; si se pierde, hay que regenerarlo desde CF Zero Trust.

  Los 3 son obligatorios desde s57 (12-05-2026), tras eliminar las policies bypass everyone de las apps CF Access Critical del workspace.

Las herramientas (Git, gh, Node, Python, PowerShell 7…) las instalas tú en los Pasos 1 y 3 — no hace falta tener nada preinstalado. (En una máquina compartida, el software de esos dos pasos se instala una vez a nivel máquina con --scope machine cuando el instalador lo soporte; lo per-perfil — Paso 4 en adelante — se repite en cada perfil.)

Tus datos personales (para el Paso 4)

Paso 1 · Instalar PowerShell 7 y ponerlo por defecto

Todo el onboarding y el trabajo diario se hace en PowerShell 7, no en el “Windows PowerShell 5.1” que trae Windows de fábrica (los scripts del método y los hooks lo dan por hecho). Instálalo lo primero. Abre PowerShell (busca “PowerShell” en el menú inicio) y pega:

winget install --id Microsoft.PowerShell --source winget --accept-source-agreements --accept-package-agreements

Y déjalo como terminal por defecto para que todo se abra ya en pwsh 7:

1. Abre Terminal de Windows (búscala en el menú inicio; en Windows 11 viene instalada).
2. Flecha hacia abajo en la barra de pestañas → Configuración (o pulsa Ctrl + ,).
3. Inicio → Perfil predeterminado → elige PowerShell (el de la versión 7.x, icono negro), no “Windows PowerShell”.
4. Inicio → Aplicación de terminal predeterminada → elige Terminal de Windows.
5. Guardar. Cierra y vuelve a abrir la terminal.

Comprueba que estás en pwsh 7 con $PSVersionTable.PSVersion — debe empezar por 7. A partir de aquí, todos los comandos del onboarding se ejecutan en esta terminal.

Paso 2 · Cuenta de GitHub e invitación al Org

1. Si no tienes cuenta, créala en https://github.com/signup con tu email de empresa.
2. Dile tu username a Edu.
3. Recibirás un email “Invitation to join CreaRackSL”. Acéptala desde https://github.com/orgs/CreaRackSL/invitation logueado con tu cuenta.
4. Una vez aceptada, eres Owner del Org → acceso admin a los 3 repos (CreaRack-Pro, CreaRackSL-workspace, claude-method). Igualdad de accesos del staff (Regla 24).

Las URLs de los repos no cambian aunque GitHub migrara de User a Org (redirects automáticos).

Paso 3 · Instalar las herramientas base (prerequisitos)

El script del Paso 4 (bootstrap-profile.ps1) NO instala estas herramientas — solo comprueba que están. En una máquina nueva tienes que instalarlas tú primero, o el Paso 4 fallará diciendo que falta algo (le pasó a Txell en s82: gh no estaba y el primer comando daba error).

La vía más rápida es winget, que viene de serie en Windows 11. En PowerShell 7:

winget install --id Git.Git           -e --accept-source-agreements --accept-package-agreements
winget install --id GitHub.cli         -e --accept-source-agreements --accept-package-agreements
winget install --id OpenJS.NodeJS.LTS  -e --accept-source-agreements --accept-package-agreements
winget install --id Python.Python.3.13 -e --accept-source-agreements --accept-package-agreements

(PowerShell 7 ya lo instalaste en el Paso 1.)

Python es OBLIGATORIO (añadido 13-08-2026, faltaba en esta guía): los checks del pre-commit y los hooks del plugin (gate Regla 0, memory surfacer) son Python — sin él no ejecutan, y /method-doctor lo marca en rojo.

➡ Cierra esa ventana de PowerShell y abre una nueva (para que reconozca git, gh, node, python y pwsh recién instalados).

En la ventana nueva, instala las dos herramientas que van por Node:

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

Por último, autentica gh (lo necesitas para descargar el script del Paso 4 y para que clone los repos privados del equipo):

gh auth login        # elige: GitHub.com → HTTPS → "Login with a web browser"

Resumen de lo que el bootstrap del Paso 4 verifica: git · gh CLI · Node.js 18+ · PowerShell 7+ · pnpm · Claude Code · Python · bash (lo incluye Git como Git Bash). Docker solo lo necesitas si vas a tocar la app en local (perfil dev) — ver Paso 6; el COO no lo necesita.

Nota sobre bash: Git lo instala pero a veces no lo añade al PATH. No tienes que hacer nada — el bootstrap lo detecta solo en C:\Program Files\Git\bin (fix s82). Si no lo encuentra: $env:Path += ";C:\Program Files\Git\bin".

Si prefieres instaladores gráficos: Git → https://git-scm.com/download/win · gh → https://cli.github.com · Node.js LTS → https://nodejs.org · PowerShell 7 → https://aka.ms/powershell

Paso 4 · Setup con un solo comando (bootstrap-profile.ps1)

Un único script configura todo en ~5 minutos: verifica prereqs, clona los 3 repos, configura Claude Code (idioma, hooks, permisos, memorias), guarda tus tokens y registra el MCP del workspace.

Ten a mano las 3 credenciales que te pasó Edu (ver “Antes de empezar”). En PowerShell 7:

# 1. Comprueba que gh está logueado (claude-method es PRIVADO y hay que clonar los repos)
gh auth status
#    Si no: gh auth login → GitHub.com → HTTPS → "Login with a web browser"

# 2. Descarga el bootstrap AUTENTICADO (con repo privado, "irm" a raw.githubusercontent da 404)
gh api repos/CreaRackSL/claude-method/contents/onboarding/bootstrap-profile.ps1 -H "Accept: application/vnd.github.raw" | Out-File -Encoding utf8 "$env:TEMP\bootstrap-profile.ps1"

# 3. Ejecuta el bootstrap. ⚠ SUSTITUYE los valores entre <...> por TUS datos
#    (tabla "Tus datos personales" arriba) y los 3 tokens REALES que te pasó Edu.
#    -DevRoot es tu RAÍZ DE TRABAJO: omítelo en un PC propio (default C:\dev);
#    en la estación compartida pásalo: -DevRoot "$env:USERPROFILE\Claude"
& $env:TEMP\bootstrap-profile.ps1 `
    -DevName "<TU_NOMBRE>" `
    -DevRole "<TU_ROL>" `
    -BibToken "<PEGA_AQUI_TU_BIBTOKEN_REAL>" `
    -CfAccessClientId "<PEGA_AQUI_EL_CF_CLIENT_ID_REAL>" `
    -CfAccessClientSecret "<PEGA_AQUI_EL_CF_CLIENT_SECRET_REAL>" `
    -GitUserName "<TU_NOMBRE>" `
    -GitUserEmail "<TU_EMAIL>" `
    -GitHubUsername "<TU_GITHUB_USERNAME>"

⚠ Identidad de git (lección s82): -GitUserName y -GitUserEmail son importantes. Sin ellos tu git no tiene identidad y git commit falla en silencio — el backup de tu memoria queda staged sin subir a GitHub (le pasó a Txell). Coge tu email de la tabla de arriba.

⚠ Pega los tokens REALES, no los placeholders <...> ni "...". El error nº1 de este onboarding (s82) fue dejar un placeholder: el MCP se registra pero bib_stats() falla con “not connected”. El bootstrap aborta si detecta un placeholder, pero pega los valores de verdad igualmente.

Por qué no irm: claude-method es privado y raw.githubusercontent.com solo sirve repos públicos sin token (da 404). gh api usa tu sesión de gh CLI, necesaria de todos modos para clonar los 3 repos.

⚠ NO añadas el connector workspace.crearack.com en https://claude.ai/settings/connectors. El bootstrap ya registra el MCP vía .mcp.json local con los 3 headers correctos (Bearer + CF-Access-Client-Id + CF-Access-Client-Secret). El connector web de claude.ai usa OAuth, no soporta headers custom → sus requests llegan a CF Access sin los 2 headers Service Token y reciben 403. Además tiene precedencia sobre el .mcp.json local y rompe el MCP. La única razón para abrir claude.ai web es gestionar paneles propios (routines, settings de cuenta).

Qué hace el script en orden:

1. Verifica prereqs (git, node, pnpm, pwsh 7+, gh, python, bash, claude, docker opcional). Si falta algo, te muestra la URL de instalación.
2. Crea tu raíz de trabajo (-DevRoot; default C:\dev) y clona los 3 repos: CreaRack-Pro, CreaRackSL-workspace, claude-method.
3. Configura Claude Code: settings.json (idioma español, permisos — additionalDirectories apunta a TU raíz, token {WORK_ROOT} del settings-base) y los 2 hooks vivos consolidados (s99): SessionStart → session-start.ps1 (git pull + hot-cache + timezone Europe/Madrid + sync del método + pulso del NEXT) y Stop → stop-worklog-reminder.ps1 (recordatorio WORKLOG + auto-backup + aviso de ronda). Copia memorias compartidas, guarda BIB_MCP_TOKEN / CF_ACCESS_CLIENT_ID / CF_ACCESS_CLIENT_SECRET como variables de usuario, y registra el MCP con los 3 headers.
4. Instala el harness en CreaRack-Pro y CreaRackSL-workspace: pre-commit (checks de arquitectura + Biblioteca) y pre-push (“main es una roca”: bloquea empujar sobre una base vieja y avisa para rebasar) — los hooks se hornean con la ruta REAL de tu claude-method (13-08-2026), sea cual sea tu raíz. Además converge la config git del equipo (rerere, que auto-resuelve conflictos de docs repetidos) — todo automático, sin pasos manuales que recordar (s101).
5. Registra los plugins del método (s186 · dieta 28-07-2026 · gate 03-08-2026): method (núcleo genérico — roast, storm, grill, divergir, plan-review, diagnose, os-audit, iniciar-proyecto… + el gate Regla 0, que vive aquí desde el 03-08-2026 y es opt-in por marcador .claude/bib-gate.json de cada repo — los repos de CreaRack ya lo llevan commiteado) y crearack (harness del equipo: memory surfacer, ritual “apaga”, anti here-string en Bash + skills secre/method-doctor/method-status/self-harness + agente vigia). Los opcionales method-design (15 skills design-* + agente design-collaborator) y method-marketing (frameworks GTM) van off por defecto — se activan con /plugin si tu área los pide (Txell los declinó en s245; no re-proponer). Nada que copiar: los plugins se leen en vivo del repo claude-method y el pull de cada arranque los mantiene al día. Las skills se invocan con prefijo: /method:roast, /crearack:secre (el autocompletado las encuentra escribiendo el nombre a secas).
6. Crea el acceso directo de escritorio ([4d]): “Claude CreaRack” (devs, sobre CreaRack-Pro) o “Claude Workspace” (COO, sobre el workspace).
7. Muestra los pasos manuales finales.

Si PowerShell pide permiso para ejecutar scripts, responde Y o A.

Opción B · Máquina con los repos ya clonados

Si ya tienes los 3 repos bajo tu raíz de trabajo (reconfigurando una máquina con Claude Code ya instalado), salta la clonación y usa directamente (sustituye <raíz> por la tuya — C:\dev en el PC de Edu):

& "<raíz>\claude-method\onboarding\setup-claude-code.ps1" `
    -DevName "<TU_NOMBRE>" `
    -ProjectDir "<raíz>\CreaRack-Pro" `
    -WorkspaceDir "<raíz>\CreaRackSL-workspace" `
    -DevRole "<TU_ROL>" `
    -McpUrl "https://workspace.crearack.com/api/mcp" `
    -BibToken "<TU_BIBTOKEN_REAL>" `
    -CfAccessClientId "<CF_CLIENT_ID_REAL>" `
    -CfAccessClientSecret "<CF_CLIENT_SECRET_REAL>" `
    -GitUserName "<TU_NOMBRE>" `
    -GitUserEmail "<TU_EMAIL>" `
    -GitHubUsername "<TU_GITHUB_USERNAME>"

Curiosidad para cuando tengas tiempo: si quieres ver “por dentro” cómo funciona el perfil Claude del equipo (qué vive en tu PC, qué es compartido, cómo se actualiza), Edu mantiene claude-method/onboarding/CLAUDE-PROFILE-ARCHITECTURE.md con diagrama incluido. No es obligatorio.

Proyectos NUEVOS (no CreaRack): esta guía incorpora a una persona al entorno de CreaRack. Para arrancar un proyecto nuevo con el método completo y su propia Biblioteca, el camino es la skill /method:iniciar-proyecto — ver claude-method/README.md § “Onboarding de un proyecto NUEVO” y guides/PROJECT_INITIALIZER.md (03-08-2026).

Paso 5 · Primera sesión con Claude Code + smoke test

Abre una terminal nueva de PowerShell (para que las credenciales del Paso 4 estén cargadas) y arranca Claude Code en el repo que corresponda a tu rol (bajo TU raíz de trabajo):

# Devs (Edu, Dani):
cd <raíz>\CreaRack-Pro
claude

# COO (Txell):
cd <raíz>\CreaRackSL-workspace
claude

Claude leerá automáticamente el CLAUDE.md del repo y cargará todo el contexto (stack, arquitectura, convenciones, reglas, tu rol). No tienes que explicarle nada.

Verificar que todo funciona (obligatorio antes de darte por instalado)

En una terminal nueva:

claude mcp list

Debe mostrar crearack-workspace: ✓ Connected (no “failed”/“not connected”). Si sale fallido, casi seguro es un token mal pegado en el Paso 4 — avisa a Edu con el resultado.

Luego, dentro de claude, pide:

Ejecuta bib_stats() y dime el resultado.

Debe devolver contadores del grafo (>3000 nodos, >4000 edges). Si responde con números, remátalo con /crearack:method-doctor — debe salir VERDE (0 issues). Con eso, tu onboarding está completo. ✅

El acceso directo del escritorio que crea el Paso 4 (“Claude CreaRack” / “Claude Workspace”) es la forma cómoda de abrir Claude a partir de ahora: doble clic y dentro. Recrearlo a mano:

pwsh <raíz>\CreaRack-Pro\scripts\windows\install-claude-shortcut.ps1

El menú de arranque del acceso directo (desde el 02-09-2026)

Al hacer doble clic, antes de abrir Claude aparece una pregunta de una tecla:

Como arranca Claude Code?
  [1] Fable conduce, sin asesor                        (defecto)
  [2] Ahorro: Opus 5 conduce, sin asesor
  [3] Ahorro con segunda mirada: Opus 5 conduce + Fable asesora
  Enter, o 10 s sin tecla, = [1]

• [1] Fable es el modo normal: el modelo más capaz lleva la sesión entera. Si no tocas nada, a los 10 segundos arranca así.
• [2] Ahorro pone a Opus 5 al mando, sin asesor. Es más barato que Fable en la cuota. Úsalo los días de cuota justa y, sobre todo, en trabajo de seguridad (auditorías): ahí Fable salta solo a un Opus más viejo por sus propias medidas, así que arrancar ya en Opus 5 evita el cambio de modelo a media faena.
• [3] Ahorro con segunda mirada es como el [2] pero además Fable actúa de asesor en los momentos difíciles (antes de comprometerse con un enfoque, cuando un error se repite, antes de dar por terminada una tarea). La primera vez, Claude puede pedir un consentimiento único con /model fable; si el asesor no arranca, el lanzador lo dice y sigue con Opus 5 solo. Ojo: ese asesor Fable puede quedarse mudo justo en trabajo de seguridad, así que para auditorías es mejor el [2].
• ¿Quieres un icono que arranque siempre en un modo, sin pregunta? Crea un segundo acceso directo fijándolo:

  pwsh <raíz>\CreaRack-Pro\scripts\windows\install-claude-shortcut.ps1 -ShortcutName 'Claude Ahorro' -Mode ahorro

  (-Mode trabajo o -Mode fable para los otros). El acceso directo normal sigue mostrando el menú.

Sea cual sea el modo, los ayudantes que Claude lanza por su cuenta (subagentes) nunca corren en Fable: el propio entorno lo frena y sugiere el modelo adecuado. Es la protección que nació el 29-08-2026, cuando un abanico de ayudantes en Fable agotó la cuota en una tarde. Detalle técnico: [[feature—harness—advisor-tool]].

Paso 6 · Docker y build del Agente (solo perfil dev)

Solo si vas a levantar la app de CreaRack-Pro en local o compilar el Local Agent. El COO no necesita nada de este paso. El equipo además prueba siempre en producción, así que esto no bloquea el resto del onboarding — puedes dejarlo para después.

Docker (levantar la app en local)

winget install --id Docker.DockerDesktop -e --accept-source-agreements --accept-package-agreements

Docker Desktop requiere WSL2 y virtualización por hardware activada en BIOS. Tras instalar, reinicia, abre Docker Desktop y espera a “running”. Luego:

cd <raíz>\CreaRack-Pro
docker compose up -d      # PostgreSQL, Valkey, VictoriaMetrics, web (Django), worker
docker compose ps         # todos en 'running'

App en http://localhost:8000 · usuario admin / dev_password_123.

Inno Setup 6 (solo si vas a compilar el Local Agent)

Desde Agent 2.17.0 el instalador CreaRackAgent-Setup.exe se compila con Inno Setup 6 — build_agent.bat lo exige y aborta si no lo encuentra:

winget install --id JRSoftware.InnoSetup -e --accept-source-agreements --accept-package-agreements

build_agent.bat busca ISCC.exe en %LOCALAPPDATA%\Programs\Inno Setup 6 y en %ProgramFiles(x86)%\Inno Setup 6 (ambas rutas de instalación por defecto valen). Para el build completo necesitas además Python + PyInstaller y la clave de firma Ed25519 del paquete — el pipeline entero está en la wiki [[crearack-tech—guides—agent-distribution]].

Paso 7 · Menú Correo (opcional, por miembro · 12-08-2026)

El menú Correo del workspace (informe del buzón + chat de la secretaria + cola de peticiones) se alimenta de una pasada desatendida que corre en TU máquina con TU sesión de Claude. Para activarlo en tu perfil:

1. OAuth de Zoho Mail: en una sesión de Claude Code, conecta el MCP zoho-mail con tu buzón (turno de credenciales: las teclea el dueño del buzón o Edu).

2. Tarea programada de la pasada (8:00 / 13:00 / 18:00): pwsh <raíz>\claude-method\harness\correo-install-task.ps1 — instala la tarea en TU perfil de Windows.

3. Comprueba tras la primera pasada que el menú Correo del workspace muestra tu informe (pill de cabecera con hora fresca). Logs en ~/.claude/correo/logs/.

4. Token de un año para las pasadas desatendidas (obligatorio desde el 22-09-2026). Una pasada claude -p no renueva la sesión normal de Claude Code: el 20-09-2026 caducaron a la vez las de los tres perfiles de la estación y durante dos días Correo, Ingest, HelpDrift y Ronda murieron con Failed to authenticate: OAuth session expired sin que nadie avisara (task #334). En una PowerShell del perfil (RDP), con tu cuenta de Claude:

   claude setup-token          # abre el navegador; entra con TU cuenta; imprime un token que dura un año
   [Environment]::SetEnvironmentVariable('CLAUDE_CODE_OAUTH_TOKEN','<pega el token>','User')
   [Environment]::GetEnvironmentVariable('CLAUDE_CODE_OAUTH_TOKEN','User').Length   # debe imprimir un número (108); nunca imprimas el token

   Guarda el token en el gestor de contraseñas del equipo. Las tareas programadas lo cogen en su siguiente arranque; verifica con la primera pasada real (log de más de 74 bytes). Vale igual para cualquier perfil nuevo que corra trabajos desatendidos.

En la estación compartida las sesiones RDP desconectadas siguen vivas — la tarea corre igual con la sesión desconectada. No cerrar sesión (logoff), solo desconectar.

Detalle del sistema: [[feature—workspace—correo-menu-f0]]. La pasada NUNCA envía correos: leer + publicar informe + preparar borradores; el envío siempre es manual.

Problemas frecuentes

Véase también

• [[workspace—onboarding—onboarding-edu]]
• [[workspace—onboarding—onboarding-dani]]
• [[workspace—onboarding—onboarding-txell]]
• [[workspace—guias—team-processes]]
• [[decision—20260812—estacion-compartida-dani-txell]]
• [[feature—workspace—correo-menu-f0]]