앤스로픽, 클로드 API 3년여 만의 새 버전 공개

앤스로픽이 클로드 API의 새 버전 2026-10-21을 공개했다. 앤스로픽의 개발자 공식 계정 클로드데브스(ClaudeDevs)는 10월 21일(미국 시간) X에 "클로드 API는 그동안 많이 발전했지만, 이번이 2023년 이후 첫 공식 버전 출시"라고 밝혔다. 개발자가 요청마다 anthropic-version 헤더에 적는 날짜를 바꾸는 3년여 만의 새 버전이다. 새 버전에서는 temperature, top_p, top_k 세 샘플링 파라미터가 빠졌고, 이 값을 보내는 요청은 기본값을 적었더라도 400 오류를 받는다.

버전을 내는 주기도 달라진다. 클로드데브스는 "새 모델이 요구하기 전에 개발자가 호환성을 깨는 변경을 미리 처리할 수 있도록 버전을 더 자주 내놓을 계획"이라고 설명했다. 기존 2023-06-01 버전은 폐기 대상이 아니다. 앤스로픽 버전 문서에 따르면 클로드 API는 2023-01-01 첫 출시 뒤 2023-06-01에 스트리밍 이벤트 형식을 바꾼 것이 마지막 버전 변경이었다. 메탈이 22일 오후 확인한 이 게시물은 조회 26만 회, 좋아요 3700여 개를 기록했다.

가장 큰 변화는 샘플링 파라미터 삭제다. 마이그레이션 가이드에 따르면 세 파라미터를 빼고 보낸 요청은 temperature 1.0을 포함한 기본값으로 샘플링한다. 2023-06-01에서 파라미터를 생략한 요청과 같은 동작이다. 클로드 4.7 이후 모델은 이미 기본값만 받고 있어 출력이 달라지지 않는다. 반면 클로드 Sonnet 4.6처럼 다른 값을 받는 모델에서 temperature를 낮춰 일관된 출력을 얻던 요청은 그 효과를 잃고, 이를 대신할 설정은 없다. 앤스로픽은 기본값이 아닌 값에 기대는 요청이라면 파라미터를 빼거나 그 요청만 2023-06-01에 남겨 두라고 안내했다.

메시지 API에는 두 가지 제약이 더 붙었다. 문서 블록을 어시스턴트 메시지에 직접 넣는 요청은 400 오류를 받으며, 문서는 사용자 메시지로 보내야 한다. 클로드가 돌려준 웹 페치 도구 결과처럼 다른 블록 안에 들어간 문서는 그대로 받는다. 사용자 메시지의 텍스트 블록에 비어 있지 않은 citations 배열을 담아 보내도 400 오류가 난다. 어시스턴트 메시지에 붙은 인용과 문서·검색 결과의 인용 활성화 설정은 유지된다. 이 변경은 메시지 API와 토큰 계산, 2026-10-21로 만든 메시지 배치의 각 요청에 모두 적용된다.

관리용 API는 필드 이름을 정리했다. 어드민 API에서 RBAC 그룹의 roles는 role_ids로, 그룹 멤버의 group_id는 rbac_group_id로, 역할의 name은 display_name으로, 요청 한도 항목의 group_type은 group.type으로 바뀌었다. 클로드 엔터프라이즈 애널리틱스 API에서는 actor.email이 actor.email_address로, 활동 요약의 summaries가 data로 이름을 바꿨다. API 키의 workspace_id는 아예 사라지고 scope가 들어선다. 2023-06-01에서는 기본 워크스페이스에 묶인 키도 workspace_id가 null이었지만, 새 버전의 scope.workspace_id는 기본 워크스페이스의 실제 ID를 돌려준다. 모든 워크스페이스에 쓰는 키는 scope 유형이 organization으로 표시된다.

새 버전은 클로드 API와 AWS 위의 클로드 플랫폼, 마이크로소프트 파운드리, 구글 클라우드에서 쓸 수 있다. 아마존 베드록에서는 클로드 4.7 이후 모델에만 적용된다. 앤스로픽은 같은 날 새 버전을 기본으로 보내는 SDK를 함께 냈다. 파이썬 SDK 2.0.0, 타입스크립트 SDK 1.0.0, C# SDK 13.0.0, Go SDK 2.0.0, 자바 SDK 3.0.0, PHP SDK 1.0.0, 루비 SDK 2.0.0과 ant CLI 2.0.0이다. 이전 SDK는 모든 요청에 2023-06-01을 실어 보냈다.

SDK 자체의 변경도 크다. 새 SDK와 CLI는 API 키를 X-Api-Key 헤더가 아니라 Authorization: Bearer 헤더로 보낸다. 클로드 API는 두 헤더를 모두 받기 때문에 API를 직접 부르는 프로그램은 고칠 것이 없지만, X-Api-Key를 읽거나 넣는 프록시와 게이트웨이는 손봐야 한다. 클라이언트 하나는 자격 증명 하나만 쥔다. API 키와 인증 토큰을 함께 넘기면 ValueError가 난다. CLI에서는 --api-key와 --auth-token 플래그가 삭제됐다. 명령줄에 적은 값이 셸 기록과 프로세스 목록에 그대로 보이기 때문이라고 회사는 설명했고, 두 플래그는 v1.27.0부터 사용 중단 경고를 띄워 왔다.

오래된 기능도 정리됐다. 레거시 텍스트 컴플리션 API는 타입스크립트, Go, 자바, 루비 SDK와 CLI에서 빠졌고 ant completions create 명령도 사라졌다. 타입스크립트와 루비 SDK의 툴 러너에서는 클라이언트 측 컴팩션이 없어지고 서버 측 컴팩션으로 대체됐으며, 자동 컴팩션 기준은 최소 5만 토큰이다. 모든 역할을 한 타입으로 다루던 MessageParam은 사용자, 어시스턴트, 시스템 메시지별 세 타입으로 나뉘었다. SDK와 CLI의 라이선스는 MIT에서 아파치 2.0으로 바뀌었고, 이전 버전은 MIT로 남는다.

메탈이 확인한 앤스로픽 버전 문서는 호환성 약속의 범위를 적어 두고 있다. 문서는 "레퍼런스대로 API를 쓰고 있다면 앤스로픽은 대체로 그 사용을 깨뜨리지 않는다"고 밝혔다. 한 버전 안에서 기존 입력·출력 파라미터는 보존하지만 선택 입력 추가, 출력 값 추가, 오류 조건 변경, 스트리밍 이벤트 같은 열거형 값 추가는 할 수 있다는 것이다. 마이그레이션 가이드는 버전 전환, 호환성 변경 반영, 2026-10-21 대상 테스트의 세 단계를 순서대로 밟으라고 권했다.

같은 날 릴리스 노트에는 사용자 프로필에 enforcement_status와 enforcement_actions 필드를 넣었다는 항목도 올라왔다. API를 재판매하거나 게이트웨이를 운영하는 기업이 자기 고객 가운데 앤스로픽이 제한하거나 차단한 대상을 확인할 수 있게 한 장치다. 하루 전인 20일에는 요청마다 최종 고객을 지정하는 사용자 프로필 기능이 나왔다. 메탈은 앤스로픽이 지난 14일 클로드 API에 OpenTelemetry 추적을 붙였다고 보도한 바 있다.

엔지니어 관점에서 이번 버전은 모델 교체와 인터페이스 변경을 떼어 놓는 장치다. 10월 출시된 Haiku 5.5는 샘플링 파라미터와 수동 확장 thinking을, 9월 출시된 Opus 5.5는 thinking 끄기와 수동 설정을 400 오류로 거절해, 새 모델로 바꾸는 순간 코드가 깨지는 일이 반복됐다. 버전 날짜가 정기적으로 바뀌면 팀은 모델보다 먼저 호환성 변경을 흡수하고, 필요한 요청만 옛 버전에 묶어 둘 수 있다. 출력의 일관성을 temperature로 조이던 손잡이는 사라지고, 사고의 깊이는 effort 같은 모델 쪽 설정으로 옮겨 갔다. 클로드 API를 쓰는 팀에게 버전 헤더는 이제 한 번 적고 잊는 상수가 아니라 관리해야 할 의존성이다.