Agente de programación Pi frente a Claude Code: flujo de trabajo, permisos y coste total

Pi y Claude Code son agentes de programación para terminal que pueden apuntarse a un endpoint que elijas, pero no son el mismo tipo de producto. Pi es software con licencia MIT que deja la mayor parte de la estructura del agente en manos de las extensiones; Claude Code es software propietario construido en torno a un sistema de permisos aplicado y al protocolo Anthropic Messages. Esos dos hechos determinan la comparación más que cualquier lista de funciones, porque uno está diseñado para ejecutar los modelos que sirva tu endpoint, mientras que Anthropic documenta que el otro no admite eso.

Primero, una aclaración, porque el nombre coincide. «Pi» aquí es el agente de programación publicado en pi.dev por Earendil Inc., no Pi de Inflection AI en pi.ai, ni la moneda Pi Network, ni Raspberry Pi. Su CLI es @earendil-works/pi-coding-agent, tiene licencia MIT, su versión más reciente es 0.86.1, publicada el 20 de septiembre de 2026 en el registro npm, y su repositorio earendil-works/pi tiene licencia MIT, no está archivado y recibió su último push el 21 de septiembre de 2026 (API de GitHub). Claude Code se instala desde @anthropic-ai/claude-code, su versión más reciente es 2.1.278, publicada el 19 de septiembre de 2026, y su LICENSE.md dice íntegramente: «© Anthropic PBC. All rights reserved. Use is subject to Anthropic's Commercial Terms of Service». Ambos clientes se actualizan con frecuencia, así que considera estas cifras como las del 21 de septiembre de 2026, no como actuales; las comprobaciones de documentación que aparecen a continuación están fechadas el 19 de septiembre de 2026.

Cuál deberías elegir

Responde a estas preguntas en orden. La primera que te dé una respuesta firme es la decisión.

• ¿Necesitas reglas de permisos en las que otra persona pueda confiar? Entonces, Claude Code. Su documentación de permisos define seis modos: default (etiquetado como Manual), acceptEdits, plan, auto, dontAsk y bypassPermissions; y afirma que «las reglas de permisos las aplica Claude Code, no el modelo», con reglas de permitir, preguntar y denegar que puedes registrar en el control de versiones o establecer en la configuración administrada. La página de seguridad de Pi, tal como fue reescrita en su actualización de documentación del 22 de septiembre de 2026, dice lo contrario en términos claros: «Pi puede leer, cambiar y ejecutar archivos con los permisos de la cuenta que lo inició, y no solicita aprobación antes de cada llamada a una herramienta», e incluye la «falta de un sandbox integrado» entre los comportamientos generalmente fuera de su límite de seguridad. Su página de uso expresa lo mismo en una línea: «Pi no pregunta antes de cada llamada a una herramienta».
• ¿Necesitas ejecutar modelos de más de un laboratorio en un mismo cliente? Entonces, Pi. Su esquema de proveedores personalizados admitía openai-completions, openai-responses, anthropic-messages y google-generative-ai la última vez que su documentación enumeró valores, antes de la actualización del 22 de septiembre de 2026, y su código fuente en v0.99.2 admite diez. La página del gateway de Anthropic dice que «no admite enrutar Claude Code a modelos que no sean Claude mediante ningún gateway».
• ¿Quieres subagentes, modo de planificación y tareas pendientes sin tener que crearlos? Entonces, Claude Code. Hasta la actualización de documentación del 22 de septiembre de 2026, la página de uso de Pi decía que «deliberadamente no incluye MCP integrado, subagentes, ventanas emergentes de permisos, modo de planificación, tareas pendientes ni bash en segundo plano»; la actualización eliminó esa frase y MCP ya no forma parte de la lista: desde v0.99.0, la página de MCP de Pi dice que «se conecta a servidores del Protocolo de Contexto de Modelo mediante stdio o HTTP transmisible y hace que sus herramientas y recursos estén disponibles para el modelo». En v0.99.2, los subagentes, el modo de planificación y las tareas pendientes aún no están integrados; el repositorio solo los incluye como extensiones de ejemplo.
• ¿Necesitas que el propio agente sea abierto? Entonces, Pi: MIT en npm y en el repositorio, bifurcable y controlable desde otro proceso mediante --mode rpc. La licencia de Claude Code reserva todos los derechos.
• ¿Necesitas la aplicación de escritorio, la interfaz web o Remote Control? Entonces, Claude Code, y no mediante tu propio endpoint. Su descripción general dice: «La mayoría de las superficies requieren una suscripción de Claude o una cuenta de Anthropic Console. La CLI de Terminal, VS Code y JetBrains también admiten proveedores externos», y la pestaña de escritorio añade que se requiere una suscripción de pago. Remote Control es el caso separado: la referencia de variables de entorno de Anthropic indica que «a partir de v2.1.196, Remote Control está desactivado cuando esto apunta a un host distinto de api.anthropic.com».

Lo que nada de esto decide es cuál escribe mejor código. Para esta página no se realizó ninguna comparación controlada entre ambos, y nada de lo que aparece a continuación debe interpretarse como tal.

Comparación lado a lado

Filas tomadas del inicio rápido de Pi, de las páginas de uso y seguridad de Pi y de la documentación general, de permisos y de costes de Claude Code, el 19 de septiembre de 2026; las filas de permisos y MCP de Pi se volvieron a comprobar el 1 de octubre de 2026 contra Pi v0.99.2.

El modelo de ejecución es la diferencia real

La lista de omisiones de Pi solía leerse como una especificación, no como una lista de funciones ausentes: hasta la actualización de documentación del 22 de septiembre de 2026, su página de uso nombraba seis cosas que la mayoría de compradores supone que todo agente tiene —MCP integrado, subagentes, ventanas emergentes de permisos, modo de planificación, tareas pendientes y bash en segundo plano— y decía que las excluía deliberadamente. La actualización eliminó esa frase y, una semana después, v0.99.0 incorporó una de las seis: MCP es ahora una extensión integrada que se carga de forma predeterminada, configurada con pi mcp add o un archivo mcp.json. El resto de la lista sigue describiendo v0.99.2. Si tu flujo de trabajo depende de un paso de planificación antes de editar o de un aviso de permisos al que puedas responder que no, Pi te pide que lo crees o instales, no que lo configures.

Claude Code está en el extremo opuesto. Las reglas las evalúa el cliente, denegar tiene precedencia y un hook PreToolUse no puede anular una regla de denegación; por tanto, sobreviven a lo que diga el prompt o CLAUDE.md, que es lo que las hace útiles para una organización y no solo para un desarrollador. El concepto más cercano de Pi, la confianza del proyecto, es más limitado según su propia descripción: «La confianza del proyecto controla si Pi carga la mayoría de los ajustes y recursos proporcionados por una carpeta de trabajo. Impide que una carpeta cargue silenciosamente extensiones ejecutables antes de que las apruebes». La misma página explicita el límite: «La confianza del proyecto no limita a qué pueden acceder o afectar las llamadas a herramientas».

Ninguna de las dos posturas es incorrecta, pero solo una responde a una pregunta de auditoría. Resuélvelo antes de comparar precios: la configuración no puede cerrar esta brecha.

Apuntar cada cliente a tu propio endpoint

Esta es la segunda diferencia estructural, y funciona al revés. Claude Code usa una variable de entorno y una familia de protocolos; Pi usa un archivo JSON y los cuatro protocolos que documentó hasta el 22 de septiembre de 2026, y su código fuente acepta más.

La columna de Claude Code procede de su referencia de variables de entorno y su guía de compatibilidad con gateways, comprobadas el 19 de septiembre de 2026. Conviene detallar la fila «desactiva», porque cada elemento es una función que se pierde silenciosamente, no un error visible. Un ANTHROPIC_BASE_URL que no sea de primera parte desactiva la búsqueda de herramientas MCP de forma predeterminada, y se vuelve a activar con ENABLE_TOOL_SEARCH=true si el proxy reenvía bloques tool_reference; a fecha de la v2.1.196, Remote Control se desactiva cuando esa variable apunta a cualquier lugar distinto de api.anthropic.com; la transmisión detallada de herramientas está desactivada de forma predeterminada; y el descubrimiento de modelos es opcional, con CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 enviando GET /v1/models?limit=1000 con un tiempo de espera de tres segundos, tratando cualquier redirección como un fallo y conservando únicamente las entradas cuyo id contenga claude o anthropic. Dos comprobaciones omiten por completo la variable y llaman directamente a api.anthropic.com: la comprobación de disponibilidad del modo rápido y la comprobación de seguridad de dominios de WebFetch. Por tanto, una red que bloquee ese host las interrumpe aunque la inferencia siga funcionando.

La línea de la credencial importa para la facturación, no solo para la autenticación. La página del gateway de Anthropic lo deja claro: mientras una credencial de gateway está activa, «la credencial reemplaza el inicio de sesión de la suscripción durante esa sesión y no se aplican los límites de uso de la suscripción», y ese tráfico se factura por token a quien sea titular de la credencial. Establecer únicamente la URL base no produce ese efecto: un inicio de sesión guardado de claude.ai sigue siendo la credencial activa y sus límites continúan aplicándose.

# Claude Code: two environment variables, and whatever answers at that
# origin has to speak the Anthropic Messages API.
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin only, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...              # replaces the subscription

# Pin models Kunavo serves: Claude Code's default and its opus alias are the
# newest Opus, and if Kunavo does not serve it yet, the first request 404s.
# The sonnet alias asks for Sonnet 5.5, which Kunavo does not serve: unpinned,
# /model sonnet, opusplan's execution phase and sonnet subagents all 404.
# Opus 5.5 needs Claude Code v2.1.280 or later (run `claude update`).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Al origen le falta /v1: los clientes de estilo Anthropic añaden /v1/messages por sí mismos, por lo que https://api.kunavo.com/v1 genera solicitudes a /v1/v1/messages y devuelve un 404. Consulta la página sobre la URL base y la guía de configuración de Claude Code. Otra consecuencia específica de Kunavo: esta API no ofrece la ruta /v1/messages/count_tokens, y la guía de compatibilidad de Claude Code indica que los endpoints de recuento de tokens son los únicos opcionales. Sin ella, «Claude Code recurre a una estimación basada en caracteres del uso del contexto», por lo que /context muestra recuentos aproximados.

La versión de Pi para la misma tarea es un archivo y, como acepta API con formato de OpenAI, puede usar la ruta que Claude Code no ofrece:

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

Presta atención al /v1 final. Un proveedor openai-completions espera https://api.kunavo.com/v1. Para el formato anthropic-messages, la documentación de Pi nunca ha resuelto la cuestión: hasta la actualización de sus documentos del 22 de septiembre de 2026, la documentación de modelos de Pi mostraba ambas grafías en sus propios ejemplos: https://proxy.example.com/v1 en los encabezados personalizados y un https://proxy.example.com sin más bajo la compatibilidad con Anthropic Messages. La actualización eliminó ambas sin resolverlo, así que, si la primera llamada devuelve un 404, esta es la línea que debes cambiar. Hay otras dos trampas específicas de Pi que el código fuente de Pi (v0.99.2) todavía establece, aunque los documentos actualizados ya no las expliciten: el bloque cost de un modelo personalizado toma cero de forma predeterminada en todas las categorías de tarifas, por lo que un proveedor que añadas muestra $0 en el pie de página —que Pi documenta como el coste de la sesión— hasta que introduzcas las tarifas; y contextWindow y maxTokens toman silenciosamente los valores predeterminados 128.000 y 16.384, así que establece ambos en la ventana publicada en la página del modelo del catálogo. La precedencia de credenciales está documentada y conviene conocerla cuando gana una clave obsoleta: desde la actualización, la página de modelos de Pi indica que usa «primero un --api-key en tiempo de ejecución, después una credencial auth.json almacenada, un apiKey procedente de models.json y, por último, las variables de entorno del proveedor o las credenciales ambientales de la nube».

Planes y facturas de tokens en la misma página

Ninguno de los dos clientes cobra por sí mismo, así que toda la diferencia de coste depende de la capa que compres. Pi no tiene nada que comprar: cuenta con licencia MIT y pi.dev no publica ningún plan, nivel, puesto ni servicio alojado. Claude Code se puede instalar gratis, pero después necesita acceso desde algún lugar.

Todas las cifras de los planes de Anthropic se han tomado de claude.com/pricing el 19 de septiembre de 2026. Hay dos lagunas que conviene señalar: la página de Max no publica un precio independiente para el nivel 20x, así que cualquier «$200 por Max 20x» que leas en otro sitio no procede de esa página; y la cifra del puesto Premium realmente difiere entre la página de precios y la descripción general de la implementación empresarial, que muestra «Teams: $150/puesto (Premium) con PAYG disponible». Aquí no se resuelve ninguna de las dos discrepancias: comprueba la cifra que realmente te ofrezca el checkout. Ninguna página de Anthropic encontrada en esta comprobación publica horas, mensajes ni recuentos de tokens para Pro, Max 5x o Max 20x, por lo que esta página tampoco incluye ninguna cifra de uso.

Cuánto cuestan los tokens

Si colocas ambos clientes en el mismo endpoint, pagan la misma tarifa por token; lo que cambia entre ellos es cuánto contexto reenvía cada uno en cada paso, algo que depende mucho más de tu repositorio que de la herramienta y que aquí no se midió.

La tabla siguiente muestra una aritmética ilustrativa de tokens, no el coste medido de una tarea ni un límite máximo de facturación. Supón un día laborable de uso del agente: 12 turnos, cada uno con 60,000 tokens de entrada sin caché y 3,000 tokens de salida, para un total de 720,000 tokens de entrada y 36,000 de salida, sin lecturas de caché, escrituras de caché, imágenes ni cargos de herramientas. Las tarifas de Kunavo se representan a partir del catálogo activo; la columna del proveedor corresponde a claude.com/pricing, comprobada el 19 de septiembre de 2026.

Lee las filas, no la clasificación. Claude Sonnet 5 aparece con la misma cifra en ambas columnas, así que, para ese modelo, la ruta no es una cuestión de precio; Claude Opus 5 es donde se separan las dos columnas. Escala las cifras según tus propios días laborables antes de considerarlas un presupuesto, y ten en cuenta que esto supone que no hay almacenamiento en caché, la mayor omisión individual. La propia página de costes de Anthropic indica que «la duración de la caché de prompts es de una hora con una suscripción y baja a cinco minutos cuando utilizas créditos de uso; con una clave de API o un proveedor de nube, es de cinco minutos de forma predeterminada», por lo que la forma de pago cambia la tasa de aciertos de caché y, por tanto, la factura. Los cargos de caché de Kunavo están documentados en caching; no se ha probado si PI_CACHE_RETENTION=long llega a este endpoint.

Como referencia publicada, en lugar de una aritmética, la documentación de costes de Anthropic informa de que «en las implementaciones empresariales, el coste medio ronda los $13 por desarrollador y día activo y entre $150 y $250 por desarrollador al mes, y se mantiene por debajo de $30 por día activo para el 90 % de los usuarios», con procesos en segundo plano normalmente por debajo de $0.04 por sesión. Esa es la cifra de Anthropic para Claude Code con su propia facturación; no existe una cifra equivalente para Pi porque nadie publica una. El importe del catálogo de Kunavo es un suelo de facturación, no un límite máximo: cuando el upstream informa de su cargo, la factura es el mayor entre el coste del catálogo y el coste del upstream multiplicado por el margen aplicable, como explica facturación; y la recarga mínima es $10 en crédito prepagado, un mínimo de financiación, no una tarifa por tarea ni una suscripción.

La pregunta sobre la suscripción que nadie puede resolver por ti

Ambos clientes permiten iniciar sesión con un plan de Claude, y tres fuentes oficiales describen de forma diferente lo que eso implica. Aquí se citan con sus fechas en lugar de resolver la discrepancia, porque resolverla desde fuera sería adivinar.

Ninguna página de Anthropic menciona específicamente a Pi, y el permiso del artículo sobre el inicio de sesión es discrecional, no una garantía. En lo único que coinciden las tres fuentes es en la dirección general: una credencial de API es la vía que Anthropic prefiere para un cliente de terceros, y en Claude Code una credencial de gateway elimina por completo la suscripción de la sesión. Comprueba Ajustes y luego Uso en tu propia cuenta antes de enrutar trabajo de pago a través de un plan. Los límites del plan Claude cubre la parte de la suscripción, y Precios de Pi profundiza en las cuatro formas de pagar de Pi.

Lo que realmente cuesta pasar de uno a otro

Menos de lo que sugieren las listas de funciones, en una dirección. El contexto del repositorio se transfiere sin cambios: Pi carga AGENTS.md o CLAUDE.md desde los directorios actual y principal, con ~/.pi/agent/AGENTS.md para las instrucciones globales, así que un repositorio ya configurado para Claude Code no necesita modificaciones para que Pi lo lea. El uso mediante scripts también tiene un equivalente en ambos lados: claude -p y pi -p, con Pi añadiendo --mode json y --mode rpc para la integración con procesos.

Lo que no se transfiere es la mayor parte de la sección del modelo de ejecución: las reglas de permisos, las definiciones de subagentes y el modo de planificación no tienen un equivalente integrado en Pi al que migrar; el repositorio solo los incluye como extensiones de ejemplo, y las interfaces de escritorio y web no tienen ninguno. Los servidores MCP son la excepción desde v0.99.0: para una entrada de Claude Code, la página de MCP de Pi dice «Copia la entrada mcpServers existente». En la otra dirección, una extensión de Pi no tiene un equivalente de Claude Code que instalar. Aquí no se ofrece ninguna estimación de horas o días para el cambio porque no hay una base para hacerlo: ejecuta una tarea real y acotada en cada uno antes de trasladar trabajo programado.

Si estás preseleccionando opciones más ampliamente, Pi frente a OpenCode y OpenCode frente a Claude Code cubren los dos pares adyacentes, y Alternativas a Claude Code separa primero la cuestión de la herramienta de la cuestión de la facturación. Para el endpoint en sí, la guía de configuración de Claude Code es la referencia de configuración publicada, y crear una cuenta de Kunavo te proporciona una clave con la que probar una tarea.

Preguntas frecuentes

La documentación y los precios de los planes se comprobaron el 19 de septiembre de 2026 y se reconfirmaron el 21 de septiembre de 2026: las páginas de inicio rápido, uso, modelos, proveedores y seguridad de pi.dev; las páginas de descripción general, permisos, costes, variables de entorno, gateway y compatibilidad con gateways de code.claude.com; claude.com/pricing; y dos artículos de support.claude.com. Los números de versión, el archivo de licencia de anthropics/claude-code y la API de GitHub de earendil-works/pi se volvieron a consultar el 21 de septiembre de 2026. Después de la actualización documental 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 los modelos personalizados en su código fuente de v0.99.2. Ese mismo día, después de que Pi v0.99.0 incorporara MCP integrado, se volvieron a leer sus páginas de seguridad, uso, MCP y ajustes, así como la descripción general de la documentación, para comprobar las afirmaciones sobre el entorno aislado, los permisos, la confianza del proyecto y las funciones omitidas; la lista de API frente al código fuente de v0.99.2; y la línea sobre el uso adicional frente a la advertencia del terminal de ese código fuente. Las tarifas de tokens de Kunavo se representan a partir del catálogo activo y todas las cifras en dólares son aritmética ilustrativa de tokens, no el coste medido de una tarea. Ninguno de los dos clientes se ha probado en tiempo de ejecución contra Kunavo, y no se realizó ninguna comparación de calidad, velocidad o benchmarks entre ellos.