ClaudeCode

Claude Code가 노출된 그 날, 누군가는 아카이브를 저장했고 누군가는 아키텍처를 읽었다.이 시리즈는 후자의 결과물인 Claw Code 프로젝트를 코드 레벨에서 분석하는 스터디 기록입니다.

이 글에서는 각 크레이트를 하나씩 열어보면서, 그 결정들의 의도를 읽어낸다.

바이트 스트림이 구조화된 이벤트가 되기까지. api 크레이트의 모든 레이어를 한 줄씩 따라간다.

AI 에이전트는 한 번의 대화가 아니라, "반복"으로 동작한다. 그 반복의 엔진을 해부한다.

AI 에이전트가 "행동"한다는 것은, 결국 도구를 실행한다는 것이다. 그 실행의 전체 경로를 추적한다.

Claude Code 클론 프로젝트 Claw Code의 소스를 한 줄씩 읽으며, 아키텍처를 추적하는 시리즈입니다.

Claude Code 클론 프로젝트 Claw Code의 소스를 한 줄씩 읽으며, 아키텍처를 추적하는 시리즈입니다.

Claude Code 클론 프로젝트 Claw Code의 소스를 한 줄씩 읽으며, 아키텍처를 추적하는 시리즈입니다.

Claude API Key 없이도 Claude Agent를 프로그래밍적으로 활용할 수 있다는 점이 이 프로젝트의 핵심입니다. 이미 구독 중이라면, 자동화나 개인 프로젝트에 추가 비용 없이 Claude를 연동할 수 있습니다.

이전 글에서는 딱 이 두 줄만 썼지만, 실제로 `ClaudeAgentOptions`에는 30개가 넘는 옵션이 있습니다. 이 글에서는 하나하나 뜯어보면서, 어떤 상황에서 어떤 옵션을 쓰면 되는지 정리합니다.

Claude Agent SDK로 query()를 호출하면, Claude의 응답은 단순한 문자열이 아닙니다. 여러 종류의 메시지 객체가 순서대로 날아옵니다.

이 글에서는 claude_agent_sdk가 던지는 모든 에러 타입을 분석하고, 각 에러가 언제, 왜 발생하는지, 그리고 어떻게 대응해야 하는지 정리합니다.

Agent 도구 사용을 세밀한 제어를 가능하게 해주는 것이 can_use_tool 콜백입니다.

이 글에서는 훅 시스템의 전체 구조를 분석하고, 실전 패턴을 정리합니다.

이 글에서는 SDK 인프로세스 방식을 중심으로 다루고, 외부 서버 연결도 설명합니다.

이 글에서는 세션이 어떻게 저장되는지부터, 이 함수들로 대시보드, 히스토리 뷰어, 세션 분석 도구를 만드는 방법까지 다룹니다.

들어가며 지금까지의 모든 예시에서 Claude는 혼자 일했습니다. 프롬프트를 받고, 도구를 쓰고, 결과를 돌려주는 단일 에이전트였죠. 하지만 복잡한 작업에서는 하나의 에이전트가 모든 것을 하기 어렵습니다: 코드를 분석하는 에이전트, 테스트를 작성하는 에이전트, 문서를 생성하는 에이전트가 따로 있으면? 각 에이전트에 다른 모델, 다른 도구, 다른 시스템...