SDK

입문

SDK는 AI 문맥에서 자주 등장하는 개념입니다. 이 페이지는 입문 난이도로 SDK의 뜻과 쓰임을 빠르게 이해할 수 있도록 정리한 AI 용어사전 항목입니다.

SDK를 처음 보는 독자도 헷갈리지 않도록 정의와 맥락, 관련 글 1개를 한 페이지에 묶었습니다. 아래 설명을 먼저 읽고, 이어서 연결된 개념과 글까지 보면 이해가 훨씬 빨라집니다.

SDK는 Software Development Kit의 약자로, 특정 플랫폼이나 서비스를 위한 개발에 필요한 도구, 라이브러리, 문서, 코드 샘플을 하나로 묶어 제공하는 패키지입니다. 개발자가 처음부터 모든 것을 만들지 않고, 미리 준비된 도구 세트를 사용해 빠르게 개발할 수 있도록 돕습니다.

API와 SDK는 자주 혼동되지만 역할이 다릅니다. API는 통신 규격(어떤 형식으로 요청하면 어떤 응답이 오는지)이고, SDK는 그 API를 쉽게 쓸 수 있도록 만든 도구 세트입니다. API만으로도 개발할 수 있지만, SDK를 사용하면 인증 처리, 에러 핸들링, 타입 정의 등이 미리 구현되어 있어 훨씬 빠르게 작업할 수 있습니다.

AI 분야에서는 Anthropic의 anthropic (Python SDK), @anthropic-ai/sdk (Node.js SDK), OpenAI의 openai 패키지 등이 대표적입니다. 이 SDK들을 사용하면 몇 줄의 코드로 LLM을 호출할 수 있습니다.

ℹ️쉽게 말하면

API가 식당 메뉴판이라면, SDK는 '밀키트(meal kit)'입니다. 메뉴판만 보고 재료를 직접 구하고 요리할 수도 있지만, 밀키트에는 손질된 재료, 양념, 레시피가 모두 들어 있어서 훨씬 쉽고 빠르게 요리를 완성할 수 있습니다.

SDK가 포함하는 구성 요소는 서비스마다 다르지만, 일반적으로 다음을 포함합니다. 클라이언트 라이브러리는 API 호출을 추상화하여 개발자가 네트워크 통신의 세부 사항을 몰라도 서비스를 사용할 수 있게 합니다. 타입 정의(Type Definitions)는 TypeScript나 Python의 타입 힌트를 통해 IDE에서 자동 완성과 오류 검출을 지원합니다. 예제 코드는 빠른 시작(Quickstart)부터 고급 사용 사례까지 다양한 패턴을 보여줍니다. 유틸리티 함수는 토큰 수 계산, 스트리밍 처리, 재시도 로직 같은 반복 작업을 처리합니다.

모바일 개발에서도 SDK는 핵심 역할을 합니다. Apple의 iOS SDK는 앱 개발자가 카메라, GPS, 터치 인터페이스 등 하드웨어 기능을 쉽게 사용할 수 있도록 제공합니다. Google의 Android SDK도 마찬가지입니다. Meta는 Facebook 로그인, 광고 SDK를 제공하여 서드파티 앱이 자신의 서비스와 연동하기 쉽게 만들었습니다. 이처럼 SDK는 플랫폼 생태계를 확장하는 핵심 수단입니다. 개발자가 SDK를 많이 사용할수록 해당 플랫폼의 기능이 더 많은 앱에 녹아들기 때문입니다.

AI SDK를 선택할 때 고려해야 할 사항이 있습니다. 공식 SDK인지 서드파티 SDK인지 확인하는 것이 중요합니다. 공식 SDK는 최신 API 변경사항을 빠르게 반영하고, 보안 패치도 신속히 이루어집니다. 관리되지 않는 서드파티 SDK는 오래된 API를 사용하거나 보안 취약점이 남아 있을 수 있습니다. 또한 비동기 처리 지원 여부, 스트리밍 응답 지원, 레이트 리밋 처리 방식도 실제 프로덕션 환경에서 중요한 선택 기준입니다.

SDK 없이 순수 HTTP 요청으로 API를 호출할 수도 있습니다. curl이나 axios 같은 HTTP 클라이언트로 직접 엔드포인트를 호출하는 방식입니다. 하지만 이 방법은 인증 헤더 구성, JSON 직렬화, 에러 코드 처리, 재시도 로직을 모두 직접 구현해야 합니다. SDK는 이런 반복 작업을 제거하여 개발자가 비즈니스 로직에 집중할 수 있게 합니다. 결국 SDK는 개발 생산성과 코드 안정성을 동시에 높이는 도구입니다.

SDK 버전 관리는 실무에서 중요한 주제입니다. AI 서비스는 모델 업데이트나 API 변경이 빈번하기 때문에, SDK 버전이 오래되면 새로운 기능을 사용하지 못하거나 서비스가 중단될 수 있습니다. Semantic Versioning(주.부.수 버전 체계)을 따르는 SDK는 주요 버전(Major)이 바뀔 때 하위 호환성이 깨질 수 있다는 신호입니다. 프로덕션 환경에서는 패키지 버전을 고정(pinning)하고, 업그레이드 시에는 변경 이력(CHANGELOG)을 먼저 확인하는 것이 좋습니다.

최근에는 AI 에이전트 개발을 위한 전문 SDK도 등장했습니다. Anthropic의 Claude Agent SDK, LangChain, CrewAI 같은 도구들은 단순한 API 호출을 넘어, 여러 도구를 자율적으로 사용하고 복잡한 작업을 여러 단계로 처리하는 에이전트 시스템 구축을 지원합니다. 이런 에이전트 SDK는 도구 정의, 메모리 관리, 대화 흐름 제어 같은 고수준 기능을 추상화하여 제공합니다. 개발자가 에이전트의 행동 로직에만 집중하고, 인프라 복잡성은 SDK에 위임하는 구조입니다.

아래 글들은 SDK가 실제 문맥에서 어떻게 쓰이는지 보여주는 참고 자료입니다. glossary에서 개념을 잡고 관련 글로 넘어가면 이해가 훨씬 쉬워집니다.

가이드

컨텍스트 엔지니어링 완전 가이드 (2026년 3월 기준)

프롬프트 엔지니어링의 시대는 저물고, 컨텍스트 엔지니어링의 시대가 열렸습니다. LLM에 무엇을, 언제, 어떻게 전달할지를 설계하는 컨텍스트 엔지니어링의 핵심 개념부터 실전 패턴까지 2026년 기준으로 정리했습니다.