클로 코드 에이전트: 로컬 모델을 위한 클로드 코드 아키텍처의 파이썬 재구현

Claw Code Agent는 트윗을 통해 공유된 리버스 엔지니어링 작업을 바탕으로 Claude Code 에이전트 아키텍처를 완전히 Python으로 재구현한 프로젝트입니다. 이 프로젝트는 원본 Claude Code의 npm/TypeScript/Rust 구현이 Python 개발자들이 읽거나 확장하기 어려울 수 있다는 문제를 해결합니다.

핵심 기능

이 에이전트는 도구 호출을 포함한 완전한 에이전트 코딩 루프를 구현합니다. 주요 구성 요소는 다음과 같습니다:

• 핵심 도구: 파일 읽기/쓰기/편집, glob, grep, 셸
• 슬래시 명령어: /help, /context, /tools, /memory, /status, /model
• CLAUDE.md 탐색 기능이 있는 컨텍스트 엔진
• 세션 지속성 — 에이전트 실행 저장 및 재개
• 계층적 권한: 읽기 전용 → 쓰기 → 셸 → 안전하지 않음

모델 호환성

이 에이전트는 모든 OpenAI 호환 백엔드와 함께 작동합니다:

• vLLM (문서화된 경로)
• Ollama
• LiteLLM 프록시

권장 모델은 완전히 로컬에서 무료로 실행되는 Qwen3-Coder-30B-A3B-Instruct입니다.

개발 현황

이 프로젝트는 적극적으로 유지 관리되며, 팀은 기능 추가 및 풀 리퀘스트 수락 작업을 진행 중입니다. 사용자들은 누락된 기능이나 버그에 대해 이슈를 열어 제안할 것을 권장합니다.

이 구현은 Claude Code 아키텍처를 Python 개발자들이 로컬 모델로 에이전트 코딩 시스템을 이해, 수정 및 실행할 수 있도록 접근 가능하게 만듭니다.