# Instrucciones para el agente: fx: un agente de programación que se integra con la terminal

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/vercel-labs/fx (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/fx-coding-agent

---

## 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

### Paso 1: revisa la instalación

Lee Install y Permissions en https://github.com/vercel-labs/fx. La CLI admite macOS y Linux. El comando oficial descarga y ejecuta el instalador; revísalo antes de usarlo:

```bash
curl -fsSL https://fx.sh/setup.sh | bash
```

### Paso 2: conecta un proveedor

Elige un solo método documentado. Para Vercel AI Gateway:

```bash
fx login
```

Otros métodos están en Quick start del README. Comprueba sus costes y el modo de permisos.

### Paso 3: prueba una consulta

Desde un repositorio de práctica con cambios conocidos, ejecuta la petición del ejemplo oficial traducida al español:

```bash
fx ask "Explica los cambios de este repositorio"
```

Para comprobar la respuesta JSON que usaría un script, el README documenta `fx ask --json`; aquí se adapta la petición y se guarda su salida:

```bash
fx ask --json "Explica los cambios de este repositorio" > respuesta-fx.json
```

Confirma que `respuesta-fx.json` es JSON válido y contiene la respuesta en `final_output`; no debe confundirse con la configuración de `fx status --json`. Para una sesión interactiva, el comando es `fx`.

## Comprobación

```bash
fx doctor
fx status --json
```

Revisa el diagnóstico, el proveedor y los permisos. Contrasta ambas explicaciones con los cambios reales de código antes de encargar ediciones.

## Si algo falla

Si no se encuentra el binario, revisa que ~/.local/bin esté en PATH. Si no responde el proveedor, comprueba su conexión con fx doctor. Para opciones de la versión instalada utiliza `fx <command> --help`, como indica la documentación.