shareAI-lab/learn-claude-code

어떤 프로젝트인가요?

핵심 기능

• 01tool_use 블록을 중심으로 에이전트 루프를 만들며, bash 도구 하나에서 시작합니다.
• 02권한 규칙, 승인 파이프라인, 도구 실행 전후 훅을 다룹니다.
• 03계획 수립, 메시지 목록을 분리한 서브에이전트, 컨텍스트 압축을 포함합니다.
• 04파일 기반 작업 그래프, 백그라운드 실행, cron 스케줄링을 보여 줍니다.
• 05작업에 연결된 worktree를 사용하는 멀티 에이전트 팀과 MCP 도구 통합을 소개합니다.
• 06각 챕터에는 중국어 및 일본어 번역과 함께 독립적으로 실행할 수 있는 code.py가 제공됩니다.

활용 사례

• Claude Code와 같은 코딩 에이전트가 내부적으로 어떻게 구성되는지 학습합니다.
• 강의에서 제시하는 메커니즘 패턴을 활용해 특정 도메인에 맞는 에이전트 하네스를 만듭니다.
• 워크숍이나 강의에서 에이전트 설계 개념을 가르칩니다.
• 작게 실행해 볼 수 있는 예제를 통해 도구 디스패치, 컨텍스트 압축, 멀티 에이전트 조정 설계를 비교합니다.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/shareAI-lab/learn-claude-code
2. 2

   첫 번째 레슨 폴더를 열고 README를 따릅니다

3. 3

   레슨의 코드 파일을 실행합니다

   python s01_agent_loop/code.py

사용 전 알아둘 점

• !README에 설치 명령이 나와 있지 않으므로 Python 종속 항목과 API 키를 직접 설정해야 합니다.
• !레슨 코드는 Claude API를 호출하며, 유료 API 키가 필요합니다.

토픽

자주 묻는 질문

learn-claude-code은(는) 무엇인가요?

단일 루프와 bash에서 시작해 Claude Code와 유사한 에이전트 하네스를 처음부터 만드는 17개 강의로 구성된 Python 튜토리얼입니다. 이 저장소는 하네스 엔지니어링을 다루는 교육 과정입니다. LLM을 감싸 에이전트로 동작하게 하는 도구, 권한, 컨텍스트 관리 및 조정 코드를 만드는 방법을 설명합니다. 에이전시를 제공하는 것은 학습된 모델이고, 하네스는 모델이 동작하는 환경과 도구, 경계를 제공한다고 주장합니다.

learn-claude-code은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

learn-claude-code은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

learn-claude-code은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. learn-claude-code의 마지막 커밋은 2026년 9월 28일입니다.

learn-claude-code은(는) 어디에 사용할 수 있나요?

Claude Code와 같은 코딩 에이전트가 내부적으로 어떻게 구성되는지 학습합니다. 강의에서 제시하는 메커니즘 패턴을 활용해 특정 도메인에 맞는 에이전트 하네스를 만듭니다. 워크숍이나 강의에서 에이전트 설계 개념을 가르칩니다. 작게 실행해 볼 수 있는 예제를 통해 도구 디스패치, 컨텍스트 압축, 멀티 에이전트 조정 설계를 비교합니다.

learn-claude-code는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/shareAI-lab/learn-claude-code 첫 번째 레슨 폴더를 열고 README를 따릅니다 레슨의 코드 파일을 실행합니다: python s01_agent_loop/code.py

learn-claude-code은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/shareAI-lab/learn-claude-code