Anthropic, Claude Code SDK 정식 공개—IDE 외부 에이전트 직접 구축 가능
Anthropic이 Claude Code의 핵심 기능을 외부 애플리케이션에서 직접 호출할 수 있는 Claude Code SDK를 정식 공개했다. 이로써 개발자는 VS Code나 JetBrains 없이도 자체 도구·CI 파이프라인에 코드 이해·수정·실행 에이전트를 직접 임베드할 수 있다. 특히 멀티스텝 코드 태스크를 하나의 세션으로 유지하는 컨텍스트 관리 API가 포함되어 복잡한 리팩터링 자동화에 유용하다.
SDK 핵심 구성 요소
Claude Code SDK는 세 가지 주요 모듈로 구성된다.
- CodeSession API: 단일 세션 내에서 파일 읽기·수정·실행을 연속적으로 수행. 최대 컨텍스트 200,000 토큰 유지.
- ToolCall 인터페이스: bash 실행, 파일 시스템 접근, 외부 API 호출을 표준화된 스키마로 정의. 커스텀 툴 추가 가능.
- Streaming Diff 출력: 코드 변경 사항을 유닉스 diff 형식으로 실시간 스트리밍해 PR 자동 생성 파이프라인과 즉시 연결 가능.
지원 모델 및 요금
SDK는 Claude Sonnet 4.6 및 Claude Haiku 4.5 백엔드를 선택적으로 사용할 수 있다. 복잡한 다단계 리팩터링에는 Sonnet 4.6, 빠른 인라인 완성에는 Haiku 4.5를 권장한다. 요금은 기존 Messages API 토큰 요금과 동일하며 SDK 추가 비용은 없다. 정확한 단가는 공식 페이지 참조.
한국 개발자 활용 시나리오
CI/CD 통합: GitHub Actions 또는 GitLab CI 워크플로우에 SDK를 삽입해 PR 생성 시 자동 코드 리뷰·버그 수정 커밋을 트리거할 수 있다.
사내 개발 포털: 기업 내부 개발 포털에 코드 질의 기능을 직접 임베드해 보안 정책상 외부 IDE 플러그인을 사용하기 어려운 환경에서도 AI 코딩 지원을 제공할 수 있다.
로컬 에이전트 데모: Python SDK 기준 pip install anthropic-code-sdk로 설치 후 약 20줄 코드로 최소 동작 에이전트를 구성할 수 있어 프로토타이핑 진입 장벽이 낮다.
from anthropic_code import CodeSession
session = CodeSession(model="claude-sonnet-4-6")
result = session.run("src/utils.py의 중복 함수를 찾아 병합해줘")
print(result.diff)
공식 문서와 예제 저장소는 Anthropic GitHub 조직 페이지에서 확인할 수 있다.