API

개발자를 위한 API 연동·도구 사용·구조화 출력

Claude API로 개발하는 분들을 위한 카테고리입니다. 첫 호출부터 도구 사용(tool use), 구조화 출력, 모델별 요금과 컨텍스트 창까지 platform.claude.com 공식 문서를 기준으로 정리하며, 요금·모델 정보는 정기적으로 재검증합니다.

둘러보기

Claude API 입문. 키 발급과 요금·결제, 첫 호출, 오류 처리·재시도 등 시작에 필요한 기본 단계를 안내합니다.

Claude API 모델 선택 가이드. 모델 ID와 버전 관리, 컨텍스트 윈도우·토큰 개념, 모델 간 비교를 다룹니다.

API로 도구를 연동하는 Tool Use. 함수 호출 사용법과 구조화된 출력(structured outputs), 모범 사례를 안내합니다.

Claude API 고급 활용. 비용 최적화, 스트리밍, 오류·속도 제한(rate limit) 대응, 확장된 사고(extended thinking)를 다룹니다.

공식 SDK로 개발하기. Claude Agent SDK를 비롯한 SDK 사용법과 스트리밍 연동으로 애플리케이션을 만드는 방법을 다룹니다.

Claude API의 Python·TypeScript SDK가 오류를 어떤 예외로 구분하는지, 어떤 오류가 자동으로 재시도되는지, 타임아웃은 어떻게 바꾸는지 예제 코드와 함께 정리했습니다.

Claude Opus 5와 Sonnet 5는 가격, 속도, 컨텍스트, 사고 방식에서 차이가 있습니다. API와 Claude.ai 앱에서 상황에 맞는 모델을 고르는 방법을 정리했습니다.

클로드 코드(Claude Code)에서 쓸 API 키를 Claude 콘솔에서 발급받아 환경 변수로 연결하는 과정을 단계별로 안내합니다.

Claude API로 도구(tool)를 만들 때 이름과 설명을 어떻게 써야 Claude가 헷갈리지 않고 정확히 호출하는지, 공식 문서 기준 규칙과 자주 하는 실수를 정리했습니다.

Claude Opus 5·Sonnet 5·Haiku 4.5·Fable 5.1의 API 토큰 가격을 비교하고, Batch API 50% 할인과 프롬프트 캐싱 최대 90% 할인으로 비용을 줄이는 방법을 정리했습니다.

Claude API 결제·크레딧 오류의 원인과 해결법을 오류 코드별로 정리했습니다. 400 잔액부족·402 결제정보·429 한도초과 대응과 재발 방지까지 공식 문서 기준으로 안내합니다.