mini-SWE-agent와 Claude Code 비교: 워크플로, 모델, 총비용

mini-SWE-agent와 Claude Code는 같은 제품의 두 버전이 아닙니다. mini는 하나의 도구인 bash를 사용하고 LiteLLM을 통해 모든 모델에 도달하는 무료 MIT 라이선스 Python 에이전트이며, Claude Code는 Anthropic 형태의 프로토콜만 사용하는 Anthropic의 독점 에이전트입니다. 이 하나의 차이가 대부분의 마이그레이션을 결정합니다. 선호도의 문제가 아니라 프로토콜 경계의 문제이기 때문입니다. 읽어 볼 수 있을 만큼 작은 하네스와 자유로운 제공자 선택을 원한다면 mini를 선택하고, 편집기·데스크톱·CI 표면, 권한 모드 및 구독 경로를 원하며 Claude 모델을 계속 사용할 계획이라면 Claude Code를 선택하세요.

mini-SWE-agent는 SWE-agent GitHub 조직에서 유지 관리되며, 스스로를 "SWE-bench, SWE-agent 등을 만든 Princeton & Stanford 팀이 제작"했다고 설명합니다. 무엇보다 먼저 정정할 내용이 있습니다. 가장 많이 인용되는 사실이 오래되었기 때문입니다. v2 마이그레이션 가이드에는 "v2.0은 기본적으로 네이티브 도구 호출을 사용합니다(정규식 기반 텍스트 파싱 대신)"라고 나와 있지만, 프로젝트 자체 FAQ에는 여전히 "LM의 도구 호출 인터페이스조차 사용하지 않는다" 및 "작업은 triple-backtick 블록에서 파싱된다"고 되어 있습니다. 두 페이지 모두 2026년 9월 19일에 확인했습니다. 마이그레이션 가이드와 제공된 구성이 우선합니다. mini.yaml은 모델에 "명령을 실행하려면 모든 응답에서 'bash' 도구를 최소 한 번 사용해야 합니다"라고 알립니다. 도구 호출이 없다는 설명이나 제거된 MSWEA_MODEL_API_KEY 변수를 기반으로 한 튜토리얼은 v2 이전 자료입니다.

어느 것을 선택해야 할까요

작업이 배치 형태이거나 프로바이더 형태라면 mini-SWE-agent를 선택하세요: 동일한 프롬프트를 여러 이슈에 실행하거나, 모델을 서로 평가하거나, 감사할 수 있을 만큼 작은 에이전트가 확인할 수 없는 기능 집합보다 나은 샌드박스 안에서 작업하는 경우입니다. 결정적인 속성은 실행 모델입니다. mini의 FAQ는 작업이 subprocess.run을 통해 실행된다고 설명하며, "모든 작업은 완전히 독립적으로 실행됩니다(상태를 유지하는 셸 세션을 계속 실행하는 것과는 다름)"라고 명시합니다. 따라서 "에이전트는 디렉터리를 변경하거나 환경 변수를 내보낼 수 없지만, 환경 변수는 작업별로 설정할 수 있습니다." 제공되는 mini.yaml도 모델에 동일한 내용을 전달합니다. 즉, "디렉터리 또는 환경 변수 변경은 지속되지 않습니다. 모든 작업은 새 서브셸에서 실행됩니다." 그리고 대신 접두사가 붙은 명령을 사용하도록 안내합니다. 따라서 실행을 재현할 수 있고 컨테이너화도 매우 간단하지만, 상태를 유지하는 긴 셸 작업은 불편해집니다. 마이그레이션 비용은 오후 반나절 정도입니다: pip install mini-swe-agent, YAML 파일 하나, 키 하나입니다.

가치가 제공되는 표면과 보호 장치에 있다면 Claude Code를 선택하세요. Anthropic은 Claude Code가 "터미널, IDE, 데스크톱 앱, 브라우저에서" 사용할 수 있다고 설명하며, "터미널 CLI, VS Code, JetBrains는 서드파티 프로바이더도 지원한다"고 명시합니다. 따라서 게이트웨이 경로는 그중 일부에서만 존재합니다. 권한 모드, 서브에이전트, MCP 서버, 훅, 계획 모드를 제공하며, Pro 또는 Max 구독에서는 사용량이 토큰당 청구가 아니라 요금제 허용량에서 차감됩니다. 비용은 특정한 형태의 종속입니다. Claude 모델에서 벗어나 사용할 수 없으며, Anthropic의 게이트웨이 문서는 "어떤 게이트웨이를 통해서도 Claude Code를 비-Claude 모델로 라우팅하는 것을 지원하지 않는다"고 명시합니다.

Claude Code에서 mini로 전환하면 권한 시스템을 포기하는 대신 mini의 세 가지 모드를 사용하게 되고, IDE 및 데스크톱 표면을 완전히 포기하며, 자체 비용 집계를 맡아야 합니다. mini의 실행별 예산은 LiteLLM이 모델 ID의 가격을 산정할 수 있을 때만 작동합니다. mini에서 Claude Code로 전환하면 무료 모델 선택권을 포기하고, 읽을 수 있는 하니스에서 번들 바이너리로 이동하게 됩니다. claude-code 저장소는 배포 지점이며, 해당 라이선스 파일은 "© Anthropic PBC. All rights reserved"라는 한 줄의 고지와 함께 사용에 Anthropic의 Commercial Terms of Service가 적용된다고 명시합니다.

두 에이전트 나란히 비교

2026년 9월 19일 확인한 출처: mini의 PyPI 메타데이터, Claude Code의 npm 레지스트리 문서, mini의 CLI 페이지, mini에 제공되는 mini.yaml, Anthropic의 CLI 참조 및 개요.

"mini가 Claude Code보다 낫다"는 결론이 아닌 이유

mini의 홈페이지에는 "mini-swe-agent가 DeepSWE에서 Claude Code와 Codex를 능가한다"는 뉴스 문구가 있으며, DeepSWE가 실제로 무엇을 측정했는지 읽어볼 가치가 있습니다. 설명 문서에는 다음과 같이 적혀 있습니다. "모든 실행은 mini-swe-agent를 사용합니다. 이는 SWE-bench 작성자들이 구축한 하니스입니다. 모든 모델에서 이를 고정하므로 리더보드는 주변 스캐폴딩이 아니라 모델 역량을 반영합니다." 따라서 이 리더보드는 mini 내부 모델의 순위이지, 다른 에이전트와 비교한 mini의 순위가 아닙니다.

해당 작업에서 하니스 대 하니스 비교에 해당하는 유일한 비교는 "동일한 10개의 SWE-Bench Pro 작업"을 대상으로 한 파일럿이었습니다. 표준화된 하니스는 비슷한 토큰 비용에서 네이티브 하니스와 같거나 더 나은 결과를 냈지만, 저자들은 즉시 "그 격차의 일부는 역량이 아니라 프롬프트 튜닝 때문일 가능성이 높다"고 주의를 덧붙였습니다. 소수의 모델에 걸친 10개 작업은 두 에이전트의 순위를 매길 수 있는 표본이 아니며, 이 페이지를 조사하는 동안 사용할 수 있는 규모의 신뢰할 만한 일대일 비교도 찾지 못했습니다. 따라서 이 가이드는 두 에이전트에 점수를 부여하지 않습니다. 확인 가능한 항목인 프로토콜, 권한, 비용 제어 및 마이그레이션 비용을 비교합니다.

핵심 질문: 각 에이전트가 연결할 수 있는 엔드포인트는 무엇인가

두 에이전트가 가장 크게 갈라지는 부분이며, 게이트웨이가 애초에 선택 가능한지 결정하는 요소입니다.

Claude Code는 프로토콜에 종속됩니다. Anthropic의 게이트웨이 호환성 가이드는 세 가지 형식을 나열합니다. ANTHROPIC_BASE_URL로 선택하고 /v1/messages 및 선택적 /v1/messages/count_tokens를 호출하는 Anthropic Messages, Amazon Bedrock InvokeModel, Google Cloud Agent Platform rawPredict입니다. Chat Completions 모드는 없습니다. Claude Code가 경로를 추가하므로 기본 URL은 오리진이어야 합니다. 이는 Kunavo 자체의 ANTHROPIC_BASE_URL 페이지에도 같은 규칙으로 인코딩되어 있습니다.

# 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

예산에 반영할 만한 결과는 세 가지입니다. 자격 증명 변수에 따라 헤더가 결정됩니다. Anthropic의 연결 페이지는 "ANTHROPIC_AUTH_TOKEN는 Authorization: Bearer에서, ANTHROPIC_API_KEY는 x-api-key에서, 그리고 apiKeyHelper는 양쪽에서 사용된다"고 설명하며, 잘못된 변수에 자격 증명을 넣으면 "게이트웨이가 읽지 않는 헤더로 전달되어 요청이 401와 함께 실패한다"고 명시합니다. 프롬프트 캐싱은 베타 설정 조합이 없으면 조용히 실패합니다. Anthropic의 가이드에 따르면 게이트웨이가 cache_control를 제거하면 "오류는 발생하지 않지만 대화가 매 턴 캐시되지 않은 입력으로 청구됩니다." 또한 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1를 설정하지 않으면 모델 검색이 비활성화되며, 설정한 뒤에도 Claude Code는 "claude" 또는 "anthropic"을 포함하는 ID만 유지합니다.

mini는 프로토콜에는 자유롭지만 설정이 복잡합니다. 기본 URL 환경 변수는 전혀 없습니다. 로컬 모델 페이지는 model_kwargs가 litellm.completion(model=model_name, messages=messages, **model_kwargs)로 그대로 전달된다고 설명합니다. 여기서는 /v1 접미사를 유지하세요. 이는 위의 Claude Code 규칙과 반대입니다. 같은 페이지의 예시는 접두사가 없는 모델 이름에 custom_llm_provider: "openai"를 설정하므로, 아래의 openai/ 접두사는 필수라기보다 안전을 위한 것입니다. 페이지에서 실제로 요구하는 것은 둘 중 하나를 사용한다면 "이 값이 설정의 litellm_provider와도 일치해야 한다"는 점입니다.

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

키를 OPENAI_API_KEY로 제공하세요. 환경에 직접 설정하거나 mini-extra config set을 통해 설정할 수 있으며, 후자는 mini의 .env를 기록합니다. mini의 전역 설정 페이지는 "환경 변수는 .env 파일에 설정된 변수보다 우선한다"고 설명합니다. mini -c kunavo.yaml로 파일을 선택하거나 MSWEA_MINI_CONFIG_PATH를 사용해 기본 파일로 지정하세요.

별도로 해결해야 할 조용한 실패 모드가 하나 있습니다. mini의 실행별 예산은 LiteLLM의 비용 추적을 통해 적용되며, 이를 위해서는 모델 ID를 인식해야 합니다. 이 페이지에서는 Kunavo의 ID가 LiteLLM 레지스트리에 가격으로 등록되어 있는지 확인하지 않았습니다. 등록되어 있지 않다고 가정하고 직접 요금을 제공하세요. 보호 장치를 복구하는 대신 제거하는 MSWEA_COST_TRACKING="ignore_errors"를 사용하지 마세요. LITELLM_MODEL_REGISTRY_PATH가 LiteLLM 모델 가격 형식의 파일을 가리키도록 하세요. mini의 예시는 프로바이더 접두사가 없는 모델 이름으로 항목의 키를 지정하고 litellm_provider에서 프로바이더를 선언합니다. 여기에도 그 형식을 사용했습니다.

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

두 가지 솔직한 공백이 있습니다. Kunavo는 어느 클라이언트도 해당 엔드포인트에서 런타임 테스트하지 않았으며, 설정 참고 문서를 공개하는 것은 호환성 테스트가 아닙니다. 구체적으로 확인되지 않은 점은 LiteLLM의 openai/ 경로가 Kunavo의 Chat Completions 엔드포인트에서 네이티브 도구 호출(mini v2의 기본값)을 협상하는지 여부입니다. 지원하지 않더라도 mini는 레거시 텍스트 파싱 경로를 model_class: litellm_textbased로 제공하며, 기본 설정 옆에 mini_textbased.yaml 설정도 함께 제공합니다. 어느 클라이언트를 사용하든 시도하는 동안 작동하는 경로를 열어 두고, 제한된 작업에 대해 계정에 실제로 기록된 내용을 확인하세요.

각 에이전트를 실행하는 비용

둘 중 가격이 있는 것은 하나뿐이므로 소프트웨어 가격은 서로 비교할 수 없습니다.

가격 카드와 지원 문서는 Max 등급을 서로 다르게 설명합니다. 하나는 단일 "~부터" 금액으로 묶고, 다른 하나는 두 등급을 모두 명시합니다. 예산을 책정하기 전에 결제 과정에서 등급과 총액을 확인하세요. Team 및 Enterprise 좌석 가격은 여기서 의도적으로 제외했습니다. 이 페이지가 다루는 단일 개발자 선택이 아니라 조직의 좌석 결정이기 때문입니다.

종량제 사용에 대해 Anthropic은 작업별 금액이 아니라 다음과 같은 범위를 공개합니다. "엔터프라이즈 배포 전반에서 평균 비용은 개발자 한 명당 활동일 하루에 약 $13, 개발자 한 명당 월 $150~250이며, 사용자의 90%는 활동일 하루당 비용이 $30 미만입니다"(비용 관리 문서). 이는 Anthropic 자체 배포를 집계한 수치이지, 두 에이전트를 서로 비교해 측정한 수치가 아니며 mini에 해당하는 동등한 수치는 없습니다.

토큰 추정 예시

이는 측정된 작업 비용이나 청구 상한이 아닌, 예시를 위한 토큰 산술입니다. 두 에이전트는 매 턴 대화를 다시 전송합니다. Anthropic 자체 문서도 "Claude Code는 모든 요청에 전체 대화를 보내며, Claude가 도구를 사용할 때마다 해당 도구 결과 묶음을 담은 요청을 다시 보낸다"고 설명합니다. 따라서 입력이 비용을 지배합니다. 턴 전체에서 합계 600k의 캐시되지 않은 입력 토큰과 25k의 출력 토큰을 사용하는 제한된 작업 하나를 가정하세요. 요금은 백만 토큰당 최신 Kunavo 카탈로그 가격입니다.

예측이 아니라 비율로 읽으세요. 이러한 가정에서 Claude Haiku 4.5와 Claude Opus 5의 차이는 약 5.0배이며, 이는 클라이언트 선택보다 더 큰 영향 요인입니다. 또한 가장 저렴한 등록 요금과 작업을 완료하는 데 드는 최저 비용은 서로 다른 주장입니다. 세 번의 시도가 필요한 저렴한 모델은 첫 시도에 성공하는 모델보다 비용이 더 클 수 있으며, mini의 독립 서브프로세스 루프는 단계가 실패할 때 더 많은 컨텍스트를 다시 전송합니다. 캐싱은 그림을 다시 바꾸며, 대부분의 설명에서 가정하는 방향과는 다를 수 있습니다. Claude Code는 자체적으로 cache_control 마커를 추가합니다. mini도 자체적으로 set_cache_control: "default_end"를 설정하지만 일부 모델 이름에만 적용합니다. 해당 모델 선택 코드는 확인된 모델 이름에 anthropic, claude, sonnet 또는 opus가 포함되고 설정에서 이미 키를 지정하지 않은 경우 이 기본값을 적용합니다. 따라서 위의 접두사가 붙은 openai/claude-sonnet-5를 포함해 Claude 이름이 들어간 ID는 요청하지 않아도 마커를 받지만, Gemini 이름이 들어간 ID는 받지 않습니다. Chat Completions 엔드포인트가 이 마커에 따라 동작하는지는 이 페이지에서 테스트하지 않았습니다. 프롬프트 캐싱을 참조하세요.

Kunavo의 카탈로그 금액은 상한이 아니라 청구 하한입니다. 업스트림이 요금을 보고하면 청구액은 카탈로그 비용과 업스트림 비용에 해당 마크업을 곱한 값 중 더 큰 금액이 됩니다. 캐시 요금과 외부 도구는 이 예시에 포함되지 않습니다. 최소 충전액은 선불 크레딧 $10입니다. 이는 자금 충전 최소액이지 작업 요금이나 구독료가 아닙니다. 청구 세부 정보를 참조하세요. 또한 Claude Code 자체의 /usage 금액은 "목록 가격의 토큰 수를 기반으로 로컬에서 계산"되며 명시적으로 "추정치"이므로, 클라이언트 표시값이 아니라 프로바이더 원장을 기준으로 조정하세요.

한 가지 더 구분할 점: SWE-agent는 mini-SWE-agent가 아닙니다

이전 세대 프로젝트는 여전히 이러한 검색어의 검색 결과에 나타나고 조직, README 계열 및 벤치마크 계보를 공유하지만, 설정 구문과 문서가 다르며 mini 튜토리얼에서 다룰 대상은 아닙니다. 해당 프로젝트의 유지 관리자들도 방향을 바꾸었습니다. SWE-agent README는 "현재 개발 노력의 대부분은 SWE-agent를 대체한 mini-swe-agent에 집중되어 있다"고 밝히며 앞으로는 mini를 사용할 것을 권장합니다(2026년 9월 19일 확인). 아카이브되지는 않았고 프로젝트는 MIT 라이선스이므로, 죽은 프로젝트가 아니라 유지되지만 대체된 프로젝트로 보세요. 새 작업은 mini에서 시작하세요.

둘 중 하나 설정하기

Kunavo는 Claude Code용 설정 참고 문서를 제공하지만 mini-SWE-agent용 문서는 제공하지 않습니다. 어느 클라이언트도 여기서 런타임 테스트하지 않았으며, 설정 페이지를 공개하는 것은 호환성 테스트가 아닙니다. Claude Code를 클라이언트로 사용한다면 Claude Code 통합 가이드에서 시작하고, 키에 자금을 충전할 준비가 되면 Kunavo 계정을 만드세요. 먼저 구독과 종량제 토큰을 비교하려면 Claude Code 가격 및 구독 없이 Claude Code 사용하기에서 해당 결정을 다루며, Claude Code에 가장 적합한 API에서는 경로를 비교합니다. mini의 경우 OpenAI 호환 API에 설명된 일반적인 패턴을 사용하세요. 다른 터미널 에이전트를 비교하시나요? OpenCode와 Claude Code 비교 및 Aider 가격에서는 무료 하니스와 종량제 모델 청구가 같은 방식으로 나뉘는 두 가지 클라이언트를 더 다룹니다.

자주 묻는 질문

2026년 9월 19일 각 출처를 직접 가져와 확인했습니다. mini-SWE-agent의 PyPI 메타데이터, 홈페이지, v2 마이그레이션 가이드, FAQ, CLI, 전역 설정 및 로컬 모델 페이지, 메인 브랜치의 제공 파일 mini.yaml, run/mini.py, models/__init__.py; Claude Code의 npm 레지스트리 문서, 저장소 라이선스 파일, 개요, 게이트웨이, 게이트웨이 프로토콜, 게이트웨이 연결, 비용 및 CLI 참조 문서; claude.com/pricing 및 Max 요금제 지원 문서; SWE-agent README; DeepSWE 설명 문서입니다. 두 클라이언트를 Kunavo에서 런타임 테스트하지 않았고, 이 페이지의 벤치마크 결과도 재현하지 않았습니다. Kunavo 토큰 요금은 최신 카탈로그에서 가져왔으며, 모든 달러 예시는 예시용 토큰 산술입니다.