​
Claude Code SDK를 사용하는 이유는 무엇인가요?

Claude Code를 구동하는 에이전트 하네스 위에 구축된 Claude Code SDK는 프로덕션 준비 에이전트를 구축하는 데 필요한 모든 구성 요소를 제공합니다:

  • 최적화된 Claude 통합: 자동 프롬프트 캐싱 및 성능 최적화
  • 풍부한 도구 생태계: 파일 작업, 코드 실행, 웹 검색 및 MCP 확장성
  • 고급 권한: 에이전트 기능에 대한 세밀한 제어
  • 프로덕션 필수 요소: 내장된 오류 처리, 세션 관리 및 모니터링

​
SDK로 무엇을 구축할 수 있나요?

다음은 생성할 수 있는 에이전트 유형의 예시입니다:

코딩 에이전트:

  • 프로덕션 문제를 진단하고 수정하는 SRE 에이전트
  • 코드의 취약점을 감사하는 보안 검토 봇
  • 인시던트를 분류하는 온콜 엔지니어링 어시스턴트
  • 스타일과 모범 사례를 적용하는 코드 검토 에이전트

비즈니스 에이전트:

  • 계약서와 규정 준수를 검토하는 법무 어시스턴트
  • 보고서와 예측을 분석하는 재무 어드바이저
  • 기술적 문제를 해결하는 고객 지원 에이전트
  • 마케팅 팀을 위한 콘텐츠 제작 어시스턴트

​
SDK 옵션

Claude Code SDK는 다양한 사용 사례에 맞게 여러 형태로 제공됩니다:

​
핵심 개념

​
인증

기본 인증의 경우, Anthropic Console에서 Anthropic API 키를 가져와서 ANTHROPIC_API_KEY 환경 변수를 설정하세요.

SDK는 또한 서드파티 API 제공업체를 통한 인증을 지원합니다:

  • Amazon Bedrock: CLAUDE_CODE_USE_BEDROCK=1 환경 변수를 설정하고 AWS 자격 증명을 구성하세요
  • Google Vertex AI: CLAUDE_CODE_USE_VERTEX=1 환경 변수를 설정하고 Google Cloud 자격 증명을 구성하세요

서드파티 제공업체에 대한 자세한 구성 지침은 Amazon Bedrock 및 Google Vertex AI 문서를 참조하세요.

​
시스템 프롬프트

시스템 프롬프트는 에이전트의 역할, 전문성 및 동작을 정의합니다. 여기서 구축하고 있는 에이전트의 종류를 지정합니다.

​
도구 권한

세밀한 권한으로 에이전트가 사용할 수 있는 도구를 제어하세요:

  • allowedTools - 특정 도구를 명시적으로 허용
  • disallowedTools - 특정 도구 차단
  • permissionMode - 전체 권한 전략 설정

​
Model Context Protocol (MCP)

MCP 서버를 통해 맞춤형 도구와 통합으로 에이전트를 확장하세요. 이를 통해 데이터베이스, API 및 기타 외부 서비스에 연결할 수 있습니다.

​
일반적인 사용 사례

​
자동화된 테스팅 및 CI/CD

CI/CD 파이프라인에서 테스트를 실행하고, 결과를 분석하며, 문제를 자동으로 수정하는 에이전트를 생성하세요.

​
코드 검토 및 보안 감사

보안 취약점, 코드 품질 및 규정 준수를 위해 풀 리퀘스트를 검토하는 에이전트를 구축하세요.

​
인시던트 대응

프로덕션 문제를 진단하고, 로그를 분석하며, 수정 사항을 제안하는 SRE 에이전트를 배포하세요.

​
문서 생성

코드베이스를 기반으로 문서를 생성하고 유지 관리하는 에이전트를 생성하세요.

​
데이터 분석

데이터를 분석하고, 보고서를 생성하며, 시각화를 만드는 에이전트를 구축하세요.

​
모범 사례

  • JSON 출력 형식 사용 - 응답의 프로그래밍 방식 파싱을 위해
  • 오류를 우아하게 처리 - 종료 코드를 확인하고 재시도 로직을 구현하세요
  • 세션 관리 사용 - 다중 턴 대화에서 컨텍스트 유지를 위해
  • 타임아웃 구현 - 장시간 실행되는 작업을 위해
  • 속도 제한 준수 - 여러 요청을 할 때
  • 철저한 테스트 - 프로덕션에 배포하기 전에

​
관련 리소스