CLI
Claw Code는 Claude Code의 아키텍처를 Rust와 Python으로 클린룸 재구현한 에이전트 코딩 CLI 도구다. 소스 유출 사건 이후 "단순 아카이브가 아니라 실제로 동작하는 도구를 만들자"는 목표로 탄생했으며, 역대 최단시간 GitHub 100K+ 스타를 기록했다.
Claude Code의 소스코드가 실수로 공개되자 수천 개의 포크가 생겼습니다. 대부분은 단순 복사본이었지만, Claw Code는 달랐습니다. 원본 레시피(아키텍처)를 보고 더 안전한 재료(Rust + unsafe 금지)로 처음부터 다시 요리한 것입니다.
핵심 차이는 Provider 추상화입니다. Claude Code는 Anthropic API 전용이지만, Claw Code는 전략 패턴으로 Anthropic, OpenAI 호환, Grok을 같은 코드로 다룰 수 있습니다.
2026년 3월 31일 Anthropic이 DMCA 요청을 8,100+개 레포에 보냈다. 단순 복사 포크는 법적으로 삭제됐지만, 클린룸 재구현(rewrite)은 살아남았다.
원본 소스를 직접 참조하지 않고, 공개된 동작/스펙만 보고 처음부터 재구현. MIT 라이선스로 누구나 포크/수정 가능. unsafe 코드 완전 금지로 메모리 안전성 보장.
| 비교 항목 | Claude Code (원본) | OpenAI Codex CLI | Claw Code |
|---|---|---|---|
| 언어 | TypeScript/Shell | Rust | Rust (메모리 안전 + 고성능) |
| 모델 제공자 | Anthropic 전용 | OpenAI 전용 | 다중 제공자 (Anthropic, OpenAI 호환, Grok) |
| 오픈소스 | 비공개 | Apache-2.0 | MIT 라이선스 |
| MCP 지원 | 클라이언트 | 클라이언트+서버 | Stdio, WebSocket, Remote |
| unsafe 정책 | 없음 | 일부 허용 | 완전 금지 (forbid) |
| 요소 | 설명 |
|---|---|
| Python 3.10+ | dataclasses, typing 활용 |
| 목적 | 아키텍처 검증 & 포팅 상태 추적 |
| 패턴 | Frozen Dataclasses, CLI 진입점 |
| 테스트 | unittest discover |
| 요소 | 설명 |
|---|---|
| CI/CD | GitHub Actions |
| 대상 플랫폼 | macOS, Linux (Windows 미완성) |
| 배포 방식 | 소스 빌드 (cargo install) |
| 코드 품질 | clippy (all=warn, pedantic=allow 억제), rustfmt |
path = "../runtime" 같은 로컬 의존성으로 연결. workspace.dependencies로 버전 통일 관리. 순환 참조 방지.api 크레이트의 providers/ 디렉토리에 anthropic.rs와 openai_compat.rs가 분리되어 있다. Grok(xAI)는 별도 파일 없이 openai_compat.rs 내 OpenAiCompatConfig로 처리된다(xAI 전용 URL·env var 포함). 새로운 LLM 제공자를 추가하려면 이 디렉토리에 파일 하나만 추가하면 된다. 전형적인 Strategy 패턴이다.
sandbox.rs가 유일한 public 모듈인 점이 인상적이다. 이는 모든 외부 코드 실행이 샌드박스를 통해야 한다는 설계 의도를 나타낸다. 파일 작업(file_ops.rs)이나 bash 실행(bash.rs)도 샌드박스 컨텍스트 안에서 이루어진다.
hooks.rs의 HookRunner가 도구 실행 전후에 사용자 정의 로직을 주입할 수 있다. Claude Code의 훅 시스템과 동일한 패턴으로, 프리/포스트 실행 단계에서 검증이나 로깅을 수행한다.
| 배울 것 | 어디서 | 왜 중요한가 |
|---|---|---|
| Cargo Workspace 설계 | rust/Cargo.toml | 대규모 Rust 프로젝트의 표준 구조. resolver v2, 공유 의존성 관리 |
| Tokio 비동기 런타임 | runtime 크레이트 전체 | LLM API 호출, MCP 통신 등 모두 async/await 기반 |
| Axum 웹 프레임워크 | server 크레이트 | tower 생태계 위의 현대적 Rust 웹 서버 구축법 |
| Reqwest + SSE | api/src/sse.rs | LLM 스트리밍 응답을 처리하는 실전 패턴 |
| unsafe 금지 정책 | Cargo.toml 린트 설정 | unsafe_code = "forbid" — 프로덕션 안전성 확보 |
| Clippy 린트 설정 | 워크스페이스 린트 | all=warn으로 기본 규칙 강제, pedantic=allow로 과도한 경고 억제 — 실용적 품질 균형 |
| 배울 것 | 어디서 | 왜 중요한가 |
|---|---|---|
| JSON-RPC 프로토콜 | runtime/mcp.rs | MCP의 통신 기반 |
| Stdio 전송 계층 | runtime/mcp_stdio.rs | 프로세스 간 통신(IPC) 구현 |
| 도구 매니페스트 | tools/src/lib.rs | LLM이 도구를 발견하고 호출하는 스키마 |
REPL 구현: claw-cli + Rustyline으로 대화형 CLI 구축 패턴. 터미널 제어: Crossterm으로 색상, 커서, 키 입력 처리. 마크다운 렌더링: pulldown-cmark + Syntect로 터미널에서 코드 구문 강조 출력.
| 항목 | 최소 사양 | 권장 사양 |
|---|---|---|
| OS | Linux (glibc 2.17+) 또는 macOS | macOS (Apple Silicon) 또는 최신 Linux |
| Rust | Stable 툴체인 (1.70+) | 최신 Stable |
| 메모리 | 2GB (빌드 시) | 4GB+ |
| 디스크 | 500MB (빌드 아티팩트) | 1GB |
| 네트워크 | LLM API 접속 필요 | 안정적인 인터넷 |
| API 키 | Anthropic 또는 OpenAI 호환 키 | 여러 제공자 키 |
| Windows | 미완성 (Linux WSL2 권장) | — |
git clone https://github.com/ultraworkers/claw-code.git
cd claw-code/rust
cargo build --release -p claw-cli
./target/release/clawcd claw-code
python3 -m src.main summary
python3 -m src.main manifestrust/crates/api/src/providers/ 디렉토리에 ollama_provider.rs를 추가해서 로컬 Ollama 서버와 통신하는 제공자를 구현한다.
commands 크레이트에 /stats 명령어를 추가한다. 현재 세션의 토큰 사용량(usage.rs)을 예쁘게 출력하는 기능이다.
runtime의 MCP 서브시스템을 활용해서 외부 MCP 서버(예: 파일 시스템 서버)를 연결하고, REPL에서 MCP 도구를 호출할 수 있도록 E2E 파이프라인을 완성한다.
The Rust Book 1~10장 (소유권, 라이프타임, 제네릭), rustlings 연습 문제 풀기, 간단한 CLI 도구 하나 만들어보기 (clap 사용).
Tokio 공식 튜토리얼 (mini-redis 예제), async/await 심화 — Pin, Future 트레이트 이해, claw-code의 runtime 크레이트 코드 리딩.
Axum 공식 예제 따라하기, Reqwest로 LLM API 호출하는 미니 프로젝트, SSE(Server-Sent Events) 스트리밍 구현, claw-code의 api, server 크레이트 분석.
MCP 스펙 문서 읽기 (modelcontextprotocol.io), 간단한 MCP 서버/클라이언트 구현, JSON-RPC 2.0 프로토콜 이해, claw-code의 MCP 서브시스템 코드 리딩.
Rust의 동적 디스패치 (dyn Trait) vs 정적 디스패치, 플러그인 레지스트리 패턴 구현, claw-code의 plugins 크레이트 분석 + 자체 플러그인 작성.
배운 것을 합쳐서 "나만의 에이전트 CLI" 제작. Provider 추상화 + MCP 도구 + REPL + 샌드박스 실행. GitHub에 공개하고 README 작성.
| 키워드 | 설명 |
|---|---|
| Clean-room Implementation | 원본 소스를 직접 참조하지 않고, 공개된 동작/스펙만 보고 처음부터 재구현하는 방식. 저작권 분쟁을 피하기 위한 소프트웨어 개발 기법 |
| Agent Harness | AI 에이전트를 "말 끌채"처럼 제어하는 도구. 사용자 입력 → LLM 호출 → 도구 실행 → 결과 반환의 루프를 관리 |
| MCP | Model Context Protocol. LLM이 외부 도구/데이터 소스와 표준화된 방식으로 통신하는 규격. JSON-RPC 2.0 기반 |
| REPL | Read-Eval-Print Loop. 사용자 입력을 읽고(Read), 실행하고(Eval), 결과를 출력(Print)하는 대화형 루프 |
| SSE | Server-Sent Events. 서버에서 클라이언트로 실시간 단방향 스트리밍. LLM의 토큰 단위 스트리밍 응답에 사용 |
| Cargo Workspace | 여러 Rust 크레이트를 하나의 프로젝트로 묶어 관리하는 방식. 의존성과 빌드 설정을 공유 |
| Tokio | Rust의 비동기 런타임. async/await 코드를 멀티스레드에서 효율적으로 실행 |
| Axum | Tower 서비스 위에 구축된 Rust 웹 프레임워크. 타입 안전하고 컴파일 타임에 라우팅 검증 |
| Serde | Rust의 직렬화/역직렬화 프레임워크. #[derive(Serialize, Deserialize)]로 자동 구현 |
| OAuth + PKCE | Proof Key for Code Exchange. 공개 클라이언트(CLI 등)에서 안전하게 OAuth 인증을 수행하는 확장 |
| Strategy 패턴 | 알고리즘을 캡슐화하여 런타임에 교체 가능하게 하는 디자인 패턴. Provider별 구현이 대표적 |
| Clippy | Rust의 정적 분석 도구. all=warn으로 기본 규칙을 강제하고, pedantic은 allow(억제)로 설정해 과도한 경고를 방지하는 실용적 구성 |
| LSP | Language Server Protocol. 에디터와 언어 서버 간 통신 프로토콜. 코드 완성, 정의 이동 등을 표준화 |
| DMCA | Digital Millennium Copyright Act. 저작권 침해 콘텐츠의 삭제를 요청하는 미국 법률 |
| Sandbox | 코드 실행을 격리된 환경에서 수행하여 시스템 안전성을 보장하는 기법 |
| rustfmt | Rust 코드 포매터. 팀 전체의 코드 스타일 통일에 사용 |