Claude Code vs Pi: un veterano explica su migración

Un veterano de Claude Code migra a Pi y explica por qué

244 releases en lo que va del año y más de tres cuartos de ellos tocando el system prompt o las descripciones de herramientas: ese es el recuento que un desarrollador publicó en su blog antes de anunciar que abandona Claude Code como su harness principal y se pasa a Pi, una alternativa de código abierto. Para cualquier equipo que ya tenga un agente de IA escribiendo código en producción, la noticia importa por una razón concreta: cuando el costo de cambiar de herramienta baja a unos pocos días de trabajo, la fidelidad a una suite deja de ser una garantía.

Pi es un harness de código abierto. Vale la pena definirlo porque el término se usa mucho y se explica poco: un harness es la capa de software que envuelve al modelo, decide qué ve, qué acciones puede ejecutar y cómo interactúa con tu repositorio. No es el modelo. Es el envoltorio.

Qué pasó exactamente

El autor del blog caleb.software cuenta que usó Claude Code desde que llegó al plan Claude Pro, hace más de un año, y que lo considera uno de los grandes impulsores de la era actual del desarrollo de software. Aun así, una acumulación de frustraciones pequeñas lo llevó a retirarlo como herramienta principal.

Leíste lo que hace la IA. ¿Y en tu negocio?

Un agente de IA puede quedarse con parte de tu día: ordenar lo pendiente y pedirte el OK antes de actuar. El Kit «tu mano derecha con IA» trae un video de 11 minutos y una ficha para dejar al tuyo trabajando. CAR está cerrada por ahora; al anotarte, te avisamos cuando abra.

👥 Quiero el Kit →

El detalle que le da color a la historia: un día después de tomar la decisión, Anthropic anunció que Claude Code empezaría a soportar archivos AGENTS.md. Su reacción fue que llegaba demasiado tarde.

Las fricciones que lo empujaron a Pi

Dos formatos de instrucciones. Claude Code buscaba instrucciones en CLAUDE.md, mientras el resto del ecosistema usa AGENTS.md. Mantener los dos obligaba a copiar archivos o crear symlinks.
Una sola sesión conectada al IDE. Si abrías una segunda pestaña para arrancar otra tarea, esa sesión no recibía los eventos de selección de texto del editor. Según el autor, el problema estaba reportado desde diciembre de 2025 y se cerró como duplicado de un bug sin relación.
La extensión GUI de VS Code. En su experiencia, la mitad de los slash commands no funcionan en la interfaz gráfica, no hay soporte para una status line personalizada y la salida de los subagentes se apila en el hilo principal en orden cronológico.
Ritmo de cambios. Contabiliza 244 releases de Claude Code en lo que va del año, y más de tres cuartos de ellas modificaron el system prompt o las descripciones de herramientas, algo que según él altera el desempeño del modelo y puede contradecir prompts del usuario o convenciones del repositorio.
Overhead de contexto. Incluso después de recortar el 80% del system prompt, sostiene que Claude Code sigue teniendo más overhead que Pi. La descripción por defecto de la herramienta Bash ronda los 3.000 tokens, buena parte dedicada a cómo usar git y abrir pull requests en GitHub.

La respuesta de Anthropic: AGENTS.md en la versión 2.1.277

InfoWorld reportó que Thariq Shihipar, miembro del staff técnico de Anthropic, anunció en X: «Estamos agregando soporte para AGENTS.md a Claude Code. A partir de hoy, en la versión 2.1.277, si no hay un CLAUDE.md en una carpeta, Claude buscará y usará AGENTS.md».

AGENTS.md es una iniciativa de código abierto gobernada por la Agentic AI Foundation, bajo la Linux Foundation. La promesa es concreta: un mismo archivo de instrucciones sirve para varios agentes, en lugar de mantener dos documentos que se desincronizan bajo presión de deadlines.

Hay letra chica. Amit Kumar Jena, jefe de desarrollo de IA en la consultora Kanerika, explicó a InfoWorld que el soporte depende de que la herramienta obtenga feature flags de Anthropic: si usas Claude Code a través de Amazon Bedrock o Google Vertex AI, o si desactivaste la telemetría, AGENTS.md no está disponible y Claude Code vuelve a CLAUDE.md. También advirtió que CLAUDE.md incluye funciones específicas de Claude que AGENTS.md no fue diseñado para soportar.

Charlie Dai, de Forrester, ve el otro lado: un formato común de instrucciones puede convertirse en un punto de control práctico para convenciones de código, requisitos de seguridad, guardrails de arquitectura y políticas de compliance.

La recepción en la comunidad fue tibia. XDA Developers resumió que los usuarios lo leen como un ajuste pequeño y largamente esperado, no como un gran avance.

El mercado de los harnesses dejó de ser un duopolio

Ars Technica conversó con Cat Wu, head of product de Claude Code, quien insiste en la idea de un lean harness: la estrategia de Anthropic es mantener pocas herramientas con opinión propia y dejar que los desarrolladores agreguen las suyas. El mismo artículo lista el resto del campo: Codex de OpenAI, Antigravity de Google, OpenCode y opciones de startups como Cursor o Augment Code.

La infraestructura alrededor también se mueve. Vercel publicó durable-harness, un paquete Apache-2.0 en versión 0.0.x y todavía experimental, con adaptadores para Pi, OpenCode, fx, Claude Code y Codex, que mantiene vivas las sesiones de agentes cuando una función se cae. Según MarkTechPost, Pi y OpenCode corren dentro de la propia función, mientras que Claude Code y Codex requieren un Vercel Sandbox.

Un nivel más arriba aparece Omnigent, un meta-harness de código abierto que maneja Claude Code, Codex, Cursor, OpenCode, Hermes y Pi desde una misma capa, con políticas de gasto y sandboxing por sistema operativo, según Help Net Security.

Sobre Pi en concreto, Geeky Gadgets lo describe como un minimal agent toolkit con filosofía local-first, más de 100.000 estrellas en GitHub y soporte para 11 configuraciones distintas de thinking format. La advertencia del mismo medio: no trae sistema de permisos incorporado, así que el aislamiento queda del lado del usuario.

¿Qué significa esto para tu startup?

El riesgo no es que Claude Code sea malo. Es el acoplamiento. Si las instrucciones de tu proyecto, tus convenciones de código y tus comandos de build viven en un formato propietario, cada cambio de herramienta se convierte en un proyecto de migración. El autor de este post tardó unos días de ajustes y escribió una extensión en unos 20 minutos para recuperar la funcionalidad que le faltaba. Eso es lo que deberías poder hacer tú.

El segundo punto es el costo del contexto, que es recurrente. Cada token de descripción de herramientas viaja en cada request. El autor hace una cuenta hipotética: con 1 millón de usuarios activos diarios y 100 millones de requests por día, recortar 1.000 tokens podría ahorrar millones de dólares al año en inferencia. Es una estimación suya, no una medición, pero la lógica aplica a tu factura.

Acciones concretas:

Adopta AGENTS.md como archivo canónico y deja CLAUDE.md solo para lo específico de Claude. Antes de hacerlo, verifica si tu despliegue lo soporta: si corres Claude Code sobre Bedrock o Vertex, o apagaste la telemetría, el cambio no aplica.
Fija la versión de tu harness. Con 244 releases en un año, tu setup puede romperse sin que tú hayas tocado nada. Prueba las actualizaciones en una rama antes de subirlas a todo el equipo.
Mide tu overhead de instrucciones. Suma los tokens de tus archivos de contexto y de las descripciones de herramientas. Si son miles, es un costo que pagas en cada request, todos los días.
Ten un plan B probado. Corre un harness open source en paralelo, aunque sea en un proyecto secundario. La pregunta no es si vas a migrar, sino cuánto te va a costar cuando lo necesites.

Conclusión

Claude Code no está en crisis: Anthropic sigue invirtiendo en la herramienta y su equipo de producto tiene una tesis clara sobre el lean harness. Lo que este post muestra es otra cosa, más incómoda para cualquier proveedor: la capa del harness se está volviendo un commodity. Pi, OpenCode, Codex, Antigravity y los meta-harnesses compiten por el mismo puesto, y un desarrollador con criterio puede cambiar de uno a otro en días.

Para un founder, la conclusión práctica es dónde poner el esfuerzo. Tu activo no es la herramienta que elegiste este trimestre, sino las instrucciones, convenciones y tests que escribiste para tu repositorio. Si esas viven en un formato abierto y portable, cambiar de harness es una tarde de trabajo. Si viven en un formato propietario, es una dependencia.