mini-SWE-agent vs Claude Code: fluxo de trabalho, modelos e custo total

mini-SWE-agent e Claude Code não são duas versões do mesmo produto: o mini é um agente Python gratuito, licenciado sob a MIT, com uma ferramenta — bash — que acessa qualquer modelo por meio do LiteLLM, enquanto o Claude Code é o agente proprietário da Anthropic que fala apenas protocolos no formato da Anthropic. Essa única diferença determina a maior parte das migrações, porque é um limite de protocolo, não uma preferência. Escolha o mini quando quiser um harness pequeno o bastante para ser lido e liberdade de escolha de provedor; escolha o Claude Code quando quiser as interfaces de editor, desktop e CI, os modos de permissão e o caminho de assinatura, mantendo-se nos modelos Claude.

O mini-SWE-agent é mantido na organização GitHub SWE-agent e se descreve como "Criado pela equipe de Princeton e Stanford por trás do SWE-bench, SWE-agent e muito mais". Antes de tudo, uma correção, porque o fato mais citado sobre ele está desatualizado. Seu guia de migração da v2 afirma que "a v2.0 usa chamadas nativas de ferramentas por padrão (em vez de análise de texto baseada em regex)", enquanto a própria FAQ do projeto ainda diz que "ele nem sequer usa a interface de chamada de ferramentas dos LMs" e que "As ações são analisadas a partir de blocos com três crases". Ambas as páginas foram consultadas em 19 de setembro de 2026. O guia de migração e a configuração enviada prevalecem: mini.yaml informa ao modelo que "Toda resposta precisa usar a ferramenta 'bash' pelo menos uma vez para executar comandos." Qualquer tutorial baseado na afirmação de ausência de chamadas de ferramentas, ou na variável MSWEA_MODEL_API_KEY removida, é anterior à v2.

Qual você deve escolher

Escolha o mini-SWE-agent se seu trabalho tiver formato de lote ou de provedor: executar o mesmo prompt em muitas issues, avaliar modelos uns contra os outros ou trabalhar em um sandbox onde um agente pequeno o bastante para ser auditado seja mais importante do que um conjunto de recursos que você não pode inspecionar. Seu modelo de execução é a propriedade decisiva: a FAQ do mini descreve ações executadas por meio de subprocess.run, em que "cada ação é completamente independente (em vez de manter uma sessão de shell com estado em execução)", portanto "o agente não pode mudar de diretório nem exportar variáveis de ambiente; no entanto, variáveis de ambiente podem ser definidas por ação". O mini.yaml enviado informa a mesma coisa ao modelo — "Alterações de diretório ou de variáveis de ambiente não são persistentes. Cada ação é executada em um novo subshell" — e, em vez disso, direciona-o para um comando com prefixo. Isso torna as execuções reproduzíveis e trivialmente conteinerizáveis, mas torna trabalhos longos e com estado no shell inconvenientes. O custo de migração é de uma tarde: pip install mini-swe-agent, um arquivo YAML, uma chave.

Escolha o Claude Code se o valor estiver nas interfaces e nas barreiras de proteção. A Anthropic o descreve como disponível "no seu terminal, IDE, aplicativo para desktop e navegador" e observa que "o CLI do Terminal, o VS Code e o JetBrains também oferecem suporte a provedores de terceiros" — portanto, uma rota por gateway existe apenas em alguns deles. Ele oferece modos de permissão, subagentes, servidores MCP, hooks e modo de planejamento; em uma assinatura Pro ou Max, seu uso consome a franquia do plano em vez de gerar uma cobrança por token. O custo é um tipo específico de dependência: você não pode tirá-lo dos modelos Claude, e a documentação de gateway da Anthropic afirma que ela "não oferece suporte ao roteamento do Claude Code para modelos que não sejam Claude por meio de nenhum gateway".

Mudar do Claude Code para o mini significa abrir mão do sistema de permissões em troca dos três modos do mini, abandonar completamente as interfaces de IDE e desktop e assumir sua própria contabilização de gastos — o orçamento por execução do mini só funciona quando o LiteLLM consegue precificar o ID do seu modelo. Mudar do mini para o Claude Code significa abrir mão da liberdade de escolha de modelos e passar de um harness que você pode ler para um binário empacotado: o repositório claude-code é um ponto de distribuição, e seu arquivo de licença é um aviso de uma linha — "© Anthropic PBC. Todos os direitos reservados" —, com uso sujeito aos Termos Comerciais de Serviço da Anthropic.

Os dois agentes lado a lado

Fontes consultadas em 19 de setembro de 2026: metadados do PyPI do mini, documento do registro npm do Claude Code, página de CLI do mini, o mini.yaml enviado pelo mini e a referência do CLI e a visão geral da Anthropic.

Por que "mini supera o Claude Code" não é um veredito

A página inicial do mini traz uma notícia com o texto "mini-swe-agent supera Claude Code e Codex no DeepSWE", e vale a pena ler o que o DeepSWE realmente mediu. Seu texto explicativo afirma: "Cada execução usa mini-swe-agent, o harness que os autores do SWE-bench construíram. Nós o mantemos fixo em todos os modelos para que a tabela de classificação reflita a capacidade do modelo, não o scaffolding ao redor dele." Portanto, a tabela de classificação é um ranking de modelos dentro do mini, não um ranking do mini em comparação com outros agentes.

A única comparação entre harnesses nesse trabalho é um piloto com "as mesmas 10 tarefas do SWE-Bench Pro", no qual o harness padronizado igualou ou superou os nativos com custo de tokens comparável — e cujos autores imediatamente alertam que "parte dessa diferença provavelmente se deve ao ajuste de prompt, não à capacidade". Dez tarefas em um punhado de modelos não constituem uma amostra capaz de classificar dois agentes, e nenhuma outra comparação direta confiável, em escala utilizável, foi encontrada durante a pesquisa desta página. Portanto, este guia não atribui pontuações a eles. Ele compara o que pode ser verificado: protocolo, permissões, controles de gastos e custo de migração.

A pergunta principal: quais endpoints cada um consegue alcançar

É aqui que os dois mais divergem, e é isso que determina se um gateway sequer é uma opção.

O Claude Code é limitado pelo protocolo. O guia de compatibilidade de gateway da Anthropic lista três formatos: Anthropic Messages selecionado por ANTHROPIC_BASE_URL e chamando /v1/messages mais um /v1/messages/count_tokens opcional; Amazon Bedrock InvokeModel; e rawPredict da Agent Platform do Google Cloud. Não há modo chat-completions. A URL base é uma origem, porque o Claude Code acrescenta a rota — a mesma regra que a própria página ANTHROPIC_BASE_URL do Kunavo codifica.

# 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

Três consequências que vale a pena considerar no orçamento. A variável de credencial determina o cabeçalho: a página de conexão da Anthropic afirma que "ANTHROPIC_AUTH_TOKEN em Authorization: Bearer, ANTHROPIC_API_KEY em x-api-key e apiKeyHelper em ambos", e que uma credencial na variável errada "chega ao gateway em um cabeçalho que ele não lê, e a solicitação falha com 401". O armazenamento em cache de prompts não tem pareamento beta e falha silenciosamente: o guia da Anthropic afirma que um gateway que remove cache_control produz "Nenhum erro: a conversa é cobrada como entrada não armazenada em cache em todos os turnos". E a descoberta de modelos fica desativada, a menos que você defina CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, após o que o Claude Code mantém apenas IDs que contenham "claude" ou "anthropic".

O mini é livre de protocolo, mas exige muita configuração. Não há nenhuma variável de ambiente de URL base; sua página de modelos locais explica que model_kwargs é repassado diretamente como litellm.completion(model=model_name, messages=messages, **model_kwargs). Mantenha o sufixo /v1 aqui — o oposto da regra do Claude Code acima. O próprio exemplo da mesma página define custom_llm_provider: "openai" em um nome de modelo sem prefixo, portanto o prefixo openai/ abaixo é uma precaução adicional, não uma exigência; o que a página exige é que, se você usar qualquer um dos dois, "isso também deve corresponder a litellm_provider na configuração".

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

Forneça a chave como OPENAI_API_KEY, no ambiente ou por meio de mini-extra config set, que grava o .env do mini; a página de configuração global do mini observa que "as variáveis de ambiente têm precedência sobre as variáveis definidas no arquivo .env". Selecione o arquivo com mini -c kunavo.yaml, ou torne-o o padrão com MSWEA_MINI_CONFIG_PATH.

Um modo de falha silencioso merece uma correção específica. O orçamento por execução do mini é aplicado pelo rastreamento de custos do LiteLLM, que precisa reconhecer o ID do modelo — e não foi verificado para esta página se os IDs do Kunavo têm preços cadastrados no registro do LiteLLM. Presuma que não tenham e forneça as tarifas você mesmo, em vez de recorrer a MSWEA_COST_TRACKING="ignore_errors", que remove a proteção em vez de corrigi-la. Configure LITELLM_MODEL_REGISTRY_PATH para apontar para um arquivo no formato de preços de modelos do LiteLLM. O exemplo prático do mini usa o nome do modelo sem o prefixo do provedor como chave da entrada e declara o provedor em litellm_provider, que é a estrutura reproduzida aqui:

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

Duas lacunas honestas. O Kunavo não testou em tempo de execução nenhum dos dois clientes contra seu endpoint, e publicar uma referência de configuração não é um teste de compatibilidade. Especificamente não verificado: se o caminho openai/ do LiteLLM negocia chamadas nativas de ferramentas — o padrão da v2 do mini — com o endpoint de chat-completions do Kunavo. Se não negociar, o mini ainda envia o caminho legado de análise de texto como model_class: litellm_textbased, com uma configuração mini_textbased.yaml ao lado da padrão. Mantenha uma rota funcional aberta enquanto experimenta qualquer um dos clientes e leia o que sua conta realmente registrou para uma tarefa limitada.

Quanto custa executar cada um

Os preços dos softwares não são comparáveis, porque apenas um deles tem preço.

O cartão de preços e o artigo de suporte descrevem os níveis Max de forma diferente — um os reúne em um único valor "a partir de", enquanto o outro nomeia ambos. Confirme o nível e o total no checkout antes de incluí-los no orçamento. Os preços por assento dos planos Team e Enterprise foram deixados de fora de propósito: são uma decisão de assentos para uma organização, não a escolha de um único desenvolvedor abordada nesta página.

Para uso cobrado por medição, a Anthropic publica uma faixa, não um valor por tarefa: "Em implantações empresariais, o custo médio é de cerca de $13 por desenvolvedor por dia ativo e $150-250 por desenvolvedor por mês, com custos abaixo de $30 por dia ativo para 90% dos usuários" (documentação de gerenciamento de custos). Isso é um agregado das próprias implantações da Anthropic, não uma medição de nenhum dos dois agentes em comparação com o outro, e não existe um valor equivalente para o mini.

Uma estimativa de tokens calculada

Isso é aritmética ilustrativa de tokens, não um custo de tarefa medido nem um teto de cobrança. Ambos os agentes reenviam a conversa a cada turno — a própria documentação da Anthropic afirma que "o Claude Code envia sua conversa completa em cada solicitação e, cada vez que o Claude usa ferramentas, envia outra solicitação contendo esse lote de resultados de ferramentas" —, portanto a entrada domina. Considere uma tarefa limitada totalizando 600k tokens de entrada não armazenados em cache ao longo de seus turnos e 25k tokens de saída. As tarifas são os preços atuais do catálogo do Kunavo por milhão de tokens.

Leia isso como uma proporção, não como uma previsão. Sob essas premissas, a diferença entre Claude Haiku 4.5 e Claude Opus 5 é de aproximadamente 5.0×, um fator mais importante do que a escolha do cliente. Observe também que a tarifa mais barata listada e o menor custo para concluir a tarefa são afirmações diferentes: um modelo mais barato que precise de três tentativas pode custar mais do que um que acerte na primeira, e o loop de subprocessos independentes do mini reenvia mais contexto quando uma etapa falha. O armazenamento em cache muda o cenário novamente, e não na direção presumida pela maioria dos textos. O Claude Code adiciona os marcadores cache_control por conta própria. O mini também define set_cache_control: "default_end" por conta própria, mas apenas para alguns nomes de modelos: seu código de seleção de modelos aplica esse padrão quando o nome de modelo resolvido contém anthropic, claude, sonnet ou opus, e a configuração ainda não definiu a chave. Portanto, um ID com nome Claude — incluindo o openai/claude-sonnet-5 prefixado acima — recebe marcadores sem que você os solicite; um ID com nome Gemini não recebe. Não foi testado nesta página se um endpoint de chat-completions atua sobre esses marcadores. Consulte armazenamento em cache de prompts.

O valor do catálogo do Kunavo é um piso de cobrança, não um teto: quando o upstream informa sua cobrança, a conta é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. As cobranças de cache e as ferramentas externas ficam fora deste exemplo. O complemento mínimo é $10 em crédito pré-pago — um mínimo de financiamento, não uma taxa por tarefa nem uma assinatura. Consulte detalhes de cobrança e observe que o valor exibido pelo próprio Claude Code em /usage é "calculado localmente a partir das contagens de tokens pelo preço de tabela" e é explicitamente "uma estimativa"; portanto, reconcilie-o com o registro do seu provedor, não com a leitura do cliente.

Mais uma distinção: SWE-agent não é mini-SWE-agent

O irmão mais antigo ainda aparece nas buscas por essas consultas e compartilha uma organização, uma família de READMEs e uma linhagem de benchmarks — mas tem sintaxe de configuração diferente, documentação diferente e não tem lugar em um tutorial do mini. Os próprios mantenedores seguiram em frente: o README do SWE-agent afirma que "a maior parte do nosso esforço atual de desenvolvimento está no mini-swe-agent, que substituiu o SWE-agent" e recomenda o mini daqui para frente (consultado em 19 de setembro de 2026). Ele não está arquivado e o projeto é licenciado sob a MIT; portanto, trate-o como mantido, mas substituído, e comece novos trabalhos no mini.

Configurando qualquer um dos dois

O Kunavo publica uma referência de configuração para o Claude Code, mas nenhuma para o mini-SWE-agent; nenhum dos dois clientes foi testado em tempo de execução aqui, e uma página de configuração publicada não é um teste de compatibilidade. Se o Claude Code for seu cliente, comece pelo guia de integração do Claude Code e crie uma conta no Kunavo quando estiver pronto para financiar uma chave. Se primeiro estiver comparando a assinatura com tokens cobrados por uso, preços do Claude Code e Claude Code sem assinatura abrangem essa decisão, enquanto a melhor API para Claude Code compara as rotas. Para o mini, o padrão é o genérico descrito em API compatível com OpenAI. Comparando outros agentes de terminal? OpenCode vs Claude Code e preços do Aider abrangem mais dois clientes com a mesma divisão entre um harness gratuito e uma cobrança de modelo por uso.

Perguntas frequentes

Consultado em 19 de setembro de 2026, buscando diretamente cada fonte: os metadados do PyPI do mini-SWE-agent, sua página inicial, o guia de migração da v2, a FAQ, o CLI, as páginas de configuração global e de modelos locais, seu mini.yaml, run/mini.py e models/__init__.py enviados no branch principal; o documento do registro npm do Claude Code, seu arquivo de licença do repositório e sua documentação de visão geral, gateway, protocolo de gateway, conexão de gateway, custos e referência do CLI; claude.com/pricing e o artigo de suporte do plano Max; o README do SWE-agent; e o texto explicativo do DeepSWE. Nenhum teste em tempo de execução de nenhum dos clientes contra o Kunavo foi realizado, e nenhum resultado de benchmark nesta página foi reproduzido. As tarifas de tokens do Kunavo vêm do catálogo atual, e todos os exemplos em dólares são aritmética ilustrativa de tokens.