Curated AI Magazine

PICKLEE

AI Field Notes For Builders

Feature Article

Claw Code — Claude Code 소스 기반 Python/Rust 클린룸 재구현 프로젝트 (130k★)

📌 핵심 요약 Claude Code 소스 공개를 계기로 탄생한 클린룸 재구현 프로젝트. Python + Rust로 에이전트 하네스 아키텍처를 재구현했다. 출시 2시간 만에 50k 스타, 현재 130k 스타 / 102k 포크. Sigrid Jin이 발기인. 🔍 왜 주목해야 하나 130k 스타는 2026년 GitHub에서 가장 빠른 성장 속도 중 하나다. 이 프로젝트의 핵심 가치는 원본 소스 자체가 아니라, AI 코딩 에이전트의 내부 아키텍처—도구 오케스트레이션, 세션 상태 관리, MCP 통합, 플러그인 시스템—을 Rust로 재구현하면서 배울 수 있다는 점이다. 에이전트 하네스 엔지니어링을 공부하려는 개발자들에게 실질적인 레퍼런스 구현체가 된 셈이다. ⚡ 실무 시사점 AI 코딩 에이전트의 내부 구조를 이해하고 싶다면 Rust 크레이트 구조(특히 runtime, tools, commands)를 분석해볼 만하다. 다만 법적 리스크가 있을 수 있으니 상업적 사용 시 주의가 필요하다.

Meta

2026년 4월 2일

수정 2026년 4월 2일

원문 링크

배경 및 맥락

2026년 3월 31일, Claude Code의 소스 코드가 공개되면서 AI 코딩 에이전트 커뮤니티에 큰 파장이 일었다. 개발자 Sigrid Jin은 이 소식을 새벽 4시에 접하고, 법적 리스크를 피하기 위해 원본 소스를 직접 포함하지 않는 클린룸 재구현 방식으로 Python 포팅을 긴급히 완료한 뒤 공개했다.

결과는 폭발적이었다. 출시 2시간 만에 50k 스타를 돌파했고, 현재 130k 스타 / 102k 포크로 GitHub 역사상 가장 빠른 성장 속도를 보인 레포 중 하나다. 이 수치는 AI 코딩 에이전트의 내부 구조에 대한 개발자들의 어마어마한 관심을 보여준다.

프로젝트의 핵심 철학은 "Better Harness Tools, not merely storing the archive" — 유출된 아카이브를 저장하는 것이 아니라, 에이전트 하네스 아키텍처를 연구하고 더 나은 도구를 만드는 것이다.


핵심 내용

이중 언어 구조: Python + Rust

Python 워크스페이스 (src/) — 전체 비중 7.1%

  • port_manifest.py — 워크스페이스 구조 요약
  • models.py — 서브시스템 및 백로그 상태 정의
  • commands.py / tools.py — 명령어/도구 포트 메타데이터
  • query_engine.py — 포팅 요약 렌더링
  • task.py — 작업 관리

Rust 포트 (rust/) — 전체 비중 92.9%, 핵심 구현체

  • crates/api-client — 제공자 추상화, OAuth, 스트리밍 지원
  • crates/runtime — 세션 상태, MCP 오케스트레이션, 프롬프트 구성
  • crates/tools — 도구 매니페스트 및 실행 프레임워크
  • crates/commands — 슬래시 명령어, 스킬 발견
  • crates/plugins — 플러그인 시스템 및 훅 파이프라인
  • crates/claw-cli — 대화형 REPL, 마크다운 렌더링
  • crates/compat-harness — 상위 에디터 통합 레이어
  • crates/server — Axum 기반 HTTP/SSE 서버

핵심 기능

  • 에이전트 하네스 엔진: 도구 연결 및 오케스트레이션, 세션 상태 관리 및 압축, MCP 통합
  • 명령어/도구 시스템: 슬래시 명령어 지원, 스킬 발견 메커니즘, 도구 스펙 정의 및 실행
  • 플러그인 아키텍처: 훅 파이프라인 시스템, 번들 플러그인 포함, 확장성 있는 기능 추가
  • 다중 제공자 지원: API 클라이언트 추상화, OAuth 인증, 스트리밍 응답

포팅 상태

  • ✅ 아카이브 루트 엔트리 파일 미러링
  • ✅ 최상위 서브시스템 이름 매칭
  • ✅ 명령어/도구 인벤토리 미러링
  • ⚠️ 원본 TypeScript 시스템과 완전 동등성은 아직 미달성

경쟁 구도 / 비교

Claude Code (원본): TypeScript 기반, Anthropic이 공식 유지보수. 프로덕션 수준의 안정성과 지속적 업데이트. Claw Code는 이를 역설계한 것이 아니라 구조를 참고해 재구현한 것.

gstack: Garry Tan의 Claude Code 운영 레이어. 에이전트 위에 역할 기반 시스템을 얹는 방식. Claw Code는 에이전트 자체의 내부 구조를 탐구한다.

OpenClaw / Devin: 상용 AI 코딩 에이전트. Claw Code는 이들의 경쟁자가 아니라, 내부 작동 원리를 연구하는 교육적/연구적 목적의 프로젝트다.


의미

130k 스타라는 수치는 개발자들이 AI 코딩 에이전트의 내부를 이해하고 싶어한다는 강렬한 신호다. Claude Code가 어떻게 도구를 오케스트레이션하고, 세션을 관리하고, MCP를 통합하는지 Rust 코드로 직접 확인할 수 있다는 점에서 교육적 가치가 높다.

다만 법적 리스크는 염두에 둘 필요가 있다. 클린룸 재구현을 표방하지만, 원본 소스의 구조를 참조한 이상 완전히 독립적인 구현이라 보기 어렵고, Anthropic의 입장이 아직 명확하지 않다. 상업적 사용 시 주의가 필요하며, 학습 및 연구 목적으로 활용하는 것이 안전하다.

WSJ에서 Sigrid Jin을 "파워 유저"로 소개한 점, oh-my-codex/oh-my-opencode라는 개발 도구를 활용해 프로젝트를 진행한 점도 주목할 만하다.

Related

관련 글

Re-entry

최신 글 재진입