Capítulo 2: Instalación y Setup

Por: Artiko
claude-codeinstalacionpluginconfiguracion

Opción 1: Instalar como Plugin (Recomendada)

# Agregar el marketplace
/plugin marketplace add affaan-m/everything-claude-code

# Instalar el plugin
/plugin install everything-claude-code@everything-claude-code

O agregar directamente a ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "everything-claude-code": {
      "source": {
        "source": "github",
        "repo": "affaan-m/everything-claude-code"
      }
    }
  },
  "enabledPlugins": {
    "everything-claude-code@everything-claude-code": true
  }
}

Instalar Rules (obligatorio)

El sistema de plugins de Claude Code no puede distribuir rules automáticamente. Hay que instalarlas manualmente:

git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# macOS/Linux
./install.sh typescript    # o python, golang, swift, php
./install.sh typescript python golang  # múltiples lenguajes

# Windows
.\install.ps1 typescript

Esto copia las rules a ~/.claude/rules/.

Opción 2: Instalación Manual

Para control total sobre qué se instala:

git clone https://github.com/affaan-m/everything-claude-code.git

# Agentes
cp everything-claude-code/agents/*.md ~/.claude/agents/

# Rules (common + tu lenguaje)
cp -r everything-claude-code/rules/common/* ~/.claude/rules/
cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/

# Comandos
cp everything-claude-code/commands/*.md ~/.claude/commands/

# Skills (solo los que necesites)
cp -r everything-claude-code/skills/search-first ~/.claude/skills/
cp -r everything-claude-code/skills/tdd-workflow ~/.claude/skills/

Cada componente es independiente: podés instalar solo lo que necesités.

Configurar Hooks

Copiar la configuración de hooks a tu settings.json:

# Ver los hooks disponibles
cat everything-claude-code/hooks/hooks.json

Agregar los hooks relevantes a ~/.claude/settings.json.

Configurar MCPs

Copiar los MCP servers deseados de mcp-configs/mcp-servers.json a ~/.claude.json. Reemplazar los placeholders YOUR_*_HERE con tus API keys reales.

Verificar la instalación

# Ver componentes instalados
/plugin list everything-claude-code@everything-claude-code

# Probar un comando
/everything-claude-code:plan "Add user authentication"

# Con instalación manual, forma corta:
/plan "Add user authentication"

Configurar Package Manager

ECC detecta automáticamente tu package manager con esta prioridad:

  1. Variable de entorno CLAUDE_PACKAGE_MANAGER
  2. Config de proyecto .claude/package-manager.json
  3. Campo packageManager en package.json
  4. Lock file (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb)

Para configurar explícitamente:

# Vía variable de entorno
export CLAUDE_PACKAGE_MANAGER=bun

# Vía script
node scripts/setup-package-manager.js --project bun

# Vía comando en Claude Code
/setup-pm

Hook Runtime Controls

Ajustar la severidad de los hooks sin editar archivos:

# Perfil de severidad (default: standard)
export ECC_HOOK_PROFILE=standard   # minimal | standard | strict

# Deshabilitar hooks específicos
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"