도구별 실전 가이드 · 공식 정보 확인 2026-08-20
mini-swe-agent 사용법: 무료로 시작하는 가장 현실적인 방법
간결한 명령줄 하네스에서 저장소를 조사하고 이슈 해결 패치를 만드는 작은 코드로 구성된 GitHub 이슈 해결 CLI 에이전트입니다. mini-swe-agent의 첫 실전 과제는 “재현 테스트가 있는 사소한 파서 버그를 수정하고 패치 검토하기”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.
이럴 때 맞습니다
- “저장소 체크아웃과 실패 명령·기대 동작이 적힌 GitHub 이슈” 같은 입력으로 mini-swe-agent의 핵심 기능을 시험하려는 사람
- 재현 테스트와 기존 테스트가 모두 통과하고 패치가 원인 파일에만 한정되는지 기준으로 mini-swe-agent 결과를 직접 검수할 수 있는 경우
- CLI 환경에서 MIT 코드를 직접 설치·관리하려는 작업
이럴 때는 멈추세요
- 작은 코드로 구성된 GitHub 이슈 해결 CLI 에이전트 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
- 다음 위험을 사람이 확인할 수 없는 작업: 단순한 하네스에 샌드박스가 있다고 가정해 모델이 제안한 셸 명령을 무감독 실행하는 위험.
처음 해볼 작업 3가지
GitHub 이슈를 단일 재현으로 바꾼다
파서 버그를 보여 주는 실패 명령과 기대 동작이 명확해진다.
100줄 하네스로 원인 패치를 만든다
파서 원인에 한정된 작은 diff가 생긴다.
SWE 점수 대신 저장소 증거를 확인한다
재현·기존 테스트와 최소 diff가 모두 검증된다.
무료 조건과 주의점
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도
MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.
단순한 하네스에 샌드박스가 있다고 가정해 모델이 제안한 셸 명령을 무감독 실행하는 위험.
직접 대안과 비교
- jcode — 터미널 TUI에서 GitHub 이슈와 실패 테스트를 받아 코드베이스를 탐색·수정하므로 같은 사소한 파서 버그의 최소 패치를 만들 수 있다.