shareAI-lab/learn-claude-code

개요 learn-claude-code는 Claude Code와 유사한 에이전트 하네스를 밑바닥부터 직접 구축해보는 학습용 프로젝트다. "Bash is all you need"라는 슬로건 아래, LLM 기반 코딩 에이전트가 내부적으로 어떻게 동작하는지를 TypeScript로 단계별 구현하며 이해할 수 있도록 설계되었다. GitHub 스타 35,000개 이상을 기록하며 큰 관심을 받고 있다.

핵심 내용 AI 코딩 에이전트의 핵심은 결국 LLM과 시스템 도구(파일 읽기/쓰기, 셸 실행 등) 사이의 루프다. 이 프로젝트는 그 루프를 직접 조립해보는 데 초점을 맞춘다. 프롬프트 설계, 도구 호출(tool use) 처리, 컨텍스트 관리, 멀티턴 대화 흐름 등 에이전트 하네스의 각 구성 요소를 0부터 1까지 만들어보면서, Claude Code 같은 도구가 내부에서 무엇을 하고 있는지 체감할 수 있다. TypeScript 기반이라 웹 개발자에게도 진입 장벽이 낮다.

기존 대비 차별점 대부분의 에이전트 프레임워크(LangChain, CrewAI 등)는 추상화 레이어가 두꺼워서 내부 동작을 파악하기 어렵다. 이 프로젝트는 의도적으로 최소한의 코드로 핵심 메커니즘만 드러내기 때문에, 에이전트 시스템의 본질을 학습하기에 훨씬 적합하다. "사용법"이 아니라 "작동 원리"를 가르치는 교육 자료라는 점이 가장 큰 차이다.

활용 가능성 자체 에이전트 하네스를 만들거나, 기존 에이전트 프레임워크를 커스터마이징할 때 기초 이해를 다지는 용도로 활용할 수 있다. 사내 코딩 에이전트를 구축하려는 팀이라면 이 프로젝트를 출발점 삼아 프로토타입을 빠르게 만들어볼 수도 있다.

참고 자료 - 원본 저장소 ===