Claude API 2026-10-21 공개 — 새 SDK 기본 버전·호환성 변경 안내
2026년 10월 21일(UTC), ClaudeDevs 공식 계정이 Claude API 버전 2026-10-21을 발표했습니다. 공식 계정은 기존 2023-06-01 버전이 폐기된 것은 아니라고 안내했습니다.
새 주요 버전의 SDK와 ant CLI는 신규 API 버전을 기본으로 보냅니다. 대표적으로 Python SDK 2.0.0, TypeScript SDK 1.0.0, ant CLI 2.0.0이 해당합니다. SDK 자체에도 API 버전과 별개인 호환성 변경이 있어, 패키지만 먼저 올리기보다 연동 코드를 함께 점검해야 합니다.
새 API 버전의 Messages 요청에서는 temperature·top_p·top_k 매개변수가 제거됩니다. 이 값을 보내거나, assistant 메시지에 document 블록을 직접 넣거나, user 메시지의 text 블록에 비어 있지 않은 citations 배열을 넣으면 400 오류가 납니다. Admin·Enterprise Analytics 응답의 일부 필드 이름도 바뀝니다.
마이그레이션 안내에 따라 영향을 받는 코드를 고친 뒤 새 버전으로 테스트하는 것이 핵심입니다. Amazon Bedrock에서는 Claude 4.7 이상 모델에 새 버전이 제공되며, 이전 모델을 사용하는 경우 현재 SDK/API 버전을 유지하라는 안내가 있습니다.
댓글 0