오픈소스 멀티 에이전트 프레임워크 AutoSwarm 공개: Codex와 Claude Code를 하나로 묶다

AutoSwarm은 흩어져 있는 여러 AI 코딩 에이전트를 하나로 묶어 협업시키는 오픈소스 멀티 에이전트 프레임워크입니다. 평소 개발 작업을 할 때 분석, 코드 작성, 리뷰 등 단계마다 다른 AI 툴을 띄워두고 프롬프트를 일일이 복사해 나르던 비효율을 줄이기 위해 설계되었습니다.

Codex나 Claude Code 같은 독립 실행형 에이전트 상단에 위치하는 조율 시스템으로, 하나의 큰 작업을 주면 업무를 쪼개 적절한 도구에 병렬로 배분하고 단일 컨텍스트를 공유하며 진행합니다.

어떤 작업을 할 수 있나

AutoSwarm이 연동을 지원하는 대상은 매우 다양합니다. Codex, Claude Code를 비롯해 OpenCode, Cursor, GitHub Copilot CLI, Meta Muse Code, CodeBuddy, Hermes, Nanobot, DeepSeek Harness, Grok Build 등이 포함됩니다.

기존 멀티 에이전트 환경의 고질병은 맥락이 끊기거나 한쪽의 실수가 전체 작업 실패로 이어지는 점이었습니다. AutoSwarm은 공통 상태 저장소를 통해 메모리를 공유하고, 각 에이전트의 책임 범위와 검증 기준을 사전에 정의합니다. 한 에이전트가 내놓은 결과물을 후속 에이전트가 검토 및 통합하며, 피드백이나 병목이 생기면 다음 단계를 유연하게 수정합니다.

함께 공개된 논문에 따르면 긴 호흡의 프로그래밍 작업, 대화형 계획 수립, 전문 금융 분석 테스트에서 단일 에이전트 및 기존 멀티 에이전트 프레임워크를 뛰어넘는 성능을 보였습니다.

실행 방법과 준비물

전체 소스 코드는 GitHub(HKUDS/AutoSwarm)에 오픈소스로 공개되어 있으며 논문도 함께 열람할 수 있습니다. Windows, macOS, Linux를 모두 지원하며 데스크톱 앱, CLI, IDE 확장 프로그램, Skill 지원 에이전트 환경을 통해 구동할 수 있습니다.

환경 구성에는 Python 3.10 이상이 필요합니다. 깃허브 저장소를 복제한 뒤 uv 도구를 통해 패키지와 Skill을 설치하는 방식을 권장합니다. 메인 호스트 에이전트는 로컬 명령 실행 권한과 Skill 확장을 지원해야 하며, 함께 일할 협업 에이전트들은 로컬에 해당 CLI가 설치되어 있어야 합니다.

설치 후 자체 진단 명령어를 실행하면 실제 모델 호출을 통해 인증과 응답 상태를 미리 점검해 줍니다. 연동이 끝나면 평소 쓰던 터미널이나 에이전트 환경에서 명령어 한 줄로 다자간 협업을 시작할 수 있습니다.

왜 중요한가

AI 도구마다 장단점이 뚜렷해 여러 구독 서비스를 함께 쓰는 개발자가 많지만, 지금까지는 사람이 직접 양쪽 창을 오가며 맥락을 배달해야 했습니다. AutoSwarm은 특정 단일 플랫폼에 종속되지 않고 로컬에 설치된 툴들을 하나의 팀으로 엮어준다는 점에서 실용적입니다.

다만 여러 에이전트가 병렬로 작동하는 만큼 단시간 내 API 호출 비용과 토큰 소모가 급증할 수밖에 없습니다. 또한 작업 체인이 길어질수록 중간 단계에서 발생한 오류를 디버깅하기가 까다로워집니다. 자잘한 코드 수정보다는 구조가 크고 명확한 장기 프로젝트를 맡길 때 진가를 발휘할 도구입니다.