mini-SWE-agent frente a Claude Code: flujo de trabajo, modelos y coste total

mini-SWE-agent y Claude Code no son dos versiones del mismo producto: mini es un agente de Python gratuito con licencia MIT y una sola herramienta — bash — que llega a cualquier modelo mediante LiteLLM, mientras que Claude Code es el agente propietario de Anthropic que solo habla protocolos con formato Anthropic. Esa única diferencia determina la mayoría de las migraciones, porque es un límite de protocolo y no una preferencia. Elige mini cuando quieras un arnés lo bastante pequeño como para leerlo y libertad para elegir proveedor; elige Claude Code cuando quieras las interfaces de editor, escritorio y CI, los modos de permisos y la ruta de suscripción, y vayas a quedarte con modelos de Claude.

mini-SWE-agent se mantiene en la organización SWE-agent de GitHub y se describe como «Creado por el equipo de Princeton & Stanford responsable de SWE-bench, SWE-agent y más». Antes que nada, una corrección, porque el dato más citado sobre él está desactualizado. Su guía de migración a v2 indica que «v2.0 utiliza llamadas nativas a herramientas de forma predeterminada (en lugar de analizar texto mediante expresiones regulares)», mientras que las preguntas frecuentes del propio proyecto todavía dicen que «ni siquiera utiliza la interfaz de llamadas a herramientas de los modelos de lenguaje» y que «Las acciones se extraen de bloques delimitados por tres acentos graves». Ambas páginas se consultaron el 19 de septiembre de 2026. La guía de migración y la configuración distribuida tienen prioridad: mini.yaml le indica al modelo que «Cada respuesta debe utilizar la herramienta 'bash' al menos una vez para ejecutar comandos». Cualquier tutorial basado en la afirmación de que no se utilizan llamadas a herramientas, o en la variable eliminada MSWEA_MODEL_API_KEY, es anterior a v2.

Cuál deberías elegir

Elige mini-SWE-agent si tu trabajo tiene forma de lotes o depende del proveedor: ejecutar el mismo prompt para muchos problemas, evaluar modelos entre sí o trabajar dentro de un entorno aislado donde un agente lo bastante pequeño para auditarlo supera a un conjunto de funciones que no puedes inspeccionar. Su modelo de ejecución es la propiedad decisiva: la FAQ de mini describe las acciones como ejecuciones mediante subprocess.run, donde «cada acción es completamente independiente (en lugar de mantener una sesión de shell con estado)», por lo que «el agente no puede cambiar de directorio ni exportar variables de entorno; sin embargo, las variables de entorno se pueden establecer por acción». El archivo mini.yaml distribuido indica lo mismo al modelo: «Los cambios de directorio o de variables de entorno no son persistentes. Cada acción se ejecuta en un nuevo subshell», y en su lugar lo dirige a un comando con prefijo. Esto hace que las ejecuciones sean reproducibles y trivialmente contenedorizables, y dificulta el trabajo prolongado con un shell con estado. El coste de migración es una tarde: pip install mini-swe-agent, un archivo YAML y una clave.

Elige Claude Code si el valor está en las superficies disponibles y las barreras de protección. Anthropic lo describe como disponible «en tu terminal, IDE, aplicación de escritorio y navegador», y señala que «la CLI de Terminal, VS Code y JetBrains también admiten proveedores externos», por lo que una ruta mediante gateway solo existe en algunos de ellos. Incluye modos de permisos, subagentes, servidores MCP, hooks y modo de planificación; con una suscripción Pro o Max, tu uso se descuenta de la asignación del plan en lugar de facturarse por token. El coste es un tipo específico de dependencia: no puedes desvincularlo de los modelos Claude, y la documentación del gateway de Anthropic afirma que «no admite enrutar Claude Code a modelos que no sean Claude mediante ningún gateway».

Cambiar de Claude Code a mini significa renunciar al sistema de permisos a cambio de los tres modos de mini, renunciar por completo a las superficies de IDE y escritorio, y asumir tu propia contabilidad del gasto: el presupuesto por ejecución de mini solo funciona cuando LiteLLM puede asignar un precio al id de tu modelo. Cambiar de mini a Claude Code significa renunciar a elegir libremente el modelo y pasar de un arnés que puedes leer a un binario incluido: el repositorio de claude-code es un punto de distribución, y su archivo de licencia es un aviso de una sola línea —«© Anthropic PBC. Todos los derechos reservados»—, cuyo uso está sujeto a las Condiciones de servicio comerciales de Anthropic.

Los dos agentes, uno junto al otro

Fuentes consultadas el 19 de septiembre de 2026: los metadatos de PyPI de mini, el documento del registro npm de Claude Code, la página de la CLI de mini, el mini.yaml distribuido por mini y la referencia de la CLI y la visión general de Anthropic.

Por qué «mini supera a Claude Code» no es una conclusión

La página de inicio de mini incluye una noticia que dice «mini-swe-agent supera a Claude Code y Codex en DeepSWE», y merece la pena leer qué midió realmente DeepSWE. Su artículo afirma: «Cada ejecución usa mini-swe-agent, el arnés que crearon los autores de SWE-bench. Lo mantenemos fijo en todos los modelos para que la tabla de clasificación refleje la capacidad del modelo, no la infraestructura que lo rodea». Por tanto, la tabla de clasificación es una clasificación de modelos dentro de mini, no una clasificación de mini frente a otros agentes.

La única comparación entre arneses de ese trabajo es un piloto con «las mismas 10 tareas de SWE-Bench Pro», en el que el arnés estandarizado igualó o superó a los nativos con un coste de tokens comparable; sus autores advierten inmediatamente que «parte de esa diferencia probablemente se deba al ajuste del prompt y no a la capacidad». Diez tareas con un puñado de modelos no constituyen una muestra capaz de clasificar dos agentes, y durante la investigación de esta página no se encontró ninguna otra comparación directa creíble de tamaño útil. Por ello, esta guía no les asigna una puntuación. Compara lo que se puede comprobar: protocolo, permisos, controles de gasto y coste de migración.

La pregunta clave: a qué endpoints puede llegar cada uno

Aquí es donde más divergen los dos, y es la parte que determina si un gateway siquiera es una opción.

Claude Code está limitado por el protocolo. La guía de compatibilidad de gateways de Anthropic enumera tres formatos: Anthropic Messages, seleccionado mediante ANTHROPIC_BASE_URL y con llamadas a /v1/messages más un /v1/messages/count_tokens opcional; Amazon Bedrock InvokeModel; y rawPredict de Google Cloud Agent Platform. No existe un modo chat-completions. La URL base es un origen, porque Claude Code añade la ruta; es la misma regla que codifica la propia página de ANTHROPIC_BASE_URL de Kunavo.

# Claude Code speaks the Anthropic Messages format and appends the route
# itself, so the variable is the ORIGIN — not the /v1 URL mini wants.
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...              # sent as Authorization: Bearer

# Pin models Kunavo serves. Claude Code's default and its opus alias are the
# newest Opus — pinned here to Opus 5.5, which needs Claude Code v2.1.280 or
# later (run `claude update`). The sonnet alias asks for Sonnet 5.5, which
# Kunavo does not serve: unpinned, /model sonnet, opusplan's execution phase
# and sonnet subagents 404.
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

claude

Hay tres consecuencias para las que conviene presupuestar. La variable de credenciales determina el encabezado: la página de conexión de Anthropic afirma que «ANTHROPIC_AUTH_TOKEN en Authorization: Bearer, ANTHROPIC_API_KEY en x-api-key y apiKeyHelper en ambos», y que una credencial en la variable equivocada «llega al gateway en un encabezado que no lee, y la solicitud falla con 401». La caché de prompts no tiene emparejamiento beta y falla silenciosamente: la guía de Anthropic dice que un gateway que elimina cache_control produce «Ningún error: la conversación se factura como entrada no almacenada en caché en cada turno». Además, el descubrimiento de modelos está desactivado a menos que establezcas CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, tras lo cual Claude Code conserva únicamente los ids que contienen «claude» o «anthropic».

mini no está sujeto a un protocolo, pero requiere mucha configuración. No existe ninguna variable de entorno de URL base; su página de modelos locales explica que model_kwargs se pasa directamente como litellm.completion(model=model_name, messages=messages, **model_kwargs). Conserva aquí el sufijo /v1, lo contrario de la regla de Claude Code anterior. El propio ejemplo de esa página establece custom_llm_provider: "openai" en un nombre de modelo sin prefijo, por lo que el prefijo openai/ que aparece a continuación es una medida adicional, no un requisito; lo que la página sí exige es que, si usas cualquiera de los dos, «esto también debe coincidir con litellm_provider en la configuración».

# mini has no base-URL environment variable. The endpoint goes in a config
# file, because model_kwargs is splatted straight into litellm.completion().
model:
  model_name: "openai/claude-sonnet-5"        # prefix and provider must agree
  model_kwargs:
    custom_llm_provider: "openai"
    api_base: "https://api.kunavo.com/v1"    # keep /v1 here
    drop_params: true                        # the shipped mini.yaml sets this too
  # set_cache_control is already "default_end" for a name containing "claude"

Proporciona la clave como OPENAI_API_KEY, ya sea en el entorno o mediante mini-extra config set, que escribe el .env de mini; la página de configuración global de mini señala que «Las variables de entorno tienen prioridad sobre las variables establecidas en el archivo .env». Selecciona el archivo con mini -c kunavo.yaml, o conviértelo en el predeterminado mediante MSWEA_MINI_CONFIG_PATH.

Hay un modo de fallo silencioso que merece su propia solución. El presupuesto por ejecución de mini se aplica mediante el seguimiento de costes de LiteLLM, que necesita reconocer el id del modelo; para esta página no se comprobó si los ids de Kunavo tienen precio en el registro de LiteLLM. Supón que no lo tienen y proporciona tú mismo las tarifas, en lugar de recurrir a MSWEA_COST_TRACKING="ignore_errors", que elimina la protección en vez de repararla. Apunta LITELLM_MODEL_REGISTRY_PATH a un archivo con el formato de precios de modelos de LiteLLM. El ejemplo práctico de mini usa como clave el nombre del modelo sin su prefijo de proveedor y declara el proveedor en litellm_provider, que es la estructura copiada aquí:

{
  "claude-sonnet-5": {
    "input_cost_per_token": 0.0000014000,
    "output_cost_per_token": 0.0000070000,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Dos lagunas reconocidas. Kunavo no ha probado en tiempo de ejecución ninguno de los dos clientes contra su endpoint, y publicar una referencia de configuración no es una prueba de compatibilidad. En concreto, no se ha verificado si la ruta openai/ de LiteLLM negocia llamadas nativas a herramientas —el valor predeterminado de v2 de mini— con el endpoint de chat-completions de Kunavo. Si no lo hace, mini todavía incluye la ruta heredada de análisis de texto como model_class: litellm_textbased, con una configuración mini_textbased.yaml junto a la predeterminada. Mantén abierta una ruta funcional mientras pruebas cualquiera de los dos clientes y lee lo que tu cuenta haya registrado realmente para una tarea acotada.

Cuánto cuesta ejecutar cada uno

Los precios del software no son comparables, porque solo uno de ellos tiene precio.

La tarjeta de precios y el artículo de soporte describen los niveles Max de forma diferente: uno los resume en una única cifra «desde», mientras que el otro nombra ambos. Confirma el nivel y el total en el proceso de pago antes de presupuestarlo. Los precios por puesto de Team y Enterprise se omiten aquí deliberadamente: son una decisión de puestos para una organización, no la elección de un desarrollador individual de la que trata esta página.

Para el uso medido, Anthropic publica un intervalo en lugar de una cifra por tarea: «En implementaciones empresariales, el coste medio es de unos $13 por desarrollador y día activo y de $150-250 por desarrollador y mes, y los costes se mantienen por debajo de $30 por día activo para el 90% de los usuarios» (documentación de gestión de costes). Es un agregado de las propias implementaciones de Anthropic, no una medición de un agente frente al otro, y no existe una cifra equivalente para mini.

Una estimación práctica de tokens

Esto es aritmética ilustrativa de tokens, no un coste de tarea medido ni un límite de facturación. Ambos agentes vuelven a enviar la conversación en cada turno; la propia documentación de Anthropic afirma que «Claude Code envía la conversación completa con cada solicitud y, cada vez que Claude usa herramientas, envía otra solicitud que contiene ese lote de resultados de herramientas», por lo que la entrada domina. Supón una tarea acotada que totaliza 600k tokens de entrada sin caché a lo largo de sus turnos y 25k tokens de salida. Las tarifas son los precios actuales de catálogo de Kunavo por millón de tokens.

Léelo como una proporción, no como una previsión. Bajo estos supuestos, la diferencia entre Claude Haiku 4.5 y Claude Opus 5 es de aproximadamente 5.0×, lo que supone una palanca mayor que la elección del cliente. Observa también que la tarifa más barata indicada y el menor coste para terminar la tarea son afirmaciones diferentes: un modelo más barato que necesita tres intentos puede costar más que uno que acierta a la primera, y el bucle de subprocesos independientes de mini vuelve a enviar más contexto cuando falla un paso. La caché vuelve a cambiar el panorama, y no en la dirección que supone la mayoría de los artículos. Claude Code añade por sí mismo marcadores cache_control. mini también establece set_cache_control: "default_end" por su cuenta, pero solo para algunos nombres de modelo: su código de selección de modelos aplica ese valor predeterminado cuando el nombre de modelo resuelto contiene anthropic, claude, sonnet o opus y la configuración todavía no ha establecido la clave. Por tanto, un id con nombre Claude —incluido el openai/claude-sonnet-5 con prefijo anterior— obtiene marcadores sin que los solicites; un id con nombre Gemini no. Para esta página no se probó si un endpoint de chat-completions actúa sobre esos marcadores. Consulta caché de prompts.

El importe del catálogo de Kunavo es un mínimo de facturación, no un límite: cuando el upstream informa de su cargo, la factura es el mayor valor entre el coste del catálogo y el coste del upstream multiplicado por el margen aplicable. Los cargos de caché y las herramientas externas quedan fuera de este ejemplo. La recarga mínima es $10 en crédito prepago: un mínimo de financiación, no una tarifa por tarea ni una suscripción. Consulta los detalles de facturación y ten en cuenta que la cifra propia de Claude Code /usage se «calcula localmente a partir de los recuentos de tokens al precio de lista» y es explícitamente «una estimación», así que concíliala con el libro mayor de tu proveedor en lugar de con la lectura del cliente.

Una aclaración más: SWE-agent no es mini-SWE-agent

El hermano mayor todavía aparece en los resultados de estas consultas y comparte una organización, una familia de README y una línea de ascendencia de benchmarks, pero tiene una sintaxis de configuración diferente, documentación diferente y no tiene lugar en un tutorial de mini. Sus propios mantenedores han avanzado: el README de SWE-agent afirma que «La mayor parte de nuestro esfuerzo de desarrollo actual se centra en mini-swe-agent, que ha sustituido a SWE-agent» y recomienda mini en adelante (consultado el 19 de septiembre de 2026). No está archivado y el proyecto tiene licencia MIT, así que considéralo mantenido pero superado, no abandonado, y comienza los trabajos nuevos con mini.

Configuración de cualquiera de los dos

Kunavo publica una referencia de configuración para Claude Code y ninguna para mini-SWE-agent; aquí no se ha probado en tiempo de ejecución ninguno de los dos clientes, y una página de configuración publicada no es una prueba de compatibilidad. Si Claude Code es tu cliente, comienza por la guía de integración de Claude Code y crea una cuenta de Kunavo cuando estés listo para financiar una clave. Si primero estás valorando la suscripción frente a los tokens medidos, precios de Claude Code y Claude Code sin suscripción cubren esa decisión, y la mejor API para Claude Code compara las rutas. Para mini, el patrón es el genérico descrito en API compatible con OpenAI. ¿Estás comparando otros agentes de terminal? OpenCode frente a Claude Code y precios de Aider cubren otros dos clientes con la misma separación entre un arnés gratuito y una factura de modelo medida.

Preguntas frecuentes

Comprobado el 19 de septiembre de 2026 mediante la consulta directa de cada fuente: los metadatos de PyPI de mini-SWE-agent, su página de inicio, la guía de migración a v2, la FAQ, la CLI, las páginas de configuración global y de modelos locales, sus archivos mini.yaml, run/mini.py y models/__init__.py distribuidos en la rama principal; el documento del registro npm de Claude Code, el archivo de licencia de su repositorio y sus documentos de visión general, gateway, protocolo de gateway, conexión al gateway, costes y referencia de la CLI; claude.com/pricing y el artículo de soporte del plan Max; el README de SWE-agent; y el artículo de DeepSWE. No se realizó ninguna prueba en tiempo de ejecución de ninguno de los dos clientes contra Kunavo y no se reprodujo ningún resultado de benchmark de esta página. Las tarifas de tokens de Kunavo proceden del catálogo actual, y todos los ejemplos en dólares son aritmética ilustrativa de tokens.