iBetter Books
수정

Claude Agent SDK는 Claude Code를 떠받치는 동일한 에이전트 루프를 라이브러리 형태로 제공한다. 단순히 모델에 메시지를 보내고 답을 받는 것을 넘어, 도구 실행, 권한 제어, 서브에이전트 위임, 세션 지속까지 한 번에 묶어 주는 것이 핵심이다. CCA-F 시험은 "이 상황에서 query를 써야 하나 ClaudeSDKClient를 써야 하나", "권한 모드를 무엇으로 두어야 하나", "세션을 어떻게 이어 가거나 분기시켜야 하나" 같은 의사결정을 묻는다. 즉 API 호출 문법보다 아키텍처 선택의 근거를 평가한다.

이 장에서는 SDK의 구조와 두 가지 실행 진입점, 에이전트와 도구를 정의하고 실행하는 방법, 그리고 세션을 저장하고 재개하며 분기하는 상태 지속성 모델을 다룬다. 직접 API를 호출하는 방식과 SDK를 쓰는 방식의 경계를 명확히 하는 것이 이 장의 출발점이다.

이 장을 마치면 query와 ClaudeSDKClient의 차이를 한 문장으로 설명할 수 있고, AgentDefinition과 인프로세스 MCP 도구로 에이전트를 구성할 수 있으며, resume과 continue_conversation, fork_session의 상호 배타 규칙을 정확히 구분해 세션 전략을 설계할 수 있다.

제목
01 Agent SDK 구조와 핵심 개념
02 에이전트 정의와 실행
03 세션 관리와 상태 지속성