앤트로픽 SDK

앤트로픽 SDK는 Claude API를 코드에서 편하게 부르도록 Anthropic이 직접 만든 공식 라이브러리로, 직접 만든 앱이나 스크립트에서 Claude를 부를 때 쓴다. HTTP 요청을 손으로 짜지 않아도 인증·재시도·스트리밍·응답 타입을 SDK가 처리해 주며, 대표 버전은 Python과 TypeScript/JavaScript다.

설치하고 세 줄이면 호출된다

Python은 pip install anthropic, TypeScript는 npm install @anthropic-ai/sdk로 설치한다. API 키는 환경 변수 ANTHROPIC_API_KEY에 넣어 두면 client = Anthropic()만으로 자동으로 읽어 온다. 키를 코드에 직접 적지 않는 편이 안전하다.

호출은 client.messages.create(model=..., max_tokens=..., messages=[...]) 형태다. max_tokens는 꼭 넣어야 하고, 모델 ID는 공식 문서의 최신 목록에서 골라 넣는다.

상황에 맞는 기능을 골라 쓴다

같은 SDK 안에 용도별 기능이 준비돼 있다. 작업 성격에 따라 아래처럼 고르면 된다.

스트리밍은 with client.messages.stream(...) as stream 패턴으로 받는다. 배치는 응답이 늦게 와도 되는 대신 비용을 아낄 수 있어, 문서 수천 건 요약 같은 일에 맞다.

재시도와 클라우드 연결도 기본 제공

일시적인 네트워크 오류나 요청 한도 초과는 SDK가 자동으로 몇 번 다시 시도한다. 재시도 횟수와 타임아웃은 클라이언트를 만들 때 바꿀 수 있다. Amazon Bedrock이나 Google Vertex AI를 통해 Claude를 쓴다면 그에 맞는 전용 클라이언트를 쓰면 코드 모양을 거의 그대로 유지할 수 있다.

Agent SDK와 헷갈리지 말 것

Client SDK는 질문을 보내고 답을 받는 한 번의 호출을 다룬다. 도구 실행 결과를 다시 넣고 반복하는 흐름은 직접 짜야 한다. 파일 읽기·명령 실행까지 알아서 반복하는 에이전트가 필요하면 Claude Code를 바탕으로 한 Agent SDK가 더 빠르다. 단순히 앱에 요약·분류·대화 기능을 넣는 정도라면 Client SDK로 충분하다.

내 서비스에 Claude를 붙일 때 주로 쓴다

가장 흔한 건 이미 있는 앱이나 스크립트에 Claude 호출을 끼워 넣는 방식이다. 화면에 바로 보여야 하는 곳은 스트리밍으로, 뒤에서 몰아서 돌리는 일은 배치로 나눠 쓴다.