Claw Code vs Claude Code: 오픈소스 GitHub 클론이 AI 에이전트 아키텍처에 대해 밝혀주는 것

claw code github를 검색했거나 Claude Code open source가 의미 있는 형태로 존재하는지 궁금했다면, Claw Code가 사람들이 말하는 그 프로젝트입니다. 이는 Anthropic의 Claude Code를 오픈소스로 리버스 엔지니어링해 재구현한 것으로, Rust(런타임)와 Python(메타데이터 및 포팅 스캐폴드)으로 다시 만든 프로젝트이며, 프로덕션 스타일 AI 코딩 에이전트가 어떻게 구조화되는지 드물게 들여다볼 수 있게 해줍니다.

이 가이드는 우리의 일반적인 비교 형식을 따릅니다. 각 측면이 무엇인지, 실제 사용에서 어떻게 비교되는지, Claw Code가 기술적으로 어디에 위치하는지, 그리고 코드베이스를 평가하는 빌더를 위한 명확한 결론까지 다룹니다.

Claw Code란?

Claw Code는 Claude Code — 터미널과 IDE를 위한 Anthropic의 에이전틱 코딩 도구 — 의 핵심 기능을 복제하려는 오픈소스 프로젝트입니다. 소스 코드는 오픈 라이선스의 GitHub에 있으며, Anthropic과는 관련이 없습니다.

이 프로젝트는 두 계층으로 나뉩니다.

• Python 메타데이터 계층은 주로 포팅 스캐폴드 역할을 하며, 진행 상황 추적, 세션 지속성 관리, dataclass 기반 스키마 보관을 담당합니다.
• Rust CLI 런타임은 실제 에이전틱 대화 루프, 도구 실행, API 스트리밍, 권한 관리를 구현합니다.

약 1,500줄의 Python과 4,000줄의 Rust로 구성된 Claw Code는 초기 단계의 프로토타입입니다. 하지만 AI 코딩 에이전트를 작동하게 만드는 몇 가지 아키텍처 패턴은 정확하게 짚어냅니다.

Claude Code란?

Claude Code는 Anthropic의 독점형 터미널 및 IDE 네이티브 AI 코딩 어시스턴트입니다. 오픈소스가 아닙니다. 이 제품은 비공개 코드베이스로 Anthropic이 배포하며, MCP (Model Context Protocol), subagents, hooks, skills, 그리고 깊은 IDE 통합 같은 기능을 갖춘 Claude 모델과 함께 동작합니다.

사람들이 Claude Code open source를 찾을 때는 보통 (a) Claw Code처럼 GitHub에 있는 독립적인 재구현, 또는 (b) 완전히 다른 제품(예: 멀티 에이전트 데스크톱 코워커)을 찾는 경우입니다. Claw Code는 분명히 첫 번째 범주에 속하며, Claude Code 동작의 일부를 교육적이고 실험적으로 비춘 거울일 뿐 공식 릴리스는 아닙니다.

Claw Code vs Claude Code: 한눈에 보기

이 비교는 의도적으로 비대칭적입니다. Claw Code는 학습용 산출물 및 부분 재구현이고, Claude Code는 완전한 플랫폼 투자가 이루어진 출시 제품입니다.

Claw Code가 잘 구현한 것

에이전틱 대화 루프

Claw Code가 가장 잘 구현한 것은 모든 AI 코딩 어시스턴트의 핵심 엔진인 기본 에이전틱 루프입니다.

User message → API call → Parse response → Execute tools → Feed results back → Repeat

Rust 구현(ConversationRuntime<C, T>)은 ApiClient와 ToolExecutor에 대한 trait 기반 추상화로 이 루프를 모델링합니다. 이런 분리는 프로덕션 에이전트의 구조와 유사합니다. 모델 호출과 도구 실행을 분리해 테스트 가능하고 교체 가능하게 유지합니다.

SSE 스트리밍과 API 통합

API 클라이언트는 아마도 Claw Code에서 가장 프로덕션에 가까운 부분입니다. 다음을 구현합니다.

• Server-Sent Events (SSE) 스트리밍을 사용하는 Anthropic Messages API v1
• 버퍼링을 동반한 점진적 프레임 파싱
• 408, 429, 5xx 응답에 대한 exponential backoff를 포함한 재시도 로직
• cache_creation_input_tokens 및 cache_read_input_tokens에 대한 캐시 토큰 추적
• ANTHROPIC_API_KEY 및 ANTHROPIC_AUTH_TOKEN을 통한 인증

맞춤형 Anthropic 클라이언트를 만드는 사람이라면 이 crate는 신뢰할 만한 참고 자료입니다.

파일 작업 도구

Claw Code는 Bash, Read, Write, Edit, Glob, Grep의 여섯 가지 핵심 도구를 제공하며, Claude Code의 모델과 맞는 동작을 구현합니다.

• Edit는 regex가 아니라 정확한 문자열 일치를 사용하여 Claude Code의 동작을 맞추고 이스케이프 버그의 한 계열을 피합니다.
• Glob은 수정 시간 기준으로 결과를 정렬합니다(최신순).
• Grep은 컨텍스트 라인, 여러 출력 모드, 페이지네이션을 지원합니다.
• Write는 상위 디렉터리를 자동 생성합니다.

권한 모델

PermissionPolicy 구조체를 통한 도구별 오버라이드가 가능한 3단계 권한 시스템(Allow, Deny, Prompt)은 Claude Code가 도구 실행을 제어하는 방식을 반영합니다. 셸 명령을 실행하고 파일을 편집하는 모든 에이전트에는 이 계층이 필요하며, Claw Code의 설계 방향은 타당합니다.

세션 압축

컨텍스트가 토큰 한도에 가까워지면, 에이전트는 최신 메시지를 유용하게 유지하면서 이전 턴을 압축해야 합니다. Claw Code의 압축 방식은 이전 메시지를 시스템 프롬프트로 요약하고 마지막 N개의 턴을 유지하는 것으로, 실제 동작 방식을 잘 포착합니다.

중요한 차이점: 무엇이 빠져 있는가

Claw Code가 AI 코딩 에이전트의 뼈대를 담고 있긴 하지만, 프로토타입과 프로덕션 도구를 가르는 여러 시스템은 빠져 있습니다.

MCP (Model Context Protocol) 지원 없음

이것이 가장 큰 공백입니다. MCP는 Claude Code의 확장성 백본입니다. 외부 MCP 서버가 에이전트가 런타임에 발견하는 도구, 리소스, 프롬프트를 제공합니다. Claw Code에는 MCP 클라이언트, 전송 계층, 동적 디스커버리, 리소스 통합이 없으며, 도구 세트는 빌드 시점에 고정됩니다.

Subagent 오케스트레이션 없음

Claude Code는 중첩된 에이전트 대화와 병렬 작업을(격리 및 집계를 포함해) 실행할 수 있습니다. Claw Code는 중첩 대화, 작업트리 격리, 자식 컨텍스트 경계, 결과 병합을 구현하지 않습니다.

Hook 또는 skill 시스템 없음

프로덕션 Claude Code는 사용자 설정 가능한 hooks와 skill / slash-command 파이프라인을 제공합니다. Claw Code의 핸들러는 최소 수준(예: /compact만)이며, hook이나 skill 디스커버리 파이프라인이 없습니다.

불완전한 시스템 프롬프트 구성

프롬프트 빌더는 대략적인 섹션은 갖추고 있지만, CLAUDE.md 탐색, git 상태 스냅샷, MCP 서버 지침, 런타임 메타데이터(날짜, 모델명 등) 같은 동적 요소는 빠져 있습니다.

IDE 통합 없음

VS Code와 JetBrains 확장에 사용되는 브리지 및 서버 아키텍처가 없습니다.

구현 품질

Rust 계층 — 견고한 기반 (7/10)

Rust 코드는 #![forbid(unsafe_code)], trait 기반 구조, 여러 줄 프레임과 ping을 처리하는 SSE 파서를 사용합니다. 아쉬운 점으로는 serde_json 대신 세션 파일용 커스텀 JSON 파서, 겹치는 CLI 진입점, 하드코딩된 기본값, 그리고 단순한 토큰 추정(문자열 길이 / 4)이 있습니다.

Python 계층 — 대부분 스캐폴딩 (3/10)

Python 계층은 dataclass와 parity audit에는 깔끔하지만, 많은 부분이 placeholder stub, 시뮬레이션 도구, 비어 있는 remote/SSH 경로입니다. 현재의 런타임 가치는 Rust 계층에 있습니다.

기능 동등성 스코어카드

구현됨

• 핵심 에이전틱 대화 루프
• 6개의 MVP 도구(bash, read, write, edit, glob, grep)
• SSE를 지원하는 API 스트리밍 클라이언트
• 세션 지속성 및 압축

부분 구현됨

• 권한 강제 적용(완전한 대화형 프롬프팅 없이 프레임워크만 존재)
• 시스템 프롬프트 구성(동적 주입 없이 구조만 존재)
• 설정 파일 병합(user / project / local)

미구현

• MCP 클라이언트 및 전송
• Subagent / Agent 도구 실행
• LSP 또는 확장 기반 IDE 브리지
• skill 시스템, hooks, 웹 검색 도구
• 더 똑똑한 컨텍스트 예산 관리 및 비용 도구
• 노트북 및 PDF 읽기 도구

이것이 AI 에이전트 아키텍처에 대해 말해주는 것

Claw Code vs Claude Code의 항목별 대비를 넘어서, 이 GitHub 프로젝트는 빌더에게 유용한 산출물입니다.

• 루프는 쉬운 부분입니다. “모델 호출 → 도구 파싱 → 실행 → 피드백”은 간단합니다. 힘은 MCP, subagents, hooks, skills, IDE 브리지에서 나옵니다.
• 스트리밍은 중요합니다. 전체 완료를 기다릴 때까지 블로킹하는 것은 CLI 에이전트에서 끊긴 경험처럼 느껴집니다. Claw Code의 SSE 작업이 가장 재사용 가치가 높습니다.
• 권한은 필수 요건입니다 셸과 파일 도구에는.
• 컨텍스트는 여전히 어렵습니다. 단순한 압축은 어느 순간까지는 통하지만, 그 이후에는 안 됩니다. 프로덕션 시스템에는 선택적 보존과 예산 규율이 필요합니다.

결론

Claw Code는 Claude Code 기능 표면의 대략 **20~25%**를 담고 있습니다. API 클라이언트, 루프, 파일 도구를 포함한 Rust 계층이 가치 있는 핵심입니다. Python 계층은 주로 포팅 의도를 문서화합니다.

비공식 Claude Code open source 스타일 미러가 보여줄 수 있는 것과 claw code github에 대한 연구 대상으로서 Claw Code는 성공적입니다. 하지만 Claude Code를 즉시 교체 가능한 대체재로 보려면 MCP, 오케스트레이션, 통합 계층에서 훨씬 더 많은 작업이 필요합니다.

GitHub의 Claw Code를 자세히 살펴봐야 하는 사람은?

다음과 같은 경우 Claw Code를 선택하세요.

• Anthropic 스타일의 도구 루프와 SSE 클라이언트를 구현한 구체적인 오픈소스를 읽고 싶을 때
• 비공개 코드에 의존하지 않고 AI 코딩 에이전트 아키텍처를 교육하거나 연구하고 싶을 때
• MCP에 직접 투자할 수 있는 Rust 우선 기반을 포크하고 싶을 때

누가 Claude Code를 계속 써야 하는가?

MCP, subagents, IDE 확장, hooks, skills, 그리고 지원되는 제품 경로가 필요하다면 — 연구용 프로토타입이 아니라 — Anthropic의 Claude Code를 계속 사용하세요.

더 넓은 오픈소스 옵션으로 Eigent를 고려해야 하는 이유

목표가 단일 터미널 코딩 에이전트를 넘어서는 오픈소스 자동화라면, Eigent는 데스크톱 워크플로우, skills, 여러 모델 제공자를 갖춘 멀티 에이전트 오픈소스 코워커로, Claw Code를 통해 저수준 에이전트 메커니즘을 읽는 것과 상호 보완적입니다.

FAQ

GitHub의 Claw Code는 무엇인가요?

Claw Code는 Rust CLI와 Python 메타데이터 계층을 사용해 Claude Code의 일부를 리버스 엔지니어링한 오픈소스 프로젝트입니다. 저장소는 github.com/instructkr/claw-code입니다.

Claude Code는 오픈소스인가요?

아니요. Claude Code는 독점형입니다. Claw Code는 Claude Code의 동작에서 영감을 받은 독립적인 오픈소스 프로젝트이며, Anthropic의 공식 릴리스가 아닙니다.

Claw Code는 Claude Code의 완전한 대체품인가요?

현재는 아닙니다. 중요한 공백에는 MCP, subagent 오케스트레이션, IDE 통합, 전체 도구 및 프롬프트 파이프라인이 포함됩니다.

Claw Code는 어떤 언어로 작성되었나요?

주로 런타임용 Rust(~4천 줄)와 스캐폴딩용 Python(~1.5천 줄)입니다. Claude Code 자체는 비공개 TypeScript/Node 제품입니다.

MCP가 빠진 것이 왜 중요한가요?

MCP는 Claude Code가 도구를 동적으로 확장하는 방식입니다. 이것이 없으면 Claw Code의 도구 표면은 고정되어 실제 워크플로우가 제한됩니다.

핵심 요약

• Claw Code GitHub = 개방형 교육용 부분 클론; Claude Code = 독점형 완성 제품.
• Claw Code의 핵심 루프, 스트리밍 클라이언트, 파일 도구, 권한은 유익하지만 MCP, subagents, IDE 계층은 아직 없습니다.
• claude code open source를 검색하면 Claw Code 같은 프로젝트가 나와야 합니다 — 기능 완성형 대체재가 아니라 유용한 참고 자료입니다.