GPT-AGI/Clawd-Code
Claude-Code-Python: Reconstructing Claude Code in Python
📚 Clawd-Code란 무엇인가요?
Clawd-Code는 Anthropic의 Claude Code 에이전트를 Python으로 재구현한 프로젝트입니다. 원본 Claude Code는 TypeScript로 작성되었지만, 이 프로젝트는 동일한 아키텍처를 관용적인 Python (3.10+)으로 이식하고, 타입 힌트, 테스트 및 즉시 실행 가능한 명령줄 인터페이스를 추가했습니다.
단순한 코드 덤프가 아니라, 다음과 같은 기능을 갖춘 완전한 CLI REPL을 제공합니다:
- LLM 응답을 토큰 단위로 스트리밍
- 루프 내에서 도구(파일 읽기/쓰기, 웹 가져오기, bash 등) 호출
- 사용할 수 있는 도구를 제한하는 Markdown 기반 "스킬"(슬래시 명령어)로 확장 가능
목표는 개발자에게 지원되는 모든 LLM 공급자와 로컬에서 작동하는 프로덕션 준비가 완료된, 해킹 가능한 Claude 스타일의 코딩 어시스턴트를 제공하는 것입니다.
✨ 핵심 기능 (README 설명 기준)
| 기능 | 설명 |
|---|---|
| 스트리밍 에이전트 경험 | 실시간 토큰 스트리밍, /stream 토글, /render-last를 통한 이전 답변의 Markdown 재렌더링. |
| 프로그래밍 가능한 스킬 런타임 | 스킬은 SKILL.md 파일(Markdown 프런트매터)에서 정의됩니다. 인수, 허용된 도구 및 설명을 선언할 수 있습니다. |
| 다중 공급자 지원 | Anthropic Claude, OpenAI GPT, Zhipu GLM을 즉시 지원하며, 공급자 추가가 쉽습니다. |
| 대화형 REPL | 기록, 탭 자동 완성, 다중 행 모드, 세션 저장/로드 및 내장 명령어(/help, /save, /load 등)를 갖춘 풍부한 터미널 UI. |
| 완전한 CLI | clawd로 REPL 시작, clawd login으로 API 키 구성, clawd config로 설정 확인, clawd --version으로 버전 출력. |
| 도구 시스템 | 30개 이상의 내장 도구(파일 작업, Bash, 웹 가져오기/검색, 작업 관리, 에이전트 수준 도구, 구성 등)와 검증 및 샌드박스 기능. |
| 세션 지속성 | 세션을 로컬에 저장하고 나중에 다시 로드할 수 있습니다. |
| 테스트 및 문서 | 스킬, 공급자, REPL, 도구 및 컨텍스트를 다루는 핵심 테스트 스위트; 10개 이상의 Markdown 문서 및 변경 로그. |
🚀 시작하기
# Clone the repo
git clone https://github.com/GPT-AGI/Clawd-Code.git
cd Clawd-Code
# Create a virtual environment (uv is recommended)
uv venv --python 3.11
source .venv/bin/activate
# Install dependencies
uv pip install -r requirements.txt
LLM 공급자 구성
python -m src.cli login # interactive wizard
마법사가 공급자(Anthropic, OpenAI 또는 GLM)를 선택하고, API 키, 선택적 기본 URL 및 기본 모델을 입력하도록 안내합니다. 구성은 ~/.clawd/config.json에 저장됩니다.
에이전트 실행
python -m src.cli # start the REPL
python -m src.cli --help # show CLI options
이제 자연어를 입력하거나, /stream on을 사용하여 실시간 출력을 확인하거나, 스킬을 호출할 수 있습니다(예: >>> /explain-code qsort.py).
🛠️ 스킬로 확장하기
- 프로젝트 아래(또는
~/.clawd)에 디렉토리를 생성합니다:.clawd/skills/explain-code/SKILL.md - Markdown 프런트매터 블록을 작성합니다:
--- description: Explain code with analogies and diagrams allowed-tools: - Read - Grep - Glob arguments: [path] --- Explain the code in $path. Start with an analogy, then draw a diagram. - REPL에서
/explain-code <file>로 호출합니다.
스킬 시스템은 나열된 allowed-tools를 강제하고, $path를 인수로 대체하며, 동일한 샌드박스 도구 루프 내에서 실행합니다.
📦 프로젝트 레이아웃
Clawd-Code/
├─ src/
│ ├─ cli.py # entry point
│ ├─ providers/ # Anthropic, OpenAI, GLM adapters
│ ├─ repl/ # interactive REPL implementation
│ ├─ skills/ # loader for SKILL.md files
│ └─ tool_system/ # registry, validation, loop logic
├─ tests/ # unit & integration tests
├─ .clawd/skills/ # example project-level skills
└─ FEATURE_LIST.md # detailed feature status
🤝 기여하기
이 저장소는 일반적인 Python 오픈 소스 워크플로우를 따릅니다:
pip install -e .[dev] # install in editable mode with dev extras
pytest -v tests/ # run the test suite
가이드라인은 CONTRIBUTING.md에 있으며, 풀 리퀘스트를 환영합니다.
⚡ 성능 및 보안
- 시작 시간 < 1초, 메모리 < 50 MiB.
- API 키는 사용자 구성에 base64로 인코딩되어 저장되며,
.env파일은 무시됩니다. - 비밀 데이터는 저장소에 커밋되지 않습니다.
📄 라이선스
MIT – LICENSE를 참조하세요.
Clawd-Code는 로컬에서 실행되고, 완전히 스크립트화 가능하며, 자신만의 Markdown 기반 스킬로 확장할 수 있는 Claude 스타일의 코딩 어시스턴트를 순수 Python으로 제공합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트