All Posts

Claude Tool Use 호출에서 400이 발생하는 가장 흔한 원인은 JSON Schema 불일치입니다. 실제로 자주 깨지는 포인트를 체크리스트로 정리하고, TypeScript로 스키마와 구현을 함께 검증하는 방법까지 다룹니다.

Claude Tool Use에서 400 오류가 나는 가장 흔한 원인은 tool schema(JSON Schema) 불일치입니다. 실제로 자주 터지는 케이스를 기준으로 원인-재현-해결-검증까지 한 번에 정리합니다.

RAG 파이프라인이 갑자기 반복 답변·환각을 내기 시작했다면 문제는 모델이 아니라 검색·청킹·리랭킹·컨텍스트 토큰 예산에 있을 확률이 큽니다. Cohere/Jina 리랭커, chunk overlap, MMR, 컨텍스트 윈도우 예산화를 통해 정확도를 체계적으로 복구하는 디버깅 체크리스트를 정리합니다.

OpenAI Responses API 호출 중 429 레이트리밋이 발생할 때, 헤더 기반 재시도·지수 백오프·지터·아이템포턴시를 조합해 안정적으로 복구하는 방법을 정리합니다.

SettingWithCopyWarning은 단순 경고가 아니라 ‘뷰(view)인지 복사(copy)인지’ 불명확한 상태에서 값이 기대대로 반영되지 않을 수 있음을 알려줍니다. 이 글은 경고를 숨기지 않고, 재현 가능한 방식으로 근본 원인을 제거하는 7가지 실전 패턴을 정리합니다.