Guía de SakanaAI Fugu: cómo activar un modelo multiagente en Codex

Lo más interesante de SakanaAI/fugu para desarrolladores no es solo que sea un modelo multiagente. Es que ya ofrece una entrada directa para usarlo con Codex.

Si estás buscando:

1
2
3
4


Cómo instalar Fugu
Cómo usar SakanaAI Fugu
Cómo conectar Fugu con Codex
Qué es codex-fugu

Esta guía está escrita como tutorial de instalación y primer uso.

Enlaces oficiales:

Repositorio GitHub: SakanaAI/fugu
Página del producto: Sakana Fugu

Para qué conviene probar Fugu primero

Antes de instalarlo, conviene aclarar algo: Fugu no necesariamente es la mejor opción para cualquier tarea.

Encaja mejor con tareas de desarrollo complejas, de varios pasos, donde la coordinación y verificación entre modelos aporta valor, por ejemplo:

Leer un repositorio y resumir su estructura;
Localizar bugs;
Modificar código y seguir ejecutando pruebas;
Revisar código;
Analizar errores complicados;
Diseñar una solución de ingeniería;
Manejar tareas que requieren razonamiento largo;
Reproducir papers, hacer análisis de investigación o análisis de seguridad.

Si solo preguntas algo sencillo como “cómo leer un archivo en Python”, un modelo normal basta. Fugu tiene más sentido cuando quieres que la IA piense más pasos y revise más veces.

Revisión antes de instalar

Según el README de SakanaAI/fugu, el instalador oficial de una línea soporta:

Ubuntu;
macOS.

Los usuarios de Windows, o quienes no completen la instalación de una línea, deben seguir las instrucciones manuales oficiales.

Antes de instalar, revisa:

Tu entorno puede acceder a https://sakana.ai/;
Tienes curl en la terminal;
Sabes si estás en Ubuntu, macOS o Windows;
Ya tienes un entorno Codex funcional;
Si estás detrás de proxy o firewall corporativo, confirma que puedes descargar el script de instalación.

Si estás en la UE/EEE, ten en cuenta la limitación indicada en la página oficial: Fugu no está disponible actualmente en EU/EEA mientras Sakana trabaja en cumplimiento de GDPR y normativas europeas.

Instalar Fugu con un comando

El comando de instalación del README oficial es:

1

curl -fsSL https://sakana.ai/fugu/install | bash

Este comando descarga el instalador desde la dirección oficial de Sakana y lo pasa a bash.

Si prefieres ser más cuidadoso, puedes imprimir primero el contenido del script sin ejecutarlo:

1

curl -fsSL https://sakana.ai/fugu/install

Después de confirmar el origen y el contenido, ejecuta el comando oficial de instalación.

Los comandos curl | bash son cómodos, pero ejecutan un script remoto. Cópialos solo desde el README oficial o la documentación oficial, no desde comentarios, capturas o artículos repostados.

Iniciar codex-fugu

Después de instalar, el README oficial muestra este comando:

1

codex-fugu

Si se inicia correctamente, Fugu ya está conectado a tu flujo de trabajo con Codex.

Empieza con una tarea pequeña, no con un problema enorme de repositorio. Por ejemplo:

1

Lee la estructura del proyecto actual y explica para qué sirven los directorios principales.

1

Revisa los cambios recientes e identifica riesgos que puedan afectar la compilación o el despliegue.

Estas tareas son concretas sin ser demasiado pesadas, y sirven para observar estilo de salida, velocidad y estabilidad.

Pruebas recomendadas después de instalar

La primera vez que uses codex-fugu, sigue este orden:

Pregunta por la estructura del repositorio;
Pídele que revise un archivo concreto;
Pídele que analice un bug pequeño;
Luego prueba una tarea entre varios archivos.

Por ejemplo:

1

Primero revisa este repositorio y dime dónde están los archivos de entrada, los directorios de contenido y los scripts de build.

Luego:

1

Comprueba si content/post/2026/06/127/index.zh-cn.md tiene front matter completo.

Después:

1

Busca si esta publicación tiene inconsistencias entre title, slug y description, y dame sugerencias de corrección.

Este enfoque gradual es más estable. Primero compruebas si entiende el proyecto, y luego decides si darle tareas más complejas.

Tareas de Codex adecuadas para Fugu

Fugu empaqueta la coordinación multiagente como un modelo/API, así que encaja mejor con tareas que requieren varias rondas de razonamiento.

1. Revisión de código

Puedes pedir:

1

Revisa los cambios no confirmados actuales desde una perspectiva de code review. Prioriza bugs, riesgos de regresión y pruebas faltantes.

Este tipo de tarea requiere leer varios archivos, entender contexto y juzgar riesgos. Es mejor ejemplo de coordinación multiagente que una pregunta simple.

2. Diagnóstico de bugs

Puedes pedir:

1

Esta función está fallando. Usa primero los logs para identificar posibles causas, revisa los archivos relacionados y luego propone el arreglo mínimo.

Diagnosticar bugs suele exigir investigación paso a paso. Un sistema como Fugu puede encadenar análisis, verificación y propuesta de reparación.

3. Cambios entre varios archivos

Puedes pedir:

1

Cambia este valor de configuración de lógica hardcodeada a lectura desde variable de entorno, y revisa si las pruebas relacionadas necesitan actualización.

Los cambios entre archivos suelen perder bordes. Con Fugu, conviene pedirle que explique primero el impacto antes de editar.

4. Documentación y tutoriales

Puedes pedir:

1

Usa el README actual y la estructura del código para escribir una guía de instalación y ejecución para principiantes.

Esta tarea requiere leer materiales, extraer estructura y convertirla en pasos ejecutables, así que también encaja bien.

5. Análisis difíciles

Para investigación, reproducción de papers, análisis de seguridad o investigaciones largas de ingeniería, puedes considerar Fugu Ultra.

Para tareas diarias de desarrollo, no hace falta empezar con Ultra. Prueba primero Fugu normal para evaluar coste, velocidad y calidad.

Cómo elegir entre Fugu y Fugu Ultra

La página oficial de Sakana menciona dos modelos:

Fugu
Fugu Ultra

Puedes entenderlos así:

Modelo	Escenarios adecuados	Orientación
Fugu	Codificación diaria, revisión de código, chatbots, tareas complejas normales	Equilibrio entre rendimiento y latencia
Fugu Ultra	Razonamiento difícil, investigación, competiciones, análisis de seguridad, tareas largas	Prioriza calidad del resultado

Consejo práctico:

Usa Fugu primero para tareas normales de desarrollo;
Usa Fugu primero incluso en tareas complejas entre archivos;
Si el resultado no es suficientemente profundo, considera Fugu Ultra;
En tareas costosas o de alto riesgo, combina la respuesta del modelo con pruebas y revisión humana.

Qué hacer en Windows

El README oficial indica que la instalación de una línea soporta Ubuntu y macOS. En Windows, o si la instalación no se completa, hay que seguir la guía manual oficial.

En Windows, considera:

Usar WSL Ubuntu;
Instalar en una máquina macOS o Linux;
Consultar la consola o documentación oficial de Sakana para pasos manuales de Windows;
No pegar comandos shell de Linux/macOS directamente en PowerShell.

En particular:

1

curl -fsSL https://sakana.ai/fugu/install | bash

Este es un comando bash, no un comando nativo de PowerShell. Si Windows no tiene entorno bash, probablemente fallará.

Problemas comunes

1. Falla el comando curl

Primero revisa la red:

1

curl -I https://sakana.ai/fugu/install

Si no conecta, puede ser problema de red, proxy, certificado o firewall.

2. bash no existe

Significa que el entorno actual no tiene bash, algo común en Windows PowerShell.

Opciones:

Cambiar a WSL;
Usar macOS/Linux;
Seguir la instalación manual oficial.

3. codex-fugu no se encuentra

Posibles causas:

La instalación no terminó bien;
El comando no se añadió a PATH;
La terminal actual no recargó variables de entorno;
El script de instalación solo afectó al shell actual.

Primero abre una terminal nueva y prueba:

1

codex-fugu

Si sigue fallando, vuelve a la guía oficial y revisa la configuración de rutas.

4. Es más lento que un modelo normal

No necesariamente es un error.

Fugu coordina varios modelos por detrás, así que las tareas complejas pueden tener más pasos internos. Sirve para cambiar velocidad por mejor manejo de tareas complejas, pero no es ideal para todas las preguntas ligeras.

5. ¿Puedo subir código de la empresa?

Con cuidado.

La página oficial menciona que Fugu permite excluir providers o modelos específicos según requisitos de datos, privacidad y cumplimiento. Aun así, si vas a manejar código de empresa, datos de clientes, vulnerabilidades o patentes, confirma primero la política de datos y la configuración del pool de modelos de tu organización.

Consejos de uso

La primera vez que uses Fugu, no empieces con la tarea más grande y complicada.

Un flujo más seguro:

Probar con un repositorio pequeño;
Pedirle que lea la estructura;
Darle un bug pequeño;
Probar un cambio entre archivos;
Luego pasar a tareas complejas de ingeniería.

Haz los prompts concretos, por ejemplo:

1

Lee primero los archivos relacionados y luego propone un plan de cambios. Tras confirmar el alcance, modifica solo los archivos necesarios. Al terminar, explica qué comprobaste.

Estas restricciones hacen que el resultado sea más controlable.

Resumen

Si solo quieres entender qué es Fugu, piensa en él como “un sistema multiagente empaquetado como modelo/API”.

Pero lo más interesante para probar es su entrada para Codex:

1
2


curl -fsSL https://sakana.ai/fugu/install | bash
codex-fugu

Para desarrolladores diarios, Fugu encaja especialmente bien con revisión de código, diagnóstico de bugs, cambios entre archivos, documentación compleja y tareas largas de ingeniería. Empieza con tareas pequeñas y luego decide si vale la pena incorporarlo a tu flujo diario de Codex.