soongenwong/claudecode

Rust로 작성된 고성능 오픈 소스 (open-source) AI 코딩 에이전트입니다.

ClaudeCode는 고급 LLM (Large Language Model) 기능을 개발 워크플로우에 직접 가져오도록 설계된 터미널 네이티브 CLI (Command Line Interface) 에이전트입니다. 속도, 안전성 및 효율성을 위해 구축되었으며, 대화형 에이전트 셸 (shell), 워크스페이스 인식 도구, 지속적인 세션 관리 기능을 제공합니다. 이는 Anthropic의 공식 제품이 아니라, Claude Code에서 영감을 받은 독립적인 오픈 소스 구현체입니다.

Rust 기반: 메모리 안전성 (memory safety), 최소한의 바이너리 크기 및 높은 실행 속도를 위해 Rust로 구축되었습니다.
에이전트형 CLI (Agentic CLI): 원활한 터미널 워크플로우를 위한 대화형 셸 및 원샷 프롬프트 (one-shot prompt) 지원.
모델 유연성: Anthropic 호환 및 OpenAI 호환 제공업체를 지원하며, xAI/Grok 별칭도 지원합니다.
워크스페이스 인식: 로컬 코드베이스를 이해하도록 설계된 컨텍스트 인식 (context-aware) 도구.
세션 지속성: JSON 상태 관리를 통한 재개 가능한 세션.
확장 가능성: 커스텀 도구 및 기술을 위한 플러그인 준비 완료 아키텍처.

• Rust stable 및 Cargo를 설치하세요.
• 선호하는 API 자격 증명을 설정하세요.

저장소 루트에서:

cd rust
cargo build --release -p claw-cli
# 전역 액세스를 위해 로컬 PATH에 설치
...

대화형 셸 시작:

claw

단일 프롬프트 실행:

claw prompt "summarize this workspace"

이전 세션 재개:

claw --resume session.json /status

에이전트, 기술 및 시스템 프롬프트 흐름을 포함한 전체 명령 목록을 보려면 claw --help를 실행하세요.

선호하는 제공업체에 따라 환경 변수를 구성하세요:

export ANTHROPIC_API_KEY="..."
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

export OPENAI_API_KEY="..."
export OPENAI_BASE_URL="https://api.openai.com/v1"

export XAI_API_KEY="..."
export XAI_BASE_URL="https://api.x.ai"

CLI를 통해 인증할 수도 있습니다:

claw login

이 프로젝트는 무엇인가요? 이것은 Claude Code에서 아키텍처 영감을 받은, 터미널 기반 코딩 에이전트의 독립적인 오픈 소스 구현체입니다.

왜 Rust인가요? Rust는 로컬 파일 시스템 및 지연 시간(latency)이 높은 LLM API와 깊게 상호작용하는 도구에 필요한 성능, 동시성(concurrency), 그리고 메모리 안전성(memory safety)을 제공합니다.

로컬 모델을 사용할 수 있나요? 네, 사용 중인 로컬 추론(inference) 서버가 OpenAI 호환 API를 제공하고, 관련 Base URL과 API Key를 해당 서버로 지정한다면 가능합니다.

이것이 Anthropic의 공식 Claude Code인가요? 아니요, 이것은 커뮤니티 주도의 오픈 소스 프로젝트입니다.

기여를 환영합니다. 워크스페이스별 워크플로우 가이드는 CLAW.md를 참조해 주세요.

cd rust
cargo fmt
cargo clippy --workspace --all-targets -- -D warnings
...

rust/
: 핵심 CLI 및 런타임(runtime) 구현체.

src/
: Python 지원 코드 및 유틸리티.

tests/
: 에이전트 동작(agentic behaviors) 검증 스위트.

CLAW.md
: 내부 워크플로우 문서.

• 이 프로젝트는 오픈 소스 구현체입니다.
• Anthropic과 제휴하거나 Anthropic의 승인을 받은 것이 아닙니다.