클로드 코드 /claude-api api-version으로 클로드 API 코드를 새 API 버전에 맞게 옮기는 법

클로드 코드(Claude Code) 2.1.307(10월 21일)에 /claude-api api-version이 추가됐다. 프로젝트의 클로드 API 코드를 새 API 버전에 맞게 고친 다음 요청이 그 버전을 쓰도록 바꿔 준다. 같은 날 앤트로픽이 API 버전 2026-10-21을 내놓았으니, 지금까지 2023-06-01로 요청하던 코드를 옮길 때 쓴다.

1. 클로드 코드 버전이 2.1.307 이상인지 확인한다.

claude --version

1. 프로젝트 폴더에서 클로드 코드를 열고 명령을 입력한다.

/claude-api api-version

1. 고친 내용을 마이그레이션 가이드의 호환이 깨지는 변경과 맞춰 본다. 2026-10-21에서는 아래 요청이 모두 400 오류를 낸다.

• temperature·top_p·top_k를 보내는 요청. 기본값을 보내도 오류라 세 값을 아예 뺀다. 클로드 4.7 이후 모델은 원래 기본값만 받아 결과가 그대로지만, 소네트 4.6처럼 다른 값을 받던 모델에서 temperature를 낮춰 쓰던 요청은 그 효과가 없어진다.
• assistant 메시지에 document 블록을 바로 넣는 요청. 문서는 user 메시지로 옮긴다.
• user 메시지의 text 블록에 비어 있지 않은 citations 배열을 넣는 요청.

1. SDK는 새 메이저 버전부터 2026-10-21을 기본으로 보낸다. 파이썬 anthropic 2.0.0, 타입스크립트 @anthropic-ai/sdk 1.0.0, Go 2.0.0, 자바 3.0.0, 루비 2.0.0, C# 13.0.0, PHP 1.0.0, ant CLI 2.0.0이다. SDK 없이 부른다면 헤더만 바꾼다.

-H "anthropic-version: 2026-10-21"

새 SDK에는 API 버전과 상관없는 변경도 있다. API 키를 X-Api-Key 대신 Authorization: Bearer로 보내니, X-Api-Key를 읽는 프록시나 게이트웨이를 쓴다면 함께 확인한다. 아마존 베드록에서는 2026-10-21이 클로드 4.7 이후 모델에서만 되므로 그보다 오래된 모델을 부르는 코드는 지금 SDK 버전에 둔다.