Usar InferNode desde Pi
Pi es un agente de código de terminal. Puede leer archivos, ejecutar herramientas y trabajar sobre tu proyecto usando los modelos de InferNode. Se conecta directamente por la API de Chat Completions; no necesita un router local.
Esta guía se comprobó con Pi 0.73.1. Usa los alias Saptiva Turbo, Saptiva Omni y Saptiva Cortex como tres opciones independientes. El administrador puede cambiar el modelo detrás de cada alias sin cambiar tu configuración.
Antes de empezar
Necesitas una llave de InferNode, la URL de tu instalación, Node.js 22 o superior y jq para consultar el catálogo. Los comandos de entorno usan Bash; ejecuta bash si tu terminal usa otro intérprete. Reemplaza el dominio de ejemplo por el que te dé tu administrador.
npm install -g @mariozechner/pi-coding-agent@0.73.1
pi --version
La versión comprobada se distribuye como @mariozechner/pi-coding-agent. npm muestra un aviso de cambio de nombre a @earendil-works/pi-coding-agent; esta receta fija la versión comprobada y no supone que otra versión tenga la misma configuración.
1. Comprueba tu acceso
Carga la llave en la terminal sin escribirla en el historial. La entrada no se muestra al pegarla:
export INFERNODE_BASE_URL='https://api.<tu-dominio>/infernode/v1'
read -r -s -p 'InferNode API key: ' INFERNODE_API_KEY
printf '\n'
export INFERNODE_API_KEY
curl --fail-with-body -sS "$INFERNODE_BASE_URL/me" \
-H "Authorization: Bearer $INFERNODE_API_KEY"
La respuesta debe identificar tu usuario y organización. Las variables duran solo en esa terminal; vuelve a cargarlas cuando abras otra. No pongas la llave en el repositorio ni en el archivo de modelos.
Consulta los alias disponibles para tu llave:
curl --fail-with-body -sS "$INFERNODE_BASE_URL/models/aliases" \
-H "Authorization: Bearer $INFERNODE_API_KEY" \
| jq '.data[] | {alias, model: .model.id, context: .model.context_window}'
Usa los nombres exactos de esa respuesta, incluidas mayúsculas y espacios. Si alguno de los tres alias no existe, omítelo de la configuración o pide acceso a tu administrador. No agregues modelos de embeddings o guardas como modelos de conversación.
2. Agrega el proveedor y los modelos
Crea ~/.pi/agent/models.json. Si ya existe, agrega el proveedor infernode dentro de providers y conserva los demás. Cambia baseUrl por la URL que acabas de probar:
{
"providers": {
"infernode": {
"baseUrl": "https://api.<tu-dominio>/infernode/v1",
"api": "openai-completions",
"apiKey": "INFERNODE_API_KEY",
"compat": {
"supportsStore": false,
"supportsDeveloperRole": false,
"supportsReasoningEffort": false,
"supportsStrictMode": false,
"maxTokensField": "max_tokens"
},
"models": [
{
"id": "Saptiva Turbo",
"name": "Saptiva Turbo",
"reasoning": true,
"input": [
"text",
"image"
],
"contextWindow": 262144,
"maxTokens": 8192
},
{
"id": "Saptiva Omni",
"name": "Saptiva Omni",
"reasoning": true,
"input": [
"text",
"image"
],
"contextWindow": 131072,
"maxTokens": 8192
},
{
"id": "Saptiva Cortex",
"name": "Saptiva Cortex",
"reasoning": true,
"input": [
"text",
"image"
],
"contextWindow": 131072,
"maxTokens": 8192
}
]
}
}
}
apiKey contiene el nombre de la variable, no el secreto. openai-completions selecciona Chat Completions. Los ajustes de compat evitan enviar campos que no necesita esta integración; supportsReasoningEffort: false no desactiva el razonamiento del modelo.
Los valores de contextWindow son un ejemplo comprobado, no una propiedad permanente del alias. Ajústalos al catálogo de tu instalación. maxTokens: 8192 reserva salida dentro de esa ventana: entrada y salida deben caber juntas (Contexto excedido). Esta receta no configura precios en Pi; consulta el consumo real en InferNode.
3. Abre Pi en tu proyecto
Desde la carpeta del proyecto, ejecuta una de estas opciones:
pi --provider infernode --model 'Saptiva Turbo'
pi --provider infernode --model 'Saptiva Omni'
pi --provider infernode --model 'Saptiva Cortex'
Dentro de Pi, /model permite elegir entre los tres. Los nombres entre comillas son los alias que se envían a InferNode, no equivalencias con nombres de Claude. El comando pi-saptiva no forma parte de Pi: solo existe si alguien instaló un lanzador personalizado en tu equipo.
Para comprobar la conexión con una petición breve:
pi --provider infernode --model 'Saptiva Turbo' \
--print --no-session --no-tools 'Responde solamente OK.'
Después prueba una herramienta en la sesión interactiva: pide leer un archivo pequeño que exista, indicando su ruta exacta, y resumirlo sin modificarlo. Una respuesta a un saludo comprueba generación; una lectura seguida de una respuesta comprueba también el uso de herramientas.
Errores frecuentes
| Síntoma | Qué revisar |
|---|---|
pi: command not found | El directorio de binarios de npm debe estar en tu PATH. |
401 o Unauthorized | Carga INFERNODE_API_KEY en la misma terminal. Si ya usaste /login para infernode, Pi puede estar usando una llave guardada; actualízala o usa /logout para volver a la variable. |
model_not_found | Compara el id con GET /v1/models/aliases; conserva espacios y mayúsculas. |
| La respuesta queda vacía o se corta | El razonamiento puede consumir la salida disponible. Revisa maxTokens y prueba Saptiva Turbo. |
| La herramienta no encuentra un archivo | Comprueba la carpeta desde la que abriste Pi y proporciona una ruta exacta. |
| El modelo afirma ser Claude u otro modelo | Esa afirmación no verifica el proveedor. Consulta el campo model de la respuesta de InferNode y los registros de uso; Claude Code muestra cómo distinguir identidad y enrutamiento. |