Claude 기반 AI 에이전트의 실제 동작 원리를 배우는 20단계 하네스 엔지니어링 교과서
중간맛 분석
스택: Python + Claude + Bash 도구 + 파일 I/O. 난이도: 중상(에이전트 루프와 메시지 설계 이해 필수). 바로 쓸 수 있나: 네, 각 레슨은 독립 실행 code.py로 제공되며 pip install -r requirements.txt 후 즉시 실행 가능. 데모: s01은 한 줄 루프 + Bash 도구부터, s20은 20개 하네스 메커니즘 통합(서브에이전트·작업 시스템·팀 조율·워크트리 격리)까지 단계별 진행.
이런 레포예요
이럴 때 쓰면 좋아요
- Claude를 활용한 자동화 에이전트를 처음부터 설계·구현하고 싶은 엔지니어
- 기존 프롬프트 체이닝 프레임워크의 한계를 극복하고 진정한 에이전트 아키텍처를 이해하려는 개발자
- AI 모델과 실제 운영 환경(하네스)의 관계를 체계적으로 학습하려는 학생
핵심 기능
대안 대비 차별점
'에이전트를 만든다'는 표현을 '모델 훈련' vs '하네스 구축'으로 명확히 구분하며, 하네스 엔지니어의 진정한 역할(지능 엔지니어링 아님)을 교학하는 유일한 교과서이며, 무의미한 워크플로 빌더나 프롬프트 체이닝이 아니라 실제 DeepMind/OpenAI가 구축한 에이전트 패턴(훈련된 모델 + 운영 환경)을 충실히 재현합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Python 3.8+
- Anthropic API 키(Claude 접근 권한)
- 기본 명령줄 도구(Bash, git)
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/shareAI-lab/learn-claude-code.git && cd learn-claude-code && uv venv && uv pip install -r requirements.txt
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- 저장소를 클론하고 의존성 설치
git clone https://github.com/shareAI-lab/learn-claude-code
cd learn-claude-code
pip install -r requirements.txt
- 환경 파일 설정(ANTHROPIC_API_KEY 구성)
cp .env.example .env
- 첫 번째 레슨 실행(한 줄 루프 + Bash)
python s01_agent_loop/code.py
- 고급 레슨 실행(컨텍스트 압축)
python s08_context_compact/code.py
- 완전한 통합 레슨 실행(모든 메커니즘)
python s20_comprehensive/code.py
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try shareAI-lab/learn-claude-code
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2025년 생성
「AI 에이전트」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/shareAI-lab/learn-claude-code)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기