Claw Code Online — 곧 출시!

오픈소스 · Python + Rust

Claw Code 프로젝트

Claw Code는 오픈소스 AI 코딩 에이전트 프레임워크입니다. Claude Code 에이전트 하네스 아키텍처를 Python과 Rust로 처음부터 클린룸 재구현했습니다. 독점 코드 없음. 모델 가중치 없음. 오직 아키텍처의 재설계.

View on GitHub 아키텍처 탐색
48k+
GitHub 스타
56k+
포크
335
워쳐
512k
분석된 코드 줄 수
🏗 Architecture 🔧 19 Tools 15개 명령어 Rust Core 🧠 쿼리 엔진 💾 세션 🔒 Permissions 🔌 MCP 🌐 API Client 비교 📅 타임라인 🚀 시작하기

탄생 배경: Claw Code의 시작

2026년 3월 31일, 보안 연구원 Chaofan Shou (@shoucccc)는 Anthropic의 주력 AI 코딩 CLI 도구인 Claude Code의 전체 소스 코드가 npm 공개 레지스트리에 실수로 게시된 것을 발견했습니다. @anthropic-ai/claude-code v2.1.88 패키지에 포함된 59.8MB JavaScript 소스 맵 파일(.map)을 통해 유출되었습니다. 해당 파일에는 1,906개 소스 파일에 걸쳐 약 512,000줄의 TypeScript가 포함되어 있어, 에이전트 하네스의 전체 내부 아키텍처가 드러났습니다.

유출이 공개된 지 몇 시간 만에, 개발자 Sigrid Jin (@sigridjineth)이 핵심 에이전트 하네스 아키텍처의 클린룸 재구현을 시작했습니다. Jin은 이전에 Wall Street Journal에서 지난 1년간 250억 개 이상의 Claude Code 토큰을 사용한 세계에서 가장 활발한 Claude Code 파워 유저 중 한 명으로 소개된 바 있습니다. 이 프로젝트는 Python을 사용하여 처음부터 완전히 새로 구축되었으며, oh-my-codex (OmX)를 통해 병렬 코드 리뷰와 지속적 검증으로 오케스트레이션되었습니다. 독점 소스 코드는 일절 복사되지 않았습니다. 그 결과가 바로 Claw Code입니다.

Claw Code 저장소는 GitHub 역사상 가장 빠르게 30,000 스타에 도달한 프로젝트 중 하나가 되었으며, 최초 공개 후 몇 시간 만에 이 이정표를 달성했습니다. 최신 데이터 기준으로, 프로젝트는 48,000개 이상의 스타와 56,000개 이상의 포크를 축적했으며, 335명의 활성 워쳐와 2,100개 이상의 오픈 커뮤니티 이슈를 보유하고 있습니다.

아키텍처 개요

Claw Code는 Claude Code 에이전트 하네스에서 관찰된 핵심 아키텍처 패턴을 재구현합니다. 코드베이스는 명확한 모듈 구조로 구성되어 있으며, Rust가 72.9%(고성능 런타임 실행용), Python이 27.1%(에이전트 오케스트레이션 및 LLM 연동용)를 차지합니다. 활성 Rust 마이그레이션 브랜치(dev/rust)는 완전한 메모리 안전 고성능 하네스 런타임을 목표로 합니다.

claw-code/
├── src/                          # Python workspace
│   ├── commands.py               # CLI command registry & dispatch
│   ├── tools.py                  # Plugin-based tool system (~40 tools)
│   ├── models.py                 # LLM provider abstraction layer
│   ├── query_engine.py           # Core query engine (LLM calls, streaming, caching)
│   ├── task.py                   # Task management & agent lifecycle
│   └── main.py                   # Entry point
├── rust/                         # Rust core (performance-critical paths)
│   └── ...                       # In-progress high-performance runtime
└── tests/                        # Verification & integration tests

핵심 아키텍처 구성 요소

Claude Code 소스 유출로 드러나고 Claw Code에 의해 독립적으로 재구현된 아키텍처에는 AI 코딩 에이전트 분야의 최신 기술을 정의하는 여러 중요한 하위 시스템이 포함됩니다:

도구 시스템

플러그인 기반 아키텍처로 19개의 내장 권한 제어 도구를 제공합니다. 파일 읽기, Bash 실행, 웹 스크래핑, LSP 연동, Git 작업 등 각 기능은 세분화된 권한 제어를 갖춘 독립적인 도구로 구현됩니다. Rust 레이어는 모든 도구에 대한 완전한 JSON 스키마 정의를 제공합니다. 전체 도구 레퍼런스 보기 →

쿼리 엔진

쿼리 엔진은 시스템의 핵심 지능으로, 모든 LLM API 호출, 응답 스트리밍, 캐싱 전략, 다단계 오케스트레이션을 관리합니다. Claw Code는 프로바이더 비종속적 설계, 설정 가능한 턴 제한, 예산 제어에 초점을 맞춰 이 엔진을 재구현합니다. 쿼리 엔진 탐색하기 →

멀티 에이전트 오케스트레이션

프레임워크는 내부적으로 "스웜"이라 불리는 하위 에이전트 생성을 지원하여 복잡한 작업을 병렬화합니다. 이를 통해 시스템은 대규모 엔지니어링 과제를 독립적으로 실행 가능한 하위 작업으로 분해할 수 있으며, 각 작업은 공유 메모리 접근이 가능한 격리된 컨텍스트에서 실행됩니다. Agent 도구는 하위 에이전트 생명주기에 대한 완전한 제어를 제공합니다.

MCP 통합

Stdio, SSE, HTTP, WebSocket, SDK, ClaudeAiProxy 등 6가지 전송 유형을 지원하는 완전한 Model Context Protocol (MCP) 지원. 자동 이름 정규화, 설정 해싱, OAuth 인증을 통해 Claw Code 에이전트를 외부 도구 서버에 연결합니다. MCP 연동에 대해 알아보기 →

핵심 기능

Claw Code는 프로덕션급 AI 코딩 에이전트의 아키텍처를 오픈소스 기반으로 제공합니다.

소스 유출로 드러난 패턴

Claude Code 소스 코드 유출은 이전에 문서화되지 않은 여러 내부 하위 시스템을 드러냈습니다. Claw Code는 독점 구현을 복제하지 않지만, 이러한 패턴은 프로젝트의 아키텍처 로드맵에 반영되며 AI 코딩 에이전트 분야에서 중요한 혁신을 나타냅니다:

KAIROS 모드

지속적으로 실행되는 능동적 어시스턴트 모드입니다. 사용자 입력을 기다리지 않고, KAIROS는 개발 환경을 능동적으로 관찰하며 자율적으로 행동합니다. 원본 구현에서는 외부 빌드에 완전히 숨겨진 독립적인 추가 전용 로그 시스템으로 지원됩니다.

ULTRAPLAN 모드

복잡한 계획 작업을 더 강력한 모델(Opus급)을 실행하는 원격 클라우드 컨테이너로 오프로드하는 아키텍처 패턴입니다. 시스템은 최대 30분의 전용 추론 시간을 할당하며, 인간 감독을 위한 브라우저 기반 승인 워크플로를 제공합니다.

autoDream 서비스

포크된 하위 에이전트 프로세스로 실행되는 백그라운드 메모리 통합 엔진입니다. 시스템의 "꿈꾸기" 메커니즘으로 종종 묘사되는 autoDream은 유휴 시간 분석을 수행합니다 — 학습된 패턴을 재구성하고, 오래된 컨텍스트를 정리하며, 사용자 상호작용 없이 관련 메모리 연관성을 강화합니다.

피처 플래그

유출은 44개의 컴파일된 피처 플래그를 드러냈으며, 이 중 20개는 외부 사용자에게 비활성화된 상태로 남아 있습니다. 이는 예비로 보유된 완전히 구축된 기능을 나타내며, Anthropic의 내부 기능 파이프라인이 공개 릴리스보다 상당히 앞서 있음을 시사합니다.

Claw Code의 위상

Claude Code 소스 유출은 관련 프로젝트 생태계를 촉발했습니다. 아래는 공개 데이터를 기반으로 한 주요 저장소와 특성의 사실적 비교입니다:

프로젝트 언어 유형 소스 포함 여부 스타 포크
anthropics/claude-code TypeScript Anthropic 공식 CLI 에이전트 공식 릴리스 89.4k 10.5k
instructkr/claw-code Python, Rust 클린룸 재구현 아니오 — 독립 구현 48k+ 56k+
0xKarl-dev/claw-codes Python, Rust 독립 에이전트 프레임워크 아니오 — 독립 구현 128 159
ghuntley/deobfuscation TypeScript 클린룸 역공학 NPM 패키지에서 파생 916 509
injekt/claude-code-reverse Docs (MD/HTML) 아키텍처 분석 아니오 — 문서만 36 3
ThreeFish-AI/analysis Docs 역공학 연구 아니오 — 문서만 269 104

Claw Code vs. Claude Code

항목 Claude Code (Anthropic) Claw Code (오픈소스)
Type 공식 독점 CLI 에이전트 오픈소스 클린룸 재구현
Language TypeScript Python + Rust
Access 터미널, VS Code, 웹 (Claude 구독 필요) 터미널 (다중 LLM 프로바이더 지원)
Cost Claude Pro/Max 또는 Enterprise 필요 무료 오픈소스
아키텍처 소스 맵이 포함된 모놀리식 TS 번들 모듈형 Python + Rust 코어
도구 시스템 ~40개 내장 도구, 29,000줄 플러그인 기반 확장 가능 아키텍처
LLM Support Claude 모델만 지원 프로바이더 비종속적 (Claude, OpenAI, 로컬 모델)

Claw Code 시작하기

Claw Code는 GitHub에서 이용 가능합니다. 저장소를 클론하고 설정 안내를 따라 프레임워크를 사용해 보세요:

# Clone the repository
git clone https://github.com/instructkr/claw-code.git
cd claw-code

# Install dependencies (Python)
pip install -r requirements.txt

# Run the agent
python src/main.py

최신 설치 안내, 빌드 설정, 기여 가이드라인은 공식 저장소 README를 참조하세요.

관련 생태계

Claude Code 소스 유출은 더 넓은 프로젝트와 도구 생태계를 촉발했습니다:

미러

Kuberwastaken/claude-code

유출된 소스 코드의 최초 GitHub 미러로, 독립적인 Rust 재구현 작업과 결합되었습니다.

아카이브

Ringmast4r/claw-cli-source

역사적 참고 및 학술 연구를 위한 Claude Code v2.1.88 소스의 스냅샷 아카이브입니다.

도구

raullenchai/claw

영구 터미널 접근을 위해 tmux 기반으로 구축된 Claude Code 세션용 모바일 원격 제어 인터페이스입니다.

GUI

jamesrochabrun/Claw

터미널 인터페이스의 그래픽 대안을 제공하는 Claude Code용 네이티브 macOS 데스크톱 GUI 클라이언트입니다.

실험

GreenSheep01201/claw-empire

조직적 작업 오케스트레이션을 위해 Claude Code 스타일의 에이전트를 사용하는 멀티 에이전트 가상 회사 시뮬레이터입니다.

프레임워크

0xKarl-dev/claw-codes

Python/Rust 하이브리드 에이전트 런타임을 구현하는 AI 에이전트 구축용 실험적 프레임워크입니다.

보안 권고

커뮤니티는 Claude Code 소스 유출 사건과 함께 발생한 공급망 공격에 대해 인지해야 합니다:

공급망 공격 경고 — 2026년 3월 31일

2026년 3월 31일 UTC 00:21~03:29 시간대에 npm을 통해 Claude Code를 설치하거나 업데이트한 사용자는 원격 접근 트로이 목마(RAT)가 포함된 악성 axios 패키지(버전 1.14.1 또는 0.30.4)를 받았을 수 있습니다. 감염된 설치에는 plain-crypto-js에 대한 무단 의존성이 포함되어 있었습니다. package-lock.json, yarn.lock 또는 bun.lockb에 해당 버전이 참조되어 있다면, 호스트를 완전히 침해된 것으로 간주하세요: 모든 자격 증명을 교체하고, 접근 로그를 감사하며, 클린 시스템 재설치를 수행하세요. Anthropic은 이후 권장 설치 방법을 네이티브 설치 프로그램(curl -fsSL https://claude.ai/install.sh | bash)으로 마이그레이션하고, npm 배포 채널을 폐기했습니다.

Claw Code 심층 탐색

아키텍처와 도구에서 보안과 배포까지, Claw Code 프레임워크의 모든 측면을 심층적으로 탐색하세요.

아키텍처
시스템 아키텍처 심층 분석
Python + Rust 이중 레이어 설계, 60개 이상의 모듈, 6개 Rust 크레이트, 완전한 부트스트랩 시퀀스.
도구
19개 내장 에이전트 도구
bash, 파일 작업, grep, 웹 페치, Agent 생성, REPL 등 13개 이상의 도구에 대한 완전한 레퍼런스.
명령어
15개 슬래시 명령어
세션 제어, 모델 전환, 비용 추적, 압축, 내보내기를 위한 대화형 명령어.
Rust
Rust 런타임 코어
6-크레이트 워크스페이스: API 클라이언트, 16개 런타임 모듈, CLI 바이너리, 도구/명령어 레지스트리.
Engine
쿼리 엔진 & 턴 루프
세션 오케스트레이션, 예산 제어, 스트리밍 이벤트, 대화 런타임 루프.
세션
세션 & 메모리 관리
영속성, 트랜스크립트 압축, 컨텍스트 탐색, CLAUDE.md 지시 파일 시스템.
Security
권한 시스템
세 가지 권한 모드, 도구별 정책 엔진, 거부 목록, 대화형 프롬프트.
Protocol
MCP 연동
6가지 전송 유형, 도구 명명 규칙, 설정 해싱, MCP 서버용 OAuth.
API
API 클라이언트 & 스트리밍
Anthropic API 연동, SSE 스트리밍, 재시도 정책, OAuth PKCE, 토큰 추적.
History
소스 유출 타임라인
2026년 3월 Claude Code 유출 — 512K줄, 공급망 공격, Claw Code의 탄생.
비교
Claw Code vs Claude Code
기능별 비교, 생태계 프로젝트, 올바른 도구 선택.
Guide
시작하기
설치, CLI 명령어, 환경 변수, 첫 에이전트 세션.

자주 묻는 질문

Claw Code란 무엇인가요?

Claw Code는 Rust와 Python으로 구축된 오픈소스 AI 코딩 에이전트 프레임워크입니다. 2026년 3월 소스 코드 유출 이후 Sigrid Jin이 만든 Claude Code 에이전트 하네스 아키텍처의 클린룸 재구현입니다. 이 프로젝트는 독점 소스 코드를 일절 복사하지 않고 도구 시스템, 쿼리 엔진, 멀티 에이전트 오케스트레이션, 메모리 관리 등 핵심 아키텍처 패턴을 재구현합니다.

Claw Code에 Anthropic의 독점 코드나 모델 가중치가 포함되어 있나요?

아니요. Claw Code는 처음부터 완전히 새로 작성된 클린룸 구현입니다. 독립적인 코드 감사를 통해 프로젝트에 Anthropic 독점 소스 코드, 모델 가중치, API 키, 사용자 데이터가 포함되어 있지 않음이 확인되었습니다. 구현은 아키텍처적으로 참고하되 법적으로 독립적입니다.

Claw Code는 Claude Code와 어떻게 다른가요?

Claude Code는 TypeScript로 작성된 Anthropic의 공식 독점 CLI 에이전트로, Claude 구독이 필요합니다. Claw Code는 Python과 Rust로 작성된 오픈소스 대안으로, 다중 LLM 프로바이더(Claude, OpenAI, 로컬 모델)를 지원합니다. Claw Code는 개발자가 커스터마이징하고 자체 호스팅할 수 있는 모듈형 확장 가능 아키텍처를 제공합니다. 전체 비교를 참조하세요.

Claw Code는 어떤 언어와 기술을 사용하나요?

코드베이스는 Rust (72.9%)와 Python (27.1%)으로 구성되어 있습니다. Python은 에이전트 오케스트레이션 레이어, 명령어 파싱, LLM 연동을 담당합니다. Rust는 최대 성능과 메모리 안전성을 위한 완전한 네이티브 런타임을 목표로 하는 활성 마이그레이션 브랜치와 함께 성능 중요 런타임 경로를 구현합니다.

Claw Code는 누가 만들었나요?

Claw Code는 Wall Street Journal에서 250억 개 이상의 토큰을 처리한 세계에서 가장 활발한 Claude Code 사용자 중 한 명으로 소개된 개발자 Sigrid Jin (@sigridjineth)이 만들었습니다. 이 프로젝트는 GitHub의 instructkr 조직에서 관리되며 커뮤니티 기여를 환영합니다.

Claw Code는 안전한가요?

Claw Code 자체는 오픈소스이며 감사 가능합니다. 그러나 사용자는 더 넓은 생태계에 주의해야 합니다: 2026년 3월 31일 공급망 공격이 npm 기반 Claude Code 설치에 영향을 미쳤습니다. 항상 공식 소스에서 설치하고, 의존성 무결성을 확인하며, 무단 패키지가 있는지 잠금 파일을 검토하세요.

소스 탐색

Claw Code는 오픈소스이며 활발히 개발 중입니다. 아키텍처를 검토하고, 개선에 기여하거나, 자신만의 에이전트 프레임워크를 위해 포크하세요.