Anthropic, Claude Code SDK 정식 GA—에이전트 코딩 파이프라인 직접 임베드 가능

Claude Code SDK란 무엇인가

Claude Code SDK는 기존 CLI 전용으로 제공되던 Claude Code의 코딩 에이전트 기능을 라이브러리 형태로 래핑한 공식 패키지다. @anthropic-ai/claude-code (npm) 및 anthropic-claude-code (PyPI) 두 가지 패키지로 배포된다. SDK는 내부적으로 Claude Sonnet 4.6 또는 Claude Opus 4.7을 모델 백엔드로 선택할 수 있으며, 에이전트 루프·툴 실행·파일 I/O 추상화를 모두 포함한다.

핵심 기능 및 스펙

• 모델 선택: claude-sonnet-4-6(기본), claude-opus-4-7(고성능) 중 택일
• 컨텍스트 윈도우: 최대 200,000 토큰 지원—대형 코드베이스 단일 세션 처리 가능
• 기본 제공 툴: bash, read_file, write_file, list_directory, web_search 5종 내장
• 커스텀 툴 주입: MCP(Model Context Protocol) 서버 엔드포인트를 mcpServers 옵션으로 주입, 사내 DB·CI/CD 툴 연동 가능
• 스트리밍 이벤트: message, tool_use, tool_result, error 이벤트를 AsyncIterator로 소비
• 가격: 모델 API 사용량 기준 과금, Claude Code SDK 자체 추가 요금 없음 (API 단가는 공식 페이지 참조)

import { ClaudeCode } from '@anthropic-ai/claude-code';

const agent = new ClaudeCode({ model: 'claude-sonnet-4-6' });
for await (const event of agent.run('src/ 디렉터리의 모든 타입 오류를 수정해줘')) {
  if (event.type === 'message') console.log(event.text);
}

한국 개발자·팀에게 실질적으로 달라지는 것

1. 코딩 어시스턴트 자체 서비스화: IDE 플러그인이나 사내 개발 포털에 Claude 기반 코딩 에이전트를 직접 내장할 수 있다. 기존에는 CLI를 subprocess로 호출하거나 Chat Completions API로 직접 에이전트 루프를 구현해야 했던 번거로움이 사라진다.
2. CI/CD 파이프라인 자동 리뷰·픽스: GitHub Actions·GitLab CI에서 PR이 열릴 때 SDK를 호출해 타입 오류·보안 취약점을 자동으로 수정하는 봇을 수십 줄로 구성할 수 있다.
3. 교육 플랫폼·코딩 테스트 도구: 국내 EdTech·채용 플랫폼이 자체 채점 로직과 AI 피드백을 결합한 인터랙티브 과제 시스템을 빠르게 구축하는 데 적합하다.
4. 멀티 에이전트 오케스트레이션: 여러 SDK 인스턴스를 병렬 실행해 마이크로서비스별로 코드 수정을 동시 진행하는 패턴이 공식 예제에 포함되어 있다.

시작점: 공식 문서 docs.anthropic.com/claude-code/sdk 및 GitHub anthropic/claude-code 레포지터리 examples/ 폴더에 Node·Python 샘플이 공개되어 있다.