AutoCoder: Claude Agent SDK 기반의 자율 코딩 에이전트 도구

읽을거리&정보공유
, , , , , , , ,
1

AutoCoder: Claude Agent SDK 기반의 자율 코딩 에이전트 도구
AutoCoder: Claude Agent SDK 기반의 자율 코딩 에이전트 도구975×269 7.84 KB

AutoCoder 소개

AutoCoder는 Claude Agent SDK를 기반으로 작동하는 장기 실행(Long-running) 자율 코딩 에이전트입니다. 단순히 코드를 생성하는 것을 넘어, 초기화 에이전트와 코딩 에이전트와 같은 두 개의 전문화된 에이전트가 협력하여 전체 애플리케이션을 여러 세션에 걸쳐 구축하도록 설계되었습니다. 사용자가 애플리케이션 사양(Spec)을 정의하면, 에이전트가 이를 기능(Feature) 단위로 세분화하여 데이터베이스에 저장하고, 하나씩 구현하며 테스트까지 진행합니다.

최근 AI 코딩 도구들은 단순한 코드 자동 완성을 넘어, 프로젝트 전체를 관리하는 '에이전트(Agent)' 형태로 진화하고 있습니다. 특히 Anthropic의 Claude는 긴 컨텍스트 처리 능력과 뛰어난 코딩 성능으로 주목받고 있는데, AutoCoder는 이러한 Claude의 능력을 Claude Agent SDK와 결합하여 실제 개발 워크플로우(설계 -> 구현 -> 테스트 -> 관리)에 적용한 사례입니다. 2026년 현재, 이 프로젝트는 개발자가 감독자(Supervisor) 역할을 하고 AI가 실무를 담당하는 미래형 개발 환경을 보여줍니다.

AutoCoder 프로젝트는 기존 LLM 코딩의 한계인 '컨텍스트 손실'과 '단발성 코드 생성' 문제를 해결하고자 합니다. SQLite 데이터베이스를 통해 프로젝트의 진행 상황과 기능 목록을 체계적으로 관리하므로, 세션이 끊겨도 작업 내용을 잃지 않고 다음 세션에서 작업을 이어서 수행할 수 있습니다. 또한, React 기반의 웹 UI(Kanban 보드)를 제공하여 에이전트의 작업 진행 상황을 실시간으로 시각화하고 제어할 수 있는 것이 특징입니다.

일반적인 LLM 또는 코딩 에이전트를 사용한 코딩과 AutoCoder의 가장 큰 차이점은 상태 관리(State Persistence) 및 작업의 연속성입니다. 일반적인 LLM 및 코딩 에이전트를 사용한 코딩은 대화가 길어지면 앞부분의 컨텍스트를 잊거나, 프로젝트의 전체 구조를 놓치는 경우가 많습니다. 사용자가 매번 파일을 복사해서 붙여넣거나 상황을 다시 설명해야 합니다.

이에 비해, AutoCoder는 SQLite를 이용해 구현해야 할 기능(Feature) 목록과 각 기능의 테스트 통과 여부를 영구적으로 저장합니다. 에이전트는 이 '할 일 목록'을 보며 순차적으로 작업을 수행하며, Git을 초기화하여 코드 변경 사항을 자동으로 커밋합니다. 즉, 개발자가 자리를 비워도 에이전트가 스스로 "다음 할 일"을 찾아 작업을 계속합니다.

AutoCoder의 주요 특징

AutoCoder는 복잡한 애플리케이션 구축을 위해 체계적인 아키텍처와 보안 모델을 갖추고 있습니다.

2-Agent 패턴 (Two-Agent Pattern)

AutoCoder는 서로 다른 역할을 분담하는 초기화 에이전트 (Initializer Agent) 및 코딩 에이전트 (Coding Agent)를 통해 작업의 정확도를 높입니다. 각 에이전트들은 다음과 같습니다:

초기화 에이전트 (Initializer Agent) 는 프로젝트의 첫 세션을 담당합니다. 사용자가 요청한 구현 사양(Spec)을 분석하여 프로젝트 구조를 잡고, 구현해야 할 모든 기능을 세부적으로 정의하여 features.db (SQLite 데이터베이스)에 저장합니다. 또한 Git 저장소를 초기화합니다.

코딩 에이전트 (Coding Agent) 는 초기화 에이전트를 이어 두 번째 세션부터 투입됩니다. 데이터베이스에서 우선순위가 높은 '대기 중(Pending)' 기능을 하나 가져와 구현합니다. 구현 후에는 해당 기능이 정상 작동하는지 테스트하고, 성공하면 데이터베이스에 '완료(Passing)'로 표시합니다.

기능 관리 및 UI (Feature Management & UI)

AutoCoder에서는 프로젝트 진행 상황을 터미널뿐만 아니라 직관적인 Web UI를 통해서도 확인할 수 있습니다.

  • Kanban 보드: 현재 어떤 기능이 구현 중인지, 어떤 기능이 완료되었는지 시각적으로 보여줍니다.

  • 실시간 스트리밍: 에이전트의 생각 과정과 터미널 출력(테스트 결과 등)이 웹소켓을 통해 UI에 실시간으로 중계됩니다.

  • MCP 서버 활용: 기능 관리(Feature Management)는 MCP(Model Context Protocol) 서버를 통해 이루어지며, 에이전트는 feature_get_next, feature_mark_passing 같은 도구를 호출하여 스스로 작업을 관리합니다.

보안 모델 (Security Model)

자율 에이전트가 내 컴퓨터에서 쉘 명령어를 실행하는 것은 위험할 수 있습니다. AutoCoder는 Defense-in-depth(심층 방어) 접근 방식을 취합니다.

  • 허용 목록 (Allowlist): 에이전트는 사전에 정의된 안전한 명령어(ls, cat, grep, npm, git 등)만 실행할 수 있습니다. security.py에 정의되지 않은 명령어는 즉시 차단됩니다.

  • 파일 시스템 제한: 프로젝트 디렉터리 외부의 파일에 접근하거나 조작하는 것이 제한됩니다.

AutoCoder 설치 및 사용법

AutoCoder를 사용하기 위해서는 먼저 Claude Code CLI 설치와 인증이 필요합니다. 따라서, Claude Code CLI 설치 및 Claude 구독(또는 API 키)가 필요합니다. Claude Code CLI 설치는 curl -fsSL https://claude.ai/install.sh | bash를 통해 가능하며, 상세한 내용은 Claude Code 공식 문서를 참고해주세요.

Claude Code가 준비되었다면, AutoCoder GitHub 저장소를 복제(clone) 후 실행하면 됩니다:

# AutoCoder GitHub 저장소 복제(clone)
git clone https://github.com/leonvanzyl/autocoder
cd autocoder

# macOS / Linux에서 실행 시
./start_ui.sh

# Windows에서 실행 시
start_ui.bat

실행 후 http://localhost:5173에 접속하여 새 프로젝트를 생성할 수 있습니다. /create-spec 명령어를 사용하면 Claude와 대화하며 앱 사양서를 작성할 수 있습니다.

라이선스

AutoCoder 프로젝트는 GNU Affero General Public License v3.0 (AGPL-3.0)으로 배포되고 있습니다. AGPL-3.0 라이선스는 코드 수정 및 재배포 시 제약이 따를 수 있으므로 라이선스 원문을 반드시 읽어주시기 바랍니다.

:github: AutoCoder 프로젝트 GitHub 저장소



이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. :hugs:

:pytorch:파이토치 한국 사용자 모임:south_korea:이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일:love_letter:로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

:wrapped_gift: 아래:down_right_arrow:쪽에 좋아요:+1:를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ :star_struck:

1개의 좋아요