Precios del agente de programación Pi: el software es gratuito, los tokens no

El agente de programación Pi no cuesta nada de instalar: es software con licencia MIT, sin precio de plan ni de puesto. Cada dólar que gastas en Pi corresponde a tokens del modelo, que se compran mediante cuatro tipos de vía. Estas son la pasarela Radius de Earendil, una cuenta iniciada mediante /login — la documentación de proveedores de Pi enumeraba siete hasta una actualización del 22 de septiembre de 2026, entre ellos Claude Pro/Max, ChatGPT Plus/Pro mediante Codex y OpenRouter —, una clave de API directa del proveedor o cualquier endpoint compatible con OpenAI o Anthropic que añadas tú mismo a ~/.pi/agent/models.json. Facturan de forma suficientemente distinta como para que «¿cuánto cuesta Pi?» no tenga una única respuesta.

Esta página trata sobre el agente de programación para terminal publicado en pi.dev por Earendil Inc. No se trata de Pi de Inflection AI (pi.ai), de la moneda Pi Network, de Raspberry Pi ni de Oh My Pi, un agente de programación con licencia MIT independiente y de otro autor. Ninguno de sus precios se aplica aquí.

Precios del agente de programación Pi: qué factura cada capa

Fuentes comprobadas el 18 de septiembre y verificadas de nuevo el 21 de septiembre de 2026: el repositorio de Pi (MIT, no archivado), el sitio oficial, la documentación de proveedores de Pi para las siete rutas /login, y las preguntas frecuentes de Radius. La actualización de documentación de Pi del 22 de septiembre de 2026 eliminó esa lista de siete; la página de proveedores ahora dice «Usa /login [provider] para ver los métodos compatibles con un proveedor» (releído el 1 de octubre de 2026). Radius también afirma que es «actualmente un servicio de código cerrado».

Vale la pena dedicar una frase a una trampa de nombres, porque afecta silenciosamente a lo que instalas. Pi pasó de badlogic/pi-mono y el ámbito npm @mariozechner a earendil-works/pi y @earendil-works el 7 de mayo de 2026; la versión 0.74.0 fue la primera bajo el nuevo ámbito, la 0.73.1 la última bajo el nombre anterior, y los paquetes antiguos quedaron obsoletos pero no se retiraron. Los tutoriales de terceros y los motores de respuestas siguen proporcionando la línea de instalación obsoleta. La actual es npm install -g --ignore-scripts @earendil-works/pi-coding-agent, la 0.86.1, publicada el 20 de septiembre de 2026 en el registro cuando se comprobó el 21 de septiembre de 2026.

La vía de suscripción es donde se desajustan los presupuestos

Si ya pagas Claude Pro o Max, lo lógico parece iniciar sesión con ello. Pi te indica qué hace realmente. Hasta la actualización de documentación del 22 de septiembre de 2026, la documentación propia de proveedores de Pi decía: «El uso de arneses de terceros consume el uso adicional y se factura por token, no contra los límites del plan de Claude». La actualización eliminó esa frase y dejó solo un ajuste, warnings.anthropicExtraUsage, para «Avisar cuando la autenticación mediante suscripción de Anthropic pueda usar uso adicional de pago»; la advertencia, en el código fuente de Pi en la versión v0.99.2, sigue diciendo que el uso de arneses de terceros «consume el uso adicional y se factura por token, no contra los límites de tu plan de Claude». Un usuario que recibió la advertencia de terminal de Pi con el mismo sentido la presentó como incidencia n.º 3670; un bot la cerró automáticamente y el responsable respondió que Anthropic no permite usar la cuota del plan de esta manera, aunque señaló que el inicio de sesión mediante suscripción sigue siendo útil para el uso adicional. Toma a Pi al pie de la letra: la suscripción no es el presupuesto para Pi, sino un requisito previo para un cargo separado por token. El propio artículo del Agent SDK de Anthropic actualmente indica lo contrario para las aplicaciones de terceros: desde una actualización del 15 de junio de 2026, dice que su uso «sigue consumiendo los límites de uso de tu suscripción»; comprueba Ajustes > Uso después de una sesión breve en lugar de confiar únicamente en cualquiera de las dos frases.

El lado de Anthropic coincide en cuanto al dinero. Su centro de ayuda afirma que los créditos de uso se facturan a las tarifas estándar de la API y se habilitan en Ajustes > Uso en la aplicación web. Un artículo independiente sobre paquetes de uso publica los descuentos de los paquetes de uso prepagados:

El mismo artículo limita las compras de paquetes a 2.000 $ al mes en los planes individuales Pro y Max, y a 3.000 $ al mes en Team, y afirma que los precios y los planes están sujetos a cambios. Está fechado el 18 de mayo de 2026; el artículo sobre uso adicional está fechado el 10 de agosto de 2026.

Los dos artículos describen saldos y superficies diferentes, así que lee ambos en lugar de uno solo. El artículo sobre paquetes afirma que el saldo de un paquete de uso «se aplica en Claude, Claude Desktop, Claude Mobile (iOS y Android), Claude Code, Cowork y productos de terceros que utilizan tu cuenta de Claude». El artículo sobre uso adicional afirma que «los créditos de uso se aplican tanto a las conversaciones de Claude como al uso de terminal de Claude Code» y tampoco aborda los arneses de terceros en ningún sentido: es una ausencia, no una exclusión. La consecuencia de facturación que sí establecen ambos artículos es la que importa para un presupuesto: por token, a las tarifas estándar de la API.

También conviene conocer la historia normativa detrás de esa cadena de advertencia, aunque es de segunda mano: VentureBeat informó el 13 de mayo de 2026 que Anthropic había bloqueado el 4 de abril de 2026 las herramientas de agentes de terceros para la facturación de suscripciones de Claude y después había restablecido la vía mediante un fondo mensual independiente de crédito del Agent SDK facturado a tarifas de API, que no se acumula y no puede recurrir a la asignación general de la suscripción una vez agotado. El propio artículo del Agent SDK de Anthropic supera ese informe: anunció un crédito mensual del Agent SDK para el 15 de junio de 2026 y después comenzó con una actualización del mismo día que pausaba el cambio; el crédito no está disponible, y el Agent SDK, claude -p y el uso de aplicaciones de terceros siguen contando contra los límites de uso del plan. Lee los detalles de VentureBeat como historia, no como condiciones actuales, y comprueba Ajustes > Uso en tu propia cuenta antes de dirigir trabajo de pago por esta vía.

Tarifas de Radius junto a los mismos modelos en Kunavo

Radius es la única vía aquí cuyos precios fija la propia Earendil. Su tabla de modelos publica tarifas por millón de tokens y afirma claramente que «la disponibilidad y los precios de los modelos pueden cambiar». Sus preguntas frecuentes indican que las recargas se cobran a los precios de lista más las comisiones del procesador de pagos, sin publicar ningún porcentaje, por lo que el total de Radius no puede calcularse desde fuera. La tabla siguiente compara sus tarifas publicadas con las tarifas actuales del catálogo de Kunavo para los mismos tres modelos de Claude y con el precio de lista del propio proveedor del modelo.

Las cifras de Radius se leyeron en su propia documentación el 18 de septiembre y no habían cambiado el 21 de septiembre de 2026; las cifras de Kunavo se representan desde el catálogo actual. Ten en cuenta un mecanismo de Radius que cambia una factura más que una tabla de tarifas: para sus modelos escalonados, «el nivel se selecciona a partir del total de tokens de entrada de la solicitud y se aplica a toda la solicitud»; su fila gpt-5.4 pasa de 2,50 $ / 15,00 $ a 5,00 $ / 22,50 $ cuando una solicitud supera los 272.000 tokens de entrada. Por tanto, una conversación larga de agente cambia de precio de una vez en lugar de hacerlo gradualmente.

Un mes de ejemplo, con aritmética

Supón un mes, un modelo, 6.000.000 de tokens de entrada sin caché y 600.000 tokens de salida, sin lecturas de caché, escrituras de caché ni cargos por imágenes o herramientas. Es aproximadamente el perfil de un trabajo diario constante de agente en un repositorio, no el de una tarea medida.

Son estimaciones ilustrativas de tokens bajo las suposiciones anteriores, no costes de una tarea medida ni un límite máximo de una factura. La columna de Radius también excluye la comisión no publicada del procesador de pagos en las recargas. Lee las dos columnas fila por fila y no como un veredicto: cuando llegan al mismo número, la elección depende de algo distinto del precio; cuando divergen, la diferencia es el argumento para calcular el precio del modelo concreto que pretendes ejecutar en lugar de elegir una vía y suponer el resto.

En la misma estimación corresponden dos salvedades del lado de Kunavo. El importe del catálogo es un mínimo de facturación, no un límite: cuando el proveedor ascendente comunica su cargo, la factura es el mayor entre el coste del catálogo y el coste ascendente multiplicado por el margen aplicable, como explica la guía de facturación. Además, la recarga mínima es $10 de crédito prepago, que es el efectivo necesario para abrir una cuenta financiada, no una tarifa de tarea ni una suscripción. Los cargos de caché son independientes y están documentados en caché.

La tarifa publicada más barata no es la tarea terminada más barata

Son dos afirmaciones distintas, y confundirlas es la forma en que una vía barata se vuelve cara. Un modelo más pequeño, con un tercio del precio por millón, sigue costando más en total si necesita tres intentos para realizar el cambio que un modelo más potente consigue a la primera. Decide primero por la vía y después por el modelo:

• Radius cuando quieras la ruta que Pi integra: OAuth mediante /login, una tabla de tarifas publicada y metadatos de costes que Pi ya sabe mostrar. Sus preguntas frecuentes indican que BYOK está disponible para clientes empresariales.
• Una clave directa del proveedor cuando quieras las funciones, el soporte y las condiciones del propio proveedor, y solo necesites una familia de modelos.
• Una suscripción existente solo después de leer la sección anterior. Es un requisito previo para el uso adicional por token, no una asignación incluida para Pi.
• Una pasarela compatible como Kunavo cuando la tarifa por token del modelo elegido sea el factor decisivo y estés dispuesto a configurar manualmente un proveedor personalizado.
• Inferencia local cuando el hardware ya sea tuyo y el modelo gestione realmente tu flujo de trabajo con herramientas. Pi documenta Ollama, vLLM y LM Studio como proveedores personalizados.

Después, mide. La documentación de uso de Pi describe un pie de TUI que muestra el uso de tokens/caché, el coste, el uso de contexto y el modelo actual, y /session como la impresión del archivo de sesión, el ID, los mensajes, los tokens y el coste; siempre que el coste esté configurado, que es el detalle importante de la sección siguiente. Ejecuta la misma tarea acotada con dos candidatos antes de migrar trabajo programado.

Dirigir Pi a tu propio endpoint

Pi no documenta ninguna variable de entorno genérica para la URL base. No existe ANTHROPIC_BASE_URL ni OPENAI_BASE_URL entre sus variables documentadas; desde la actualización de documentación del 22 de septiembre de 2026, la única entrada de endpoint es AZURE_OPENAI_BASE_URL, en la página de proveedores; la actualización eliminó AWS_ENDPOINT_URL_BEDROCK_RUNTIME, que la documentación había mostrado como variable estándar del SDK de AWS para un proxy de Bedrock; por tanto, un endpoint personalizado se introduce en ~/.pi/agent/models.json. Ese archivo se vuelve a cargar cada vez que abres /model, de modo que puedes editarlo durante la sesión. Hasta la misma actualización, Pi documentaba exactamente cuatro protocolos de conexión para ello: openai-completions, openai-responses, anthropic-messages y google-generative-ai. La página de modelos actualizada no enumera ninguno; muestra openai-completions en un ejemplo y describe el caso como «Un endpoint compatible con OpenAI, Anthropic o Google»; y el código fuente de Pi en v0.99.2 tipa el campo como una cadena libre y lo envía a cualquiera de las diez implementaciones integradas que coincida: las cuatro anteriores más mistral-conversations, azure-openai-responses, openai-codex-responses, bedrock-converse-stream, google-vertex y pi-messages. Solo las cuatro llegaron a documentarse para un proveedor personalizado, y ninguna de las otras seis se probó aquí. Kunavo ofrece las tres primeras de las cuatro; no tiene una ruta de Google Generative AI, por lo que ese cuarto tipo no tiene equivalente en Kunavo.

La configuración siguiente está redactada a partir de la documentación de modelos de Pi y, cuando la actualización de documentación del 22 de septiembre de 2026 eliminó un detalle, del código fuente de Pi en v0.99.2, además de los endpoints documentados de Kunavo. No se ha ejecutado contra Kunavo aquí. La guía de integración de Pi de Kunavo es la referencia de configuración publicada para este cliente; utiliza la ruta compatible con OpenAI, no incluye esta ruta anthropic-messages en un bloque para copiar y pegar, y tampoco se ha probado en tiempo de ejecución. Trata el bloque siguiente como un punto de partida que debes verificar, conserva disponible tu ruta de trabajo y espera tener que ajustarlo.

{
  "providers": {
    "kunavo": {
      "baseUrl": "https://api.kunavo.com",
      "api": "anthropic-messages",
      "apiKey": "$KUNAVO_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5",
          "name": "Claude Sonnet 5",
          "reasoning": true,
          "input": [
            "text",
            "image"
          ],
          "cost": {
            "input": 1.4,
            "output": 7,
            "cacheRead": 0.14,
            "cacheWrite": 1.75
          }
        }
      ]
    }
  }
}

Cuatro notas sobre ese bloque, cada una un problema real:

1. La URL base es el origen, sin /v1. Los clientes de estilo Anthropic añaden /v1/messages por sí mismos, así que https://api.kunavo.com/v1 genera solicitudes a /v1/v1/messages y un 404; consulta la página sobre la URL base. La propia documentación de Pi nunca resolvió esto: hasta la actualización del 22 de septiembre de 2026, un ejemplo anthropic-messages utilizaba un https://proxy.example.com solo con el origen y otro utilizaba https://proxy.example.com/v1, y la actualización eliminó ambos sin resolverlo. Si la primera llamada devuelve 404, esta es la línea que debes cambiar. Un proveedor compatible con OpenAI adopta la convención contraria, https://api.kunavo.com/v1 con api establecido en openai-completions.
2. El bloque cost no es opcional en la práctica. El código fuente de Pi (v0.99.2) le asigna por defecto todo ceros — la documentación actualizada ya no lo indica —, por lo que un proveedor que añadas tú mismo muestra 0 $ en el pie y en /session hasta que introduzcas las tarifas. Los proveedores integrados y Radius obtienen las suyas de un catálogo; el tuyo no. Las cifras anteriores se representan a partir del catálogo actual de Kunavo, con la tarifa de lectura de caché de la tabla de caché y las escrituras de caché de Claude a 1,25× la entrada.
3. Establece los límites de contexto y salida. El mismo código fuente establece por defecto para un modelo personalizado una ventana de contexto de 128.000 tokens y un máximo de salida de 16.384 tokens. Añade contextWindow y maxTokens de acuerdo con el modelo elegido, o Pi gestionará una conversación mediante un límite que el endpoint nunca impuso.
4. Deja inicialmente intactos los indicadores de compatibilidad con Anthropic. Ahora sus valores predeterminados están en el código fuente de Pi (v0.99.2) y no en su documentación, y no todos apuntan en la misma dirección. supportsEagerToolInputStreaming y supportsLongCacheRetention tienen true por defecto; Pi envía eager_input_streaming por herramienta, a menos que establezcas el primero en false porque un backend rechaza el campo; mientras que supportsStrictTools, allowEmptySignature y supportsMidConvoEffort tienen false por defecto. Hasta la actualización de documentación del 22 de septiembre de 2026, Pi advertía que el último solo corresponde a un transporte Anthropic Messages fiel, no a APIs que simplemente imitan la estructura; la página de modelos actualizada lo reemplaza por una regla para todos: los ajustes de compatibilidad «deben describir diferencias verificadas en el comportamiento de solicitud o respuesta del endpoint. No los habilites basándote únicamente en que un endpoint anuncie compatibilidad con OpenAI o Anthropic». No se ha probado cuáles acepta Kunavo, por lo que el bloque anterior no establece ninguno.

Vale la pena conocer otro mecanismo: apiKey acepta $ENV_VAR, un !shell-command cuya salida estándar se utiliza, o un literal. No es necesario para cargar el archivo y, desde la actualización de documentación del 22 de septiembre de 2026, la página de modelos de Pi publica el orden en que se resuelven las credenciales: «primero un --api-key de ejecución, después una credencial auth.json almacenada, un apiKey de models.json y, por último, las variables de entorno del proveedor o las credenciales ambientales de la nube». Hasta que Pi pueda resolver alguna credencial, la misma página afirma que los modelos personalizados se cargan desde models.json pero «siguen sin estar disponibles en /model».

Si prefieres seguir una página de configuración publicada en lugar de adaptar este bloque, empieza por la guía de integración de Pi; si todavía estás eligiendo un cliente, Pi frente a OpenCode compara ambos agentes, y el índice de integraciones enumera todos los clientes con una guía de configuración de Kunavo. Cuando estés listo para calcular el precio de una tarea real, crea una cuenta de Kunavo y ejecuta un cambio acotado con el modelo preseleccionado.

Preguntas frecuentes

La documentación de Pi, Radius y Anthropic se comprobó el 18 de septiembre y se verificó de nuevo el 21 de septiembre de 2026. Después de la actualización de documentación de Pi del 22 de septiembre de 2026, el orden de credenciales y los ejemplos de URL base de anthropic-messages se volvieron a comprobar en su página de modelos el 1 de octubre de 2026, junto con los valores predeterminados de modelos personalizados en su código fuente v0.99.2. Ese mismo día se volvió a comprobar la línea sobre uso adicional en la página de ajustes de Pi y la advertencia de terminal en su código fuente v0.99.2; la lista de rutas /login y las variables de endpoint en su página de proveedores; la lista de API y las indicaciones sobre indicadores de compatibilidad en su página de modelos, con el envío de API y los valores predeterminados de los indicadores en el código fuente; y el índice de integraciones de este sitio. Las tarifas de Kunavo y todos los totales de esta página se representan a partir del catálogo actual y son cálculos ilustrativos de tokens, no costes de tareas medidas. No se ha realizado ninguna prueba de ejecución de Pi con Kunavo.