---
asset_id: SOP-EL-SX-InstalacionClaudeCodeLinux-v01
version: v01
tipo: SOP — Standard Operating Procedure (procedimiento técnico)
status: Active · v01 · Pendiente Ratificación Victor
owner: Victor Heredia
sherpa: Jay
ratificador: Victor Heredia
fecha_creacion: 2026-06-10
fecha_ultima_actualizacion: 2026-06-10
intellbank: IB-EL-EmpowerLabs
subbank: PB-EL-Project-Bank / PB-WORX-Worx
ejecutado_por: Sistemas / Soporte técnico
contexto_base: XP-EL-WORX-ArranqueBasico-v01
proposito: Instalar y dejar operando un SherpaX WORX sobre Claude Code en Linux, para usuarios que NO pueden instalar Cowork. Cubre operadores internos (EmpowerLabs) y externos (Capa Específica intercambiable). Es la variante Linux/CLI del SOP de instalación Cowork.
referencia_canonica: SP-EL-WORX-SetupSherpaX-Guion-v01 · XP-EL-WORX-ArranqueBasico-v01 · XP-EL-SX-StarterLinux-v01 · SOP-EL-SX-InstalacionCowork-v01 · CP-EL-WORX-EmpowerLabsComoOrganizacion-v01 (matriz §5)
activo_relacionado: XP-EL-SX-StarterLinux-v01 (starter pack que este SOP ejecuta)
tags: [SOP, instalacion, claude-code, linux, cli, sherpax, sin-cowork, worx, starter-pack, 2-capas]
---

# SOP · Instalación de SherpaX sobre Claude Code en Linux
## La vía CLI para usuarios sin Cowork — misma metodología, otra superficie

> **Quién lo corre:** sistemas / soporte técnico. **No** el usuario final.
> **Cuánto toma:** ~10-15 min.
> **Resultado:** el usuario abre Claude Code en el vault, su SherpaX lo reconoce, y opera bajo WORX igual que en Cowork.
> **Principio rector:** el SherpaX **no vive en Cowork ni en Claude Code** — vive en el **plugin `worx-empowerlabs`**. Cowork y Claude Code son dos superficies que cargan el mismo plugin. La metodología, los comandos y la experiencia son idénticos; solo cambia la envoltura y la instalación.

---

## 0. Cuándo usar este SOP (vs. el de Cowork)

| Usa este SOP (Linux/CLI) cuando… | Usa `SOP-EL-SX-InstalacionCowork-v01` cuando… |
|---|---|
| El usuario corre Linux y **no puede instalar Cowork**. | El usuario tiene Cowork disponible (Mac/Windows). |
| Se prefiere operar desde terminal. | Se prefiere la app de escritorio. |

Ambos terminan en el mismo handshake: **instalación física → `/SetupSherpaX` → `/ArrancaWorX`**.

---

## 1. Prerequisitos

1. **Distro Linux soportada** (Ubuntu 20.04+, Debian 10+, Fedora 36+, Arch, Alpine 3.19+), 4 GB+ RAM, conexión a internet.
2. **Cuenta de Claude con plan activo** (Pro, Max, Team o Enterprise). El plan **free no sirve**.
3. **Acceso al vault Reinventaverse** — repo git para clonar, o sincronización local (Obsidian/Drive), o credenciales del MCP de IntelliBanks (variante confidencial).
4. **Starter pack `XP-EL-SX-StarterLinux-v01`** disponible (clonado o copiado).
5. **Fuente del marketplace WORX confirmada** — dónde está publicado el plugin `worx-empowerlabs`. *(Dependencia abierta · ver NEXTs.)*

> Si falta cualquier prerequisito, el SOP **se detiene** y remite a resolverlo. No se improvisa.

---

## 2. Las dos vías de acceso al vault (elegir antes de instalar)

| Vía | Cuándo | Cómo |
|---|---|---|
| **Carpeta local** (default) | Operador interno, o externo sin restricción dura. | El vault vive como carpeta; Claude Code la lee/escribe nativamente. |
| **MCP IntelliBanks** | El vault **no** puede vivir local (cliente externo / confidencialidad alta). | Servidor MCP de la IntelliBanks app; se configura `.mcp.json` en el folder del vault. |

La carpeta local es la superficie más simple y el default recomendado. La vía MCP solo se activa cuando el caso lo exige.

---

## 3. Secuencia de instalación (paso a paso para sistemas)

El `XP-EL-SX-StarterLinux-v01/setup.sh` automatiza los pasos 1-4. Esta sección documenta qué hace cada uno y cómo validarlo manualmente.

### Paso 1 · Instalar Claude Code
```bash
curl -fsSL https://claude.ai/install.sh | bash
# Si 'claude' no se encuentra, agregar al PATH:
export PATH="$HOME/.local/bin:$PATH"   # y persistir en ~/.bashrc
```
✅ **Pasa:** `claude --version` responde.

### Paso 2 · Autenticar
```bash
claude   # dispara login en navegador con la cuenta Claude
```
✅ **Pasa:** sesión iniciada con un plan válido.

### Paso 3 · Disponer el vault localmente
- **Vía local:** clonar/sincronizar el vault a una carpeta (ej. `~/Reinventaverse`).
- **Vía MCP:** copiar `.mcp.json.example` → `.mcp.json` dentro del folder del vault y completar host + token reales.

✅ **Pasa:** el folder del vault existe y es legible (o el MCP responde).

### Paso 4 · Sembrar la config WORX e instalar el plugin
El starter siembra `.claude/settings.json` + `.claude/CLAUDE.md` en el folder del vault, registra el marketplace e instala el plugin:
```bash
claude plugin marketplace add EmpowerLabs/worx-marketplace
claude plugin install worx-empowerlabs@worx
```
> **Nota crítica (limitación conocida):** pre-hornear `settings.json` registra el marketplace y marca el plugin habilitado, pero **no descarga el plugin solo** — hay un *trust prompt* en la 1ª sesión y, según versión, el `/plugin install` puede tener que correrse a mano. El `setup.sh` lo fuerza por CLI; si el CLI no lo soporta, se completa en la 1ª sesión con `/plugin install worx-empowerlabs@worx`.

✅ **Pasa:** al abrir `claude` en el vault, los comandos WORX (`/arrancaroom`, `/SetupSherpaX`…) existen.

### Paso 5 · `/SetupSherpaX` (validación + perfil + luz verde)
Con todo arriba, correr `/SetupSherpaX` (mismo guion que en Cowork, ver `SP-EL-WORX-SetupSherpaX-Guion-v01`):
- valida la lectura del vault,
- escribe `DC-EL-PerfilOperador-[Nombre]-v01` en `02-PerfilOperador`,
- enciende `luz_verde: true`.

### Paso 6 · Cierre
> "Tu SherpaX ya está configurado sobre Claude Code. Abre tu terminal, entra al vault con `cd` y corre `claude`. Luego corre `/ArrancaWorX` — tu SherpaX te va a reconocer y te guía desde ahí."

---

## 4. Modelo de operación (día a día del usuario)

1. Abrir terminal → `cd` a la carpeta del vault → `claude`.
2. `/arrancaroom` (reflejo #1) → carga contexto WORX, reconoce al operador por su perfil.
3. Trabajar conversando; el SherpaX lee/escribe el vault respetando **naming BMF + ubicación + tripleta**.
4. Cerrar con `/wx-mindia` / `/wx-resumenroom`.

Única diferencia de experiencia vs. Cowork: **terminal en lugar de ventana de escritorio**. Mismos comandos, mismas reglas, mismo vault.

---

## 5. Tabla de validaciones · criterio y falla

| # | Validación | Criterio de ✅ | Si ❌ |
|---|---|---|---|
| 1 | Prerequisitos | Distro + plan + vault + starter + marketplace listos | Detener · resolver prerequisito |
| 2 | Claude Code instalado | `claude --version` responde | Revisar instalación / PATH |
| 3 | Autenticación | Sesión con plan válido | Revisar plan de la cuenta (free no sirve) |
| 4 | Acceso al vault | Lee un archivo de IB-EL (o el MCP responde) | Revisar sync local / `.mcp.json` / permisos §5 |
| 5 | Plugin WORX cargado | `/arrancaroom` existe en la sesión | `/plugin install worx-empowerlabs@worx` a mano |
| 6 | Perfil + luz verde | Existe `DC-EL-PerfilOperador-[Nombre]-v01` con `luz_verde: true` | Reintentar `/SetupSherpaX` |

---

## 6. Capa de 2 niveles (interno vs. externo)

- **Capa Universal WORX** (reglas, comandos, identidad SherpaX) → viaja intacta.
- **Capa Específica** → para un cliente externo se intercambia solo: el `MARKETPLACE`/`PLUGIN` en `setup.sh` + `settings.json`, y el `CLAUDE.md` con su contexto organizacional. Mismo patrón de 2 capas del `XP-EL-WORX-ArranqueBasico-v01`.

---

## 7. Reglas inviolables (heredadas de WORX)

- Validar **naming BMF + ubicación** antes de escribir al vault. Todo a `IB-EL-EmpowerLabs/...`, nunca a `Projects/`, `Companies/`, `CloudVault/`, `00-Inbox`.
- Cada activo nuevo lleva **Owner + Sherpa + Ratificador**.
- **Gate G0 (Brain OS-First):** consultar el vault antes de producir activos canónicos.
- No reescribir los guiones técnicos (`/SetupSherpaX`, `/ArrancaWorX`); ejecutarlos y conectarlos.

---

## PIEZAS RELACIONADAS

- **Starter pack que ejecuta este SOP:** [[XP-EL-SX-StarterLinux-v01]]
- **Guion `/SetupSherpaX`:** [[SP-EL-WORX-SetupSherpaX-Guion-v01]]
- **XPack de arranque (contexto WORX):** [[XP-EL-WORX-ArranqueBasico-v01]]
- **SOP equivalente en Cowork:** [[SOP-EL-SX-InstalacionCowork-v01]]

---

## NEXTs

- [ ] **Confirmar la fuente real del marketplace WORX** (placeholder `EmpowerLabs/worx-marketplace`). Owner: Alex/Sistemas.
- [ ] Validar que los subcomandos `claude plugin marketplace add` / `claude plugin install` existen en la versión instalada; si no, ajustar `setup.sh` y este SOP.
- [ ] Probar el SOP end-to-end con un colaborador Linux real (¿Gustavo o Jesús?) y capturar fricciones en el LabPraxis.
- [ ] Definir el procedimiento de actualización del plugin (`claude plugin update`) como pieza aparte.
- [ ] Ratificación de Victor.

---

## CHANGELOG

| Versión | Fecha | Cambio |
|---|---|---|
| v01 | 2026-06-10 | Creación. Variante Linux/CLI del SOP de instalación: prerequisitos, dos vías de acceso al vault (local/MCP), secuencia de 6 pasos automatizada por `XP-EL-SX-StarterLinux-v01/setup.sh`, handshake `/SetupSherpaX → /ArrancaWorX` reutilizado, modelo de operación, tabla de validaciones, capa de 2 niveles y limitación conocida del pre-horneado de plugins. |