lorryjovens-hub/claude-code-rust
요약
Anthropic의 Claude Code를 Rust 언어로 완전히 재구축하여 성능과 효율성을 극대화한 프로젝트입니다. 기존 TypeScript 기반 버전 대비 실행 속도는 최대 25배 빨라졌으며, 배포 크기는 97% 감소하여 매우 가볍고 안전한 환경을 제공합니다.
핵심 포인트
- 성능 혁신: 시작 속도 2.5배 향상 및 특정 명령 실행 속도 최대 25배 향상
- 경량화: 설치 크기를 164MB에서 5MB로 97% 감소시키고 의존성 제거
- 보안 및 안정성: Rust의 메모리 안전성을 통해 런타임 보안 위험 제거
- 편의성: 단일 파일 배포로 별도의 의존성 설치 없이 즉시 사용 가능
- 기능 호환성: CLI, REPL, MCP 서비스 및 플러그인 시스템을 100% 유지
claude.rust.mp4
본 프로젝트는 TS(TypeScript) 기반의 Claude Code 소스 코드를 포함하고 있습니다. 전체 웹사이트 프로젝트 소개: 프로젝트 전체 소개 및 다운로드 https://claude-rust-gui.netlify.app/ 2026.4.24 업데이트된 GUI 클라이언트:
🚀
Anthropic Claude Code의 Rust 전량 재구축(Refactor) 버전 - 성능 2.5배 향상, 크기 97% 감소, 의존성 없는 네이티브 보안
| 웹사이트 | 설명 |
|---|---|
| Claude Code Rust | 공식 프로젝트 웹사이트 - 성능 시연 및 설치 가이드 |
| Claude Code Rust Landing | 프로젝트 소개 및 특징 시연 |
이것은 Rust를 사용하여 처음부터 완전히 재구축한 Claude Code 툴체인(Toolchain)으로, 100% 기능 호환성을 유지하면서 다음과 같은 이점을 제공합니다:
- ⚡ 성능 혁명: 시작 속도 2.5배 빠름, 명령 실행 속도 25배 빠름
- 📦 경량화: 164MB에서 단 5MB로 감소, 배포 크기 97% 감소
- 🔒 메모리 안전성 (Memory Safety): Rust 컴파일러가 런타임(Runtime) 보안 위험 제로를 보장
- 🚀 즉시 사용 가능 (Out-of-the-box): 단일 파일 배포, 별도의 의존성 설치 불필요
- 🏗️ 완전한 기능: CLI, REPL, MCP 서비스, 플러그인 시스템 완비
이는 현대적인 시스템 프로그래밍 언어의 장점을 AI IDE 툴체인에 도입한 위대한 기술적 개조입니다.
| 지표 | Rust 버전 | TypeScript 버전 | 성능 향상 |
|---|---|---|---|
| 평균 시작 시간 | 63ms ⚡ | 158ms | 2.5x 더 빠름 🚀 |
| 콜드 스타트 (Cold Start) | 58ms | 152ms | 2.6x 더 빠름 |
| 웜 스타트 (Warm Start, 캐시) | 61ms | 156ms | 2.5x 더 빠름 |
| 최단 시작 시간 | 51ms | 145ms | 2.8x 더 빠름 |
| 최장 시작 시간 | 74ms | 172ms | 2.3x 더 빠름 |
| 지표 | Rust 버전 | TypeScript 버전 | 감소 비율 |
|---|---|---|---|
| 단일 파일 실행 파일 | 5.07 MB 🎯 | - | - |
| npm 설치 후 크기 | 컴파일만 필요 | 164.32 MB 📦 | 97% 감소 |
| node_modules 크기 | 0 MB (의존성 없음) | ~156 MB | 100% 제거 |
| 런타임 (Runtime) 의존성 | 0 MB (내장) | ~8 MB (Node.js) | 100% 제거 |
| Docker 이미지 | ~20 MB (OS 포함) | ~600 MB+ | 96% 감소 |
| 명령 동작 | Rust 버전 | TypeScript 버전 | 향상 배수 |
|---|---|---|---|
--version | 63ms | 158ms | 2.5x ⚡ |
--help | 73ms | 176ms | 2.4x ⚡ |
| 설정 확인 | 6ms ✨ | ~150ms | 25x 🔥 |
| 프로젝트 초기화 | 85ms | ~200ms | 2.3x ⚡ |
| REPL 응답 | <1ms | ~100ms | 100x 🚀 |
| 지표 | Rust 버전 | TypeScript 버전 | 장점 |
|---|---|---|---|
| 기본 메모리 점유 | ~10 MB 🎯 | ~50+ MB | 5x 더 가벼움 |
| 실제 작업 메모리 | ~15 MB | ~150+ MB | 10x 더 가벼움 |
| 피크(Peak) 메모리 | ~25 MB | 300+ MB | 12x 더 가벼움 |
| 가비지 컬렉션 (GC) 중단 | 0ms (GC 없음) | ~50-200ms | 완전히 제거 |
| 스레드 오버헤드 (Thread Overhead) | 매우 낮음 | 100+ MB (Node 멀티스레딩) | 유의미한 오버헤드 없음 |
성능 지표 Rust TypeScript 개선 배수
─────────────────────────────────────────────────────────
시작 속도 63ms 158ms 2.5x ⚡
...
| 특징 | 장점 | 실제 영향 |
|---|---|---|
| 네이티브 컴파일 (Native Compilation) | JIT 지연 없음, 머신 코드를 직접 실행 | 시작 시간이 158ms → 63ms로 단축 |
| 제로 런타임 (Zero Runtime) | Node.js/Bun 등의 의존성 불필요 | 배포 크기가 164MB → 5MB로 단축 |
| 빠른 시작 | 60ms 이내에 초기화 완료 | 서버 측 고빈도 호출 시나리오에 적합 |
| 낮은 메모리 점유 | 기본 메모리 10MB만 사용 | 50개 이상의 인스턴스를 동시에 실행해도 무리 없음 |
테스트 시나리오:
- ✅ 100회 실행: Rust 6.3초, TypeScript 15.8초 소요
- ✅ 50개 인스턴스 동시 실행: Rust 500MB 점유, TypeScript 5GB 점유
- ✅ 구성 쿼리 성능: Rust 6ms vs TypeScript 150ms
(25배 차이)
| 안전 특성 | 기술 솔루션 | 결과 |
|---|---|---|
| 컴파일 시 검사 | Rust의 소유권 시스템 (Ownership System) | 메모리 오류 100% 발견 |
| 런타임 크래시 없음 | Null 포인터, 버퍼 오버플로 (Buffer Overflow) 제거 | 메모리 누수(Memory Leak) 및 세그멘테이션 폴트(Segmentation Fault) 제로 |
| 결정론적 해제 | GC (Garbage Collection) 중단 없음 | 예측 가능한 지연 시간, 스파이크(Spike) 현상 없음 |
| 스레드 안전 (Thread Safety) | 데이터 경합 (Data Race) 자동 탐지 | 멀티스레드 버그 완전 방지 |
안전성 개선:
- ✅ TypeScript 버전 대비 알려진 보안 취약점 0개
- ✅ 메모리 누수 위험 감소
99.9% - ✅ 크래시율이 0.1% (Node.js) → 0.0% (Rust)로 감소
배포 비교 (단일 인스턴스)
├─ Rust 버전
│ ├─ 실행 파일: 5.07 MB
...
배포 우위:
- ✅ Docker 이미지: 600MB+ → 20MB (96% 감소)
- ✅ 네트워크 전송: 다운로드 시간이 30초 → 0.5초로 단축
- ✅ 디스크 비용: 1,000개 복제본 기준 164GB → 5GB
터미널 상호작용은 공식 버전과 완전히 동일합니다:
🚀 주요 기능 모듈
├─ 🎯 CLI 커맨드라인 도구
│ ├─ 단일 쿼리 실행
...
기능 완전성: ✅ 100% 기능 호환성, 학습 비용 제로
claude-code-rust/
├── src/
│ ├── api/ # API 클라이언트 (Anthropic/DeepSeek 지원)
...
Rust: 1.75+ (rustup.rs를 통해 설치)
Git: 저장소 클론용
운영체제 (OS): Windows / Linux / macOS
Windows (PowerShell):
# 저장소 클론
git clone https://github.com/lorryjovens-hub/claude-code-rust.git
cd claude-code-rust
...
Linux / macOS:
# 저장소 클론
git clone https://github.com/lorryjovens-hub/claude-code-rust.git
cd claude-code-rust
...
# 저장소 클론
git clone https://github.com/lorryjovens-hub/claude-code-rust.git
cd claude-code-rust
...
# D 드라이브를 빌드 디렉토리로 사용
cargo build --release --target-dir "D:\claude-code\target"
# 실행 파일 위치
...
# 방식 1: 커맨드라인 설정을 사용 (권장)
claude-code config set api_key "your-api-key"
claude-code config set base_url "https://api.deepseek.com"
...
# 버전 확인
claude-code --version
# 도움말 확인
...
# PowerShell
cd claude-code-rust
.\benchmark.ps1
========================================
Claude Code 성능 벤치마크 (Performance Benchmark)
========================================
...
| 구성 요소 | 기술 | 버전 | 용도 |
|---|---|---|---|
| 언어 | Rust | 1.75+ | 핵심 언어 |
| ... | |||
| 특성 | Rust 버전 | TypeScript 버전 | |
| --- | --- | --- | |
| 런타임 의존성 | |||
| ❌ 없음 | ✅ Node.js/Bun | ||
| 시작 시간 | |||
| 63ms | 158ms | ||
| 메모리 점유 | |||
| ~10MB | ~100MB+ | ||
| 배포 크기 | |||
| 5MB | 164MB+ | ||
| 메모리 안전성 | |||
| 컴파일 시 보장 | 런타임 체크 | ||
| 동시성 모델 | |||
| 멀티스레딩 (Multi-threading) | 싱글스레드 이벤트 루프 (Single-threaded Event Loop) | ||
| CPU 효율 | |||
| 네이티브 코드 (Native Code) | JIT 컴파일 | ||
| 크로스 플랫폼 | |||
| 컴파일 시 가능 | npm install | ||
| 배포 방식 | |||
| 단일 파일 (Single File) | npm 패키지 | ||
| 컨테이너 이미지 | |||
| ~20MB | ~200MB+ |
CI/CD 파이프라인: 빠른 시작으로 빈번한 호출에 적합
컨테이너화 배포: 더 작은 이미지 크기
임베디드/엣지 디바이스: 낮은 리소스 점유
고빈도 호출 시나리오: 커맨드라인 스크립트 통합
리소스 제한 환경: 서버, 컨테이너
-
빠른 프로토타이핑 (Prototyping) 개발
-
완전한 생태계 지원 필요
-
동적 구성 핫 리로드 (Hot Reload)
-
플러그인 동적 로딩
-
CLI 기본 명령 프레임워크
-
설정 관리 시스템
-
REPL 상호작용 모드
-
MCP 프로토콜 지원
-
도구 시스템 (파일 조작, 명령 실행, 검색, 리스트)
Git 조작 도구- status, add, commit, push, pull, log, diff, branch, checkout -
태스크 관리 도구- create, update, delete, list, complete, get (우선순위 및 태그 포함) -
노트 편집 도구- Markdown 지원, 검색, 태그 관리 -
스킬 프레임워크 시스템- Skill trait, Registry, 5개의 내장 스킬을 갖춘 Executor -
메모리 관리 모듈
-
플러그인 시스템 아키텍처
-
음성 입력 모드
-
세션 관리
-
AutoDream 서비스
-
Magic Docs 서비스
-
팀 메모리 동기화
-
플러그인 마켓
-
내장 프록시 시스템
-
SSH 연결 지원
-
원격 호출 능력
-
프로젝트 초기화
-
설치 스크립트
-
부하 테스트 (Stress Test) 프레임워크
-
테스트 커버리지 (도구, 스킬, 통합 테스트)
-
API 스트리밍 응답 최적화
-
완전한 API 통합 테스트
-
WebAssembly 지원
-
GUI 버전 (egui/iced)
-
플러그인 마켓 웹 인터페이스
-
다국어 지원
-
스킬 시스템 완전 구현 (스킬 실제 실행)
코드 기여, 이슈 보고 또는 제안을 환영합니다!
# 개발 환경 설정
git clone https://github.com/lorryjovens-hub/claude-code-rust.git
cd claude-code-rust
...
- 본 저장소 Fork
- 기능 브랜치 생성 (
git checkout -b feature/amazing-feature) - 변경 사항 커밋 (
git commit -m 'Add amazing feature') - 브랜치로 푸시 (
git push origin feature/amazing-feature) - Pull Request 생성
MIT License - 자세한 내용은 LICENSE 파일을 참조하세요
Anthropic- 원본 Claude Code의 제작자
Rust 커뮤니티- 우수한 툴체인과 생태계
모든 기여자- 모든 기여자분께 감사드립니다
Issues: GitHub Issues
Discussions: GitHub Discussions
Made with ❤️ and Rust 🦀
이 프로젝트가 도움이 되었다면 ⭐️ Star로 응원해 주세요!
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기