# Instrucciones para el agente: Agent Zero: trabaja con un agente dentro de un entorno Linux

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/agent0ai/agent-zero (licencia NOASSERTION)
- Guía completa: https://lab.wisd.ai/hub/agent-zero

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que trabajas en macOS o Linux y que curl y Bash están disponibles para esta ruta. Si tienes Docker, verifica que arranca; el instalador intenta reutilizarlo antes de preparar un runtime. Para Windows, usa la [ruta PowerShell oficial](https://github.com/agent0ai/agent-zero#a0-install).

### Paso 1: prepara una instancia de prueba

La vía de terminal documentada para macOS o Linux es:

```bash
curl -fsSL https://bash.agent-zero.ai | bash
```

### Paso 2: revisa la configuración

Sigue el asistente y comprueba runtime, persistencia y puerto de la instancia. Configura el proveedor y abre una tarea pequeña con archivos de ejemplo antes de conectar carpetas personales.

## Comprobación

Comprueba que los archivos de prueba se guardan en el volumen esperado y que el agente no tiene montajes innecesarios. Revisa el proveedor que procesó la consulta.

## Si algo falla

Si la instancia no arranca, revisa el runtime Docker y los puertos. Si falla inferencia, comprueba el proveedor por separado. Conserva el volumen de datos al investigar un fallo.