Anthropic, Claude Code SDK 정식 GA—에이전트 워크플로 직접 빌드 가능
Anthropic이 Claude Code의 핵심 에이전트 기능을 외부 애플리케이션에 직접 내장할 수 있는 Claude Code SDK를 정식 출시했다. 개발자는 파일 읽기·쓰기, 터미널 실행, 웹 검색 등 내장 도구를 자신의 파이프라인에 그대로 활용하거나 커스텀 툴을 추가해 독자적인 코딩 에이전트를 구성할 수 있다. 기존 CLI 단독 사용 대비 자동화 통합 범위가 크게 확장되어 CI/CD, 사내 개발 포털, 코드 리뷰 봇 등 다양한 B2B 시나리오에 적용이 가능해졌다.
Claude Code SDK란 무엇인가
Claude Code SDK는 Anthropic이 자사 CLI 도구인 Claude Code의 에이전트 런타임을 Python 및 TypeScript 라이브러리 형태로 패키징해 공개한 것이다. 기존에는 터미널에서 claude 명령어를 직접 실행해야만 에이전트 루프를 돌릴 수 있었지만, SDK를 통해 개발자는 import 한 줄로 동일한 루프를 자신의 애플리케이션 안에서 구동할 수 있다.
지원 모델은 Claude Opus 4·Sonnet 4·Haiku 4.5이며, 각 모델의 컨텍스트 길이(최대 200k 토큰)와 툴 호출 스펙은 기존 Messages API와 동일하게 유지된다. 가격은 기반 모델의 API 요금을 그대로 따르며 정확한 단가는 공식 페이지 참조.
핵심 기능 3가지
1. 내장 툴 세트 그대로 재사용
파일 시스템 읽기·쓰기(read_file, write_file), 배시 명령 실행(bash), 웹 검색(web_search) 등 Claude Code CLI에서 제공하던 20여 개 툴을 SDK에서도 동일하게 사용할 수 있다. 별도 MCP 서버 구성 없이도 로컬 파일 조작이 가능하다.
2. 커스텀 툴 주입
ToolDefinition 스펙에 맞춰 사내 API 호출, 데이터베이스 쿼리, Slack 알림 등 임의 함수를 툴로 등록할 수 있다. 에이전트는 자연어 지시를 받아 커스텀 툴과 내장 툴을 조합해 멀티스텝 작업을 자율 수행한다.
3. 스트리밍 이벤트 API
on_tool_call, on_tool_result, on_message 등 세분화된 이벤트 훅을 제공해 에이전트 실행 중간 상태를 실시간으로 UI에 렌더링하거나 로그로 저장하기 쉽다. 기존 SSE 방식과 완전 호환된다.
한국 개발자 활용 시나리오
- CI/CD 자동 코드 리뷰: GitHub Actions 워크플로 안에서 SDK를 호출해 PR 변경분을 분석하고 인라인 코멘트를 자동 생성.
- 사내 개발 포털 챗봇: 사내 Confluence·Jira API를 커스텀 툴로 등록하고, 자연어 질의로 티켓 생성·문서 검색을 자동화.
- 데이터 파이프라인 디버깅: 에이전트가 실패한 파이프라인 로그를 읽고 원인을 추론해 수정 패치까지 작성하는 루프 구성.
설치는 pip install claude-code-sdk 또는 npm install @anthropic-ai/claude-code-sdk로 가능하며, 공식 문서에서 Quickstart 예제와 전체 API 레퍼런스를 확인할 수 있다.