# Instrucciones para el agente: Freebuff2API: un proxy compatible con clientes OpenAI

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: avanzado
- Proyecto: https://github.com/Quorinex/Freebuff2API (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/freebuff-openai-compatible-proxy

---

## 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 Git y Go ≥1.23 están disponibles. El README documenta la compilación:

```sh
git clone https://github.com/Quorinex/Freebuff2API.git
cd Freebuff2API
go build -o Freebuff2API .
```

Copia `config.example.json` a `config.json` desde esa raíz. Configura `AUTH_TOKENS` con el `authToken` de tu sesión válida, siguiendo Authentication del README; usa `UPSTREAM_BASE_URL` igual a `https://codebuff.com`. Configura `LISTEN_ADDR` como `127.0.0.1:8080` y una lista `API_KEYS` no vacía con claves propias del cliente. Las variables de entorno prevalecen sobre el JSON. Inicia:

```sh
./Freebuff2API -config config.json
```

En otra terminal, con curl disponible, configura `PROXY_API_KEY` con una de las claves locales de `API_KEYS`. Consulta la ruta implementada en [server.go](https://github.com/Quorinex/Freebuff2API/blob/main/server.go):

```sh
curl -i http://127.0.0.1:8080/v1/models
curl -s http://127.0.0.1:8080/v1/models -H "Authorization: Bearer $PROXY_API_KEY"
```

La primera petición debe devolver 401 y la segunda el catálogo. En tu cliente compatible configura la base `http://127.0.0.1:8080/v1`, esa misma clave y un ID de modelo del catálogo. Envía una consulta breve y contrasta el campo `model` de la respuesta. Las rutas de comprobación se toman del código del servidor.

## Comprobación

Comprueba una petición corta y revisa qué modelo devuelve realmente el servicio. Verifica que el proxy rechaza clientes sin la autenticación configurada.

## Si algo falla

Si el backend rechaza la petición, comprueba acceso y cambios del servicio. No asumas que la compatibilidad del formato garantiza la disponibilidad del modelo.

Consulta [el README oficial](https://github.com/Quorinex/Freebuff2API#readme) para requisitos y variantes de instalación.