Claude API 에러 처리와 재시도: 429·529·타임아웃에 안전하게 대응하기
Claude API를 서비스에 붙이면 요청 과다(429), 서버 과부하, 타임아웃 같은 오류를 반드시 만납니다. 오류 종류별 의미, 재시도해야 하는 오류와 하면 안 되는 오류, 파이썬 SDK의 기본 재시도와 타임아웃 설정, 실무 패턴을 정리했습니다.
📂 API·자동화
Claude API 호출, 요금 계산, 프롬프트 캐싱, 툴 사용, 배치 처리 가이드
Claude API 이미지 입력(비전) 사용법: 영수증·차트·스크린샷 읽히기
Claude API는 텍스트와 함께 이미지를 입력받아 내용을 읽고 분석할 수 있습니다. base64·URL 두 가지 전달 방식, 파이썬 예제, 영수증·차트·스크린샷 활용 예시, 이미지 크기와 비용, 정확도를 높이는 요령을 정리했습니다.
클로드 API로 사내 문서 Q&A 만들기: RAG 기본 구조 이해하기
사내 규정집, 매뉴얼, FAQ를 근거로 답하는 Q&A 봇을 Claude API로 만드는 기본 구조(RAG)를 정리했습니다. 문서를 통째로 넣는 방식과 검색해서 넣는 방식의 차이, 문서 나누기, 검색, 답변 생성 단계와 파이썬 예시, 품질을 높이는 요령을 담았습니다.
클로드 API 스트리밍 응답 구현하기: 챗봇처럼 글자를 흘려 보여주기
Claude API의 스트리밍을 쓰면 답변이 완성될 때까지 기다리지 않고 생성되는 대로 화면에 보여줄 수 있습니다. 스트리밍이 필요한 이유, 파이썬 SDK의 stream 사용법, 최종 메시지 받기, 웹 서버로 전달하는 구조와 주의점을 정리했습니다.
클로드 API 구조화 출력: JSON으로 안정적으로 받는 방법
Claude API 결과를 프로그램에서 바로 쓰려면 정해진 JSON 형식으로 받아야 합니다. 프롬프트로 요청하는 방법의 한계, 구조화 출력(output_config.format)과 파이썬 SDK의 parse로 스키마에 맞는 결과를 받는 방법, 실무 예시와 주의점을 정리했습니다.
클로드 배치 API로 대량 작업 비용 절반으로 줄이기
실시간 응답이 필요 없는 대량 작업이라면 Claude Message Batches API로 비용을 표준 요금의 절반으로 줄일 수 있습니다. 배치 API의 작동 방식, 파이썬 제출·조회·결과 수집 코드, 적합한 작업과 주의점을 정리했습니다.
클로드 API 툴 사용(Function Calling) 입문: 재고 조회 예제로 이해하기
Claude API의 툴 사용(tool use)은 클로드가 내가 만든 함수를 호출하도록 하는 기능입니다. 툴 정의 방법, 요청-실행-결과 반환의 흐름, 재고 조회 예제 파이썬 코드, SDK 툴 러너로 루프를 간단히 하는 법과 주의점을 정리했습니다.
클로드 API 프롬프트 캐싱으로 비용 줄이기: 원리와 적용 예
같은 시스템 프롬프트나 긴 문서를 반복해 보내는 API 작업이라면 프롬프트 캐싱으로 입력 비용과 응답 시간을 크게 줄일 수 있습니다. 캐싱 원리, 파이썬 적용 코드, 캐시가 안 걸리는 흔한 실수와 확인 방법을 정리했습니다.
클로드 API 요금 계산법: 토큰 개념과 모델별 비용 예시
Claude API 요금은 입력 토큰과 출력 토큰에 따라 계산됩니다. 토큰이 무엇인지, 한국어는 토큰이 어떻게 계산되는지, 모델별 단가로 실제 작업 비용을 추정하는 방법과 비용을 줄이는 기본 원칙을 예시와 함께 정리했습니다.
클로드 API 시작하기: 키 발급부터 파이썬 첫 호출까지
Claude API를 처음 쓰는 분을 위해 개발자 콘솔 가입, 결제 등록, API 키 발급, 파이썬 SDK 설치와 첫 메시지 호출까지 순서대로 정리했습니다. 키를 안전하게 보관하는 방법과 자주 만나는 오류도 담았습니다.