---
title: "Instalación"
description: "Prepara un proyecto nuevo o existente, instala el plugin y comprueba el resultado."
canonical_url: "https://razcue-agent-kit.vercel.app/es/getting-started/installation"
---
# Instalación

> Prepara un proyecto nuevo o existente, instala el plugin y comprueba el resultado.

## Requisitos

- **Node.js ≥ 20.11** y npm.
- **Claude Code** (CLI, app de escritorio o extensión del IDE).
- Se recomienda git: el git guard y preflight trabajan sobre el repositorio.

## Preparar un proyecto

<steps>

### Ejecuta `init`

```bash [Terminal]
npx @razcue/agent-kit init my-project
```

En un repositorio existente, ejecútalo dentro de la carpeta: `cd my-repo && npx @razcue/agent-kit init`. Tu `AGENTS.md` se conserva y recibe un bloque gestionado.

### Responde las preguntas

<table>
<thead>
  <tr>
    <th>
      Pregunta
    </th>
    
    <th>
      Opciones
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Tipo de proyecto
    </td>
    
    <td>
      <strong>
        Monorepo de app nuevo
      </strong>
      
       (web + app + docs con Nuxt + Supabase) · <strong>
        Sitio de contenido nuevo
      </strong>
      
       (un sitio Nuxt con páginas en Markdown) · <strong>
        Proyecto existente
      </strong>
      
       (solo la capa del agente) · <strong>
        Proyecto en blanco
      </strong>
      
       (solo la capa del agente, sin plantilla)
    </td>
  </tr>
  
  <tr>
    <td>
      Apps (monorepo)
    </td>
    
    <td>
      <code>
        web
      </code>
      
      , <code>
        app
      </code>
      
      , <code>
        docs
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Nivel técnico
    </td>
    
    <td>
      Técnico (lenguaje conciso de desarrollador) · No técnico (lenguaje sencillo; el agente toma las decisiones técnicas)
    </td>
  </tr>
  
  <tr>
    <td>
      Idioma de respuesta del agente
    </td>
    
    <td>
      English · Español
    </td>
  </tr>
  
  <tr>
    <td>
      Método de desarrollo
    </td>
    
    <td>
      SDD + TDD (tests primero, obligatorio) · SDD (cada escenario verificado por un test o una comprobación)
    </td>
  </tr>
  
  <tr>
    <td>
      Mensajes de commit
    </td>
    
    <td>
      Conventional Commits (commitlint + hook de git) · Libres
    </td>
  </tr>
  
  <tr>
    <td>
      Flujo de git del agente
    </td>
    
    <td>
      Ramas + pull requests · Trunk · Solo lectura (tú ejecutas git)
    </td>
  </tr>
  
  <tr>
    <td>
      Rama principal (de producción)
    </td>
    
    <td>
      Se detecta desde git: el HEAD de origin, o la única rama <code>
        main
      </code>
      
       / <code>
        master
      </code>
      
       / <code>
        trunk
      </code>
      
       / <code>
        production
      </code>
      
       / <code>
        prod
      </code>
      
      ; solo se pregunta si no hay certeza (<code>
        --main <rama>
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      Skill de convenciones del stack (existente / en blanco)
    </td>
    
    <td>
      Ninguna · Nuxt + Supabase · Sitio Nuxt Content
    </td>
  </tr>
  
  <tr>
    <td>
      Checklist de QA
    </td>
    
    <td>
      Generado desde las specs vivas en <code>
        work/qa/
      </code>
      
       (por defecto sí)
    </td>
  </tr>
  
  <tr>
    <td>
      Datos de prueba de Supabase (proyectos con Supabase)
    </td>
    
    <td>
      Scripts seed / purge en <code>
        supabase/test-data/
      </code>
      
       (por defecto sí)
    </td>
  </tr>
  
  <tr>
    <td>
      Ref del proyecto de Supabase (opcional)
    </td>
    
    <td>
      Añade a <code>
        .mcp.json
      </code>
      
       un servidor MCP de Supabase de solo lectura, limitado al proyecto
    </td>
  </tr>
</tbody>
</table>

`init` muestra el plan y pregunta antes de escribir. Cada archivo que cambia se respalda en `.agent-kit/backups/`.

### Abre Claude Code en el proyecto

```bash [Terminal]
cd my-project && npm install && claude
```

Confía en la carpeta. `.claude/settings.json` declara el marketplace de agent-kit y activa `agent-kit@agent-kit`, así que Claude Code ofrece instalar el plugin: acepta. Si no lo hace:

```text [Claude Code]
/plugin marketplace add razcue/agent-kit
/plugin install agent-kit@agent-kit
```

### Comprueba la instalación

```bash [Terminal]
npx @razcue/agent-kit doctor
```

`agent-kit doctor` revisa las respuestas, el bloque de AGENTS.md, el plugin, los índices de conocimiento y de scripts, el presupuesto de contexto y la skill de stack. `--fix` regenera todo lo generado (índices, el tablero de trabajo, el checklist de QA).

</steps>

## Instalación no interactiva

Cada pregunta tiene un flag; `--yes` toma los valores por defecto para el resto:

```bash [Terminal]
npx @razcue/agent-kit init shop --yes --kind monorepo --apps web,app,docs \
  --level technical --lang en --method sdd-tdd --commits conventional --git pr \
  --qa-checklist true --test-data true --test-prefix TEST_
```

Todos los flags están en la [referencia de la CLI](https://razcue-agent-kit.vercel.app/es/reference/cli#agent-kit-init).

## Cambiar una respuesta después

Vuelve a ejecutar `init` con el nuevo valor; solo toca la capa del agente:

```bash [Terminal]
npx @razcue/agent-kit init --git read-only --yes
```

## Hacer escribible el conocimiento global (mantenedores del kit)

Los proyectos leen el conocimiento global que trae el plugin. Para escribir entradas globales desde tu máquina, registra un clon del kit:

```bash [Terminal]
git clone https://github.com/razcue/agent-kit.git && cd agent-kit
npx @razcue/agent-kit setup
```

`agent-kit setup` escribe `~/.config/agent-kit/config.json`; desde entonces los agentes guardan el conocimiento global y las propuestas de mejora en ese clon.


## Sitemap

See the full [sitemap](https://razcue-agent-kit.vercel.app/sitemap.md) for all pages.