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 | 세션 관리와 상태 지속성 |