mini-SWE-agent vs Claude Code: flusso di lavoro, modelli e costo totale

mini-SWE-agent e Claude Code non sono due versioni dello stesso prodotto: mini è un agente Python gratuito con licenza MIT e un solo strumento — bash — che raggiunge qualsiasi modello tramite LiteLLM, mentre Claude Code è l'agente proprietario di Anthropic che parla solo protocolli con struttura Anthropic. Questa singola differenza determina la maggior parte delle migrazioni, perché costituisce un confine di protocollo anziché una preferenza. Scegli mini quando vuoi un harness abbastanza piccolo da poter essere letto e la libertà di scegliere il provider; scegli Claude Code quando vuoi le interfacce per editor, desktop e CI, le modalità di autorizzazione e il percorso basato sull'abbonamento, e intendi rimanere sui modelli Claude.

mini-SWE-agent è mantenuto nell'organizzazione GitHub SWE-agent e si descrive come «Creato dal team di Princeton e Stanford dietro SWE-bench, SWE-agent e altro». Prima di tutto, una correzione, perché il fatto più citato al riguardo non è aggiornato. La sua guida alla migrazione v2 afferma che «v2.0 utilizza per impostazione predefinita il tool calling nativo (anziché l'analisi del testo basata su regex)», mentre le FAQ del progetto affermano ancora che «non utilizza nemmeno l'interfaccia di tool calling degli LM» e che «le azioni vengono analizzate dai blocchi con tre backtick». Entrambe le pagine sono state consultate il 19 settembre 2026. La guida alla migrazione e la configurazione distribuita prevalgono: mini.yaml indica al modello che «ogni risposta deve utilizzare almeno una volta lo strumento 'bash' per eseguire i comandi». Qualsiasi tutorial basato sull'assenza di tool calling o sulla variabile MSWEA_MODEL_API_KEY rimossa è antecedente alla v2.

Quale dovresti scegliere

Scegli mini-SWE-agent se il tuo lavoro ha una struttura a batch o dipende dal provider: eseguire lo stesso prompt su molte issue, valutare modelli tra loro o lavorare in un sandbox in cui un agente abbastanza piccolo da poter essere sottoposto ad audit è preferibile a un insieme di funzionalità che non puoi ispezionare. Il suo modello di esecuzione è la caratteristica decisiva: le FAQ di mini descrivono le azioni come eseguite tramite subprocess.run, dove «ogni azione è completamente indipendente (anziché mantenere in esecuzione una sessione shell con stato)», perciò «l'agente non può cambiare directory né esportare variabili d'ambiente; tuttavia, le variabili d'ambiente possono essere impostate per singola azione». Anche il file mini.yaml distribuito comunica la stessa cosa al modello: «Le modifiche alla directory o alle variabili d'ambiente non sono persistenti. Ogni azione viene eseguita in una nuova subshell», e indica di usare invece un comando con prefisso. Questo rende le esecuzioni riproducibili e facilmente containerizzabili, ma rende macchinoso il lavoro prolungato in una shell con stato. Il costo della migrazione è di un pomeriggio: pip install mini-swe-agent, un file YAML, una chiave.

Scegli Claude Code se il valore risiede nelle superfici e nelle protezioni. Anthropic lo descrive come disponibile «nel terminale, nell'IDE, nell'app desktop e nel browser» e osserva che «anche Terminal CLI, VS Code e JetBrains supportano provider di terze parti»: quindi una route tramite gateway esiste solo su alcuni di essi. Include modalità di autorizzazione, subagenti, server MCP, hook e modalità piano; con un abbonamento Pro o Max, l'utilizzo attinge alla quota del piano anziché essere fatturato per token. Il costo è una forma specifica di lock-in: non puoi usarlo con modelli diversi da Claude e la documentazione del gateway di Anthropic afferma che «non supporta il routing di Claude Code verso modelli non-Claude tramite alcun gateway».

Passare da Claude Code a mini significa rinunciare al sistema di autorizzazioni in cambio delle tre modalità di mini, abbandonare completamente le superfici IDE e desktop e assumersi la responsabilità della contabilità della spesa: il budget per esecuzione di mini funziona solo quando LiteLLM è in grado di determinare il prezzo dell'id del modello. Passare da mini a Claude Code significa rinunciare alla libera scelta del modello e passare da un harness che puoi leggere a un binario distribuito: il repository di claude-code è un punto di distribuzione e il suo file di licenza contiene un avviso di una sola riga — «© Anthropic PBC. Tutti i diritti riservati» — con utilizzo soggetto ai Termini di servizio commerciali di Anthropic.

I due agenti a confronto

Fonti consultate il 19 settembre 2026: i metadati PyPI di mini, il documento del registro npm di Claude Code, la pagina CLI di mini, il file mini.yaml distribuito da mini e il riferimento CLI e la panoramica di Anthropic.

Perché «mini batte Claude Code» non è un verdetto

La homepage di mini contiene una notizia che recita «mini-swe-agent batte Claude Code e Codex su DeepSWE», e vale la pena leggere cosa abbia effettivamente misurato DeepSWE. Il suo articolo afferma: «Ogni esecuzione utilizza mini-swe-agent, l'harness creato dagli autori di SWE-bench. Lo manteniamo fisso per ogni modello, così la classifica riflette le capacità del modello, non l'impalcatura che lo circonda». La classifica è quindi una graduatoria dei modelli all'interno di mini, non una graduatoria di mini rispetto ad altri agenti.

L'unico confronto harness-contro-harness presente in quel lavoro è un pilot su «le stesse 10 attività di SWE-Bench Pro», in cui l'harness standardizzato ha eguagliato o superato quelli nativi a un costo in token comparabile; gli autori avvertono immediatamente che «parte di tale divario è probabilmente dovuta all'ottimizzazione del prompt, non alle capacità». Dieci attività su una manciata di modelli non costituiscono un campione in grado di classificare due agenti, e durante la ricerca per questa pagina non è stato trovato alcun altro confronto diretto credibile di dimensioni utili. Questa guida pertanto non assegna loro un punteggio. Confronta ciò che è verificabile: protocollo, autorizzazioni, controlli della spesa e costo della migrazione.

La domanda chiave: quali endpoint può raggiungere ciascuno

È qui che i due divergono maggiormente, ed è questo l'aspetto che determina se un gateway sia anche solo un'opzione.

Claude Code è vincolato al protocollo. La guida alla compatibilità dei gateway di Anthropic elenca tre formati: Anthropic Messages, selezionato da ANTHROPIC_BASE_URL e con chiamata a /v1/messages più un /v1/messages/count_tokens facoltativo; Amazon Bedrock InvokeModel; e rawPredict di Google Cloud Agent Platform. Non esiste una modalità chat-completions. Il base URL è un'origine, perché Claude Code aggiunge la route: la stessa regola codificata dalla pagina ANTHROPIC_BASE_URL di 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

Tre conseguenze da includere nel budget. La variabile delle credenziali determina l'header: la pagina di connessione di Anthropic afferma che «ANTHROPIC_AUTH_TOKEN in Authorization: Bearer, ANTHROPIC_API_KEY in x-api-key e apiKeyHelper in entrambi» e che una credenziale nella variabile errata «raggiunge il gateway in un header che non legge e la richiesta fallisce con 401». Il caching dei prompt non ha alcun abbinamento beta e fallisce silenziosamente: la guida di Anthropic afferma che un gateway che rimuove cache_control produce «Nessun errore: la conversazione viene fatturata come input non memorizzato nella cache a ogni turno». Inoltre, il rilevamento dei modelli è disattivato a meno che non si imposti CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, dopodiché Claude Code conserva solo gli id che contengono «claude» o «anthropic».

mini è privo di vincoli di protocollo, ma richiede molta configurazione. Non esiste affatto una variabile d'ambiente per il base URL; la sua pagina sui modelli locali spiega che model_kwargs viene passato direttamente come litellm.completion(model=model_name, messages=messages, **model_kwargs). Mantieni qui il suffisso /v1 — l'opposto della regola di Claude Code riportata sopra. L'esempio della stessa pagina imposta custom_llm_provider: "openai" su un nome di modello senza prefisso, quindi il prefisso openai/ riportato sotto è una precauzione aggiuntiva, non un requisito; ciò su cui la pagina insiste è che, se ne utilizzi uno dei due, «questo deve anche corrispondere a litellm_provider nella configurazione».

# 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"

Fornisci la chiave come OPENAI_API_KEY, nell'ambiente oppure tramite mini-extra config set, che scrive il file .env di mini; la pagina sulla configurazione globale di mini osserva che «le variabili d'ambiente hanno la precedenza sulle variabili impostate nel file .env». Seleziona il file con mini -c kunavo.yaml oppure impostalo come predefinito con MSWEA_MINI_CONFIG_PATH.

Una modalità di errore silenziosa merita una correzione specifica. Il budget di mini per ogni esecuzione viene fatto rispettare dal monitoraggio dei costi di LiteLLM, che deve riconoscere l'ID del modello — e per questa pagina non è stato verificato se nel registro di LiteLLM siano presenti i prezzi associati agli ID di Kunavo. Presumi che non lo siano e fornisci tu le tariffe, anziché ricorrere a MSWEA_COST_TRACKING="ignore_errors", che rimuove la protezione invece di ripararla. Fai puntare LITELLM_MODEL_REGISTRY_PATH a un file nel formato dei prezzi dei modelli di LiteLLM. L'esempio pratico di mini usa come chiave della voce il nome del modello senza il prefisso del provider e dichiara il provider in litellm_provider; questa è la struttura riprodotta qui:

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

Due lacune dichiarate. Kunavo non ha testato a runtime nessuno dei due client contro il proprio endpoint, e pubblicare un riferimento di configurazione non equivale a un test di compatibilità. In particolare, non è stato verificato se il percorso openai/ di LiteLLM negozi il tool calling nativo — il valore predefinito di mini v2 — con l'endpoint chat-completions di Kunavo. Se non lo fa, mini distribuisce comunque il percorso legacy di analisi del testo come model_class: litellm_textbased con una configurazione mini_textbased.yaml accanto a quella predefinita. Mantieni disponibile una route funzionante mentre provi uno dei due client e leggi ciò che il tuo account ha effettivamente registrato per un'attività con limiti definiti.

Quanto costa eseguire ciascuno

I prezzi del software non sono confrontabili, perché solo uno dei due ha un prezzo.

La scheda dei prezzi e l'articolo di supporto descrivono i livelli Max in modo diverso: uno li riassume in un'unica cifra «a partire da», l'altro li indica entrambi. Conferma il livello e il totale al checkout prima di inserirli nel budget. I prezzi dei posti Team ed Enterprise sono omessi intenzionalmente: riguardano una decisione sui posti per un'organizzazione, non la scelta del singolo sviluppatore oggetto di questa pagina.

Per l'utilizzo a consumo, Anthropic pubblica un intervallo anziché un costo per attività: «Nelle implementazioni enterprise, il costo medio è di circa $13 per sviluppatore al giorno attivo e $150-250 per sviluppatore al mese, con costi inferiori a $30 per giorno attivo per il 90% degli utenti» (documentazione sulla gestione dei costi). Si tratta di un aggregato delle implementazioni di Anthropic, non di una misurazione dei due agenti a confronto, e per mini non esiste una cifra equivalente.

Una stima dei token con esempio

Questo è un calcolo illustrativo dei token, non un costo misurato per attività né un tetto alla fatturazione. Entrambi gli agenti inviano nuovamente la conversazione a ogni turno: la documentazione di Anthropic afferma che «Claude Code invia l'intera conversazione con ogni richiesta e, ogni volta che Claude utilizza strumenti, invia un'altra richiesta contenente quel batch di risultati degli strumenti»; quindi è l'input a dominare. Supponi un'attività con limiti definiti che totalizzi 600k token di input non memorizzati nella cache nei suoi turni e 25k token di output. Le tariffe sono i prezzi attuali del catalogo Kunavo per milione di token.

Leggilo come un rapporto, non come una previsione. In base a queste ipotesi, la differenza tra Claude Haiku 4.5 e Claude Opus 5 è di circa 5,0×, un fattore più incisivo della scelta del client. Nota inoltre che la tariffa più bassa in elenco e il costo minimo per completare l'attività sono affermazioni diverse: un modello più economico che richiede tre tentativi può costare più di uno che riesce al primo tentativo, e il ciclo di subprocess indipendenti di mini invia nuovamente più contesto quando un passaggio fallisce. Il caching cambia ancora il quadro, e non nella direzione ipotizzata dalla maggior parte degli articoli. Claude Code aggiunge autonomamente i marcatori cache_control. Anche mini imposta autonomamente set_cache_control: "default_end", ma solo per alcuni nomi di modello: il suo codice di selezione del modello applica quel valore predefinito quando il nome del modello risolto contiene anthropic, claude, sonnet o opus e la configurazione non ha già impostato la chiave. Un id con nome Claude — incluso il openai/claude-sonnet-5 con prefisso riportato sopra — riceve quindi i marcatori senza che tu lo richieda; un id con nome Gemini no. Non è stato verificato per questa pagina se un endpoint chat-completions agisca su tali marcatori. Vedi caching dei prompt.

L'importo del catalogo Kunavo è un limite minimo di fatturazione, non un tetto: quando l'upstream comunica il proprio addebito, la fattura è il maggiore tra il costo del catalogo e il costo upstream moltiplicato per il markup applicabile. Gli addebiti per la cache e gli strumenti esterni non rientrano in questo esempio. Il ricarico minimo è $10 di credito prepagato: un minimo di finanziamento, non una tariffa per attività né un abbonamento. Consulta i dettagli di fatturazione e nota che il valore /usage di Claude Code è «calcolato localmente a partire dal conteggio dei token al prezzo di listino» ed è esplicitamente «una stima»; quindi riconcilia i dati con il registro del tuo provider anziché con il riepilogo del client.

Un'ulteriore distinzione: SWE-agent non è mini-SWE-agent

Il fratello maggiore continua a comparire per queste query e condivide un'organizzazione, una famiglia di README e una genealogia di benchmark, ma ha una sintassi di configurazione diversa, documentazione diversa e non trova posto in un tutorial su mini. I suoi manutentori hanno proseguito oltre: il README di SWE-agent afferma che «la maggior parte del nostro attuale lavoro di sviluppo è su mini-swe-agent, che ha sostituito SWE-agent» e raccomanda mini per il futuro (consultato il 19 settembre 2026). Non è archiviato e il progetto è distribuito con licenza MIT, quindi consideralo mantenuto ma superato, non morto; i nuovi lavori dovrebbero iniziare su mini.

Configurazione dell'uno o dell'altro

Kunavo pubblica un riferimento di configurazione per Claude Code e nessuno per mini-SWE-agent; nessuno dei due client è stato testato a runtime qui e una pagina di configurazione pubblicata non è un test di compatibilità. Se Claude Code è il tuo client, inizia dalla guida all'integrazione di Claude Code e crea un account Kunavo quando sei pronto a finanziare una chiave. Se prima vuoi valutare l'abbonamento rispetto ai token a consumo, Prezzi di Claude Code e Claude Code senza abbonamento coprono questa decisione, mentre la migliore API per Claude Code confronta le route. Per mini, il modello è quello generico descritto nell'API compatibile con OpenAI. Vuoi invece confrontare altri agenti da terminale? OpenCode vs Claude Code e Prezzi di Aider coprono altri due client con la stessa distinzione tra un harness gratuito e una fattura del modello a consumo.

Domande frequenti

Verificato il 19 settembre 2026 recuperando direttamente ogni fonte: i metadati PyPI di mini-SWE-agent, la sua homepage, la guida alla migrazione v2, le FAQ, la CLI, le pagine sulla configurazione globale e sui modelli locali, i file mini.yaml, run/mini.py e models/__init__.py distribuiti sul branch principale; il documento del registro npm di Claude Code, il file di licenza del suo repository e la documentazione di panoramica, gateway, protocollo del gateway, connessione al gateway, costi e riferimento CLI; claude.com/pricing e l'articolo di supporto del piano Max; il README di SWE-agent; e l'articolo su DeepSWE. Non è stato eseguito alcun test a runtime dei due client contro Kunavo e nessun risultato di benchmark riportato in questa pagina è stato riprodotto. Le tariffe dei token Kunavo provengono dal catalogo attuale e ogni esempio in dollari è un calcolo illustrativo dei token.