[늦게 확인] Claude API 2026-10-21: 3년 만의 새 API 버전과 SDK 메이저 업데이트, 샘플링 파라미터 제거
무엇인가요
Anthropic이 2023-06-01 이후 처음으로 Claude API 새 버전 2026-10-21을 냈어요. 이 버전에서는 temperature·top_p·top_k를 보내면 기본값이어도 400 오류가 나고 assistant 메시지 안의 document 블록과 user 메시지의 인용(citations)도 오류가 나요. 이 버전을 기본으로 보내는 SDK 메이저 버전(Python 2.0.0, TypeScript 1.0.0, Go 2.0.0, Java 3.0.0 등)과 ant CLI 2.0.0도 함께 나왔어요.
pip install -U "anthropic>=2.0.0"왜 중요한가요
SDK만 올려도 API 버전이 바뀌니 의존성 자동 업데이트를 켜 둔 팀은 바로 영향을 받아요. 샘플링 파라미터로 출력을 고정하던 코드, X-Api-Key 헤더를 읽는 프록시, Admin API 필드 이름을 쓰는 스크립트는 고쳐야 해요. SDK 라이선스도 MIT에서 Apache 2.0으로 바뀌었어요. Amazon Bedrock에서는 Claude 4.7 이후 모델에서만 새 버전을 쓸 수 있어요.
완성도
GA 정식정식 배포된 API 버전과 SDK예요. 예전 버전 2023-06-01도 계속 쓸 수 있어서 서둘러 옮기지 않아도 돼요.
앞으로 이렇게 지켜보세요
- SDK 후속: Python·TypeScript SDK 2.x/1.x 마이너 릴리스에서 추가 호환성 수정이 나오는지 GitHub 릴리스를 봐요.
- 지원 범위: Amazon Bedrock·Google Cloud 클라이언트의 새 버전 지원 범위가 넓어지는지 마이그레이션 가이드를 확인해요.
- 예전 버전: 2023-06-01 버전의 지원 종료 일정이 나오는지 릴리스 노트를 지켜봐요.