Agent SDK 개요
Agent SDK 개요
Claude Agent SDK는 Claude Code의 도구, 에이전트 루프, 컨텍스트 관리를 라이브러리로 꺼내 준 정식 SDK예요. 파이썬과 타입스크립트에서 직접 프로그래밍할 수 있죠.
에이전트는 스스로 단계를 계획하고, 파일을 읽거나 명령을 실행하거나 코드를 편집하는 도구를 호출하며 태스크를 완성하는 애플리케이션이에요. Agent SDK는 그 에이전트 루프를 내 프로세스 안에서 직접 돌릴 수 있게 해 줘요. 직접 도구 루프를 구현하고 싶지 않을 때, 즉 'Claude Code를 라이브러리로' 쓰고 싶을 때 선택하는 도구예요.
다른 Claude 도구와 비교하면 이래요. 터미널에서 대화형으로 작업할 땐 Claude Code CLI를, API를 직접 호출하면서 도구 루프를 직접 짤 땐 Client SDK를, 샌드박스·세션 인프라 관리를 Anthropic에 맡기고 싶을 땐 Managed Agents(호스팅 REST API)를 써요. SDK는 파이썬·타입스크립트 라이브러리로만 제공되고, 다른 언어에서는 CLI를 -p 플래그와 --output-format json으로 서브프로세스 실행하는 식으로 써요.
SDK에서 쓸 수 있는 Claude Code 기능은 넓어요. 파일 읽기·쓰기·편집·명령 실행·웹 검색을 맡는 내장 도구, 에이전트 생명주기 지점에서 커스텀 코드를 실행하는 Hooks, 특수 태스크를 맡기는 Subagents, 외부 도구를 연결하는 MCP, 자동 실행·승인이 필요한 도구를 통제하는 Permissions, 컨텍스트를 이어가고 이어붙이는 Sessions, 그리고 프로젝트의 .claude/에서 자동 로드되는 Skills·Commands·Memory와 Plugins까지요.