--- title: 버전 url: https://platform.claude.com/docs/ko/api/versioning description: "API 요청을 보낼 때는 `anthropic-version` 요청 헤더를 반드시 전송해야 합니다. 예를 들어 `anthropic-version: 2026-10-21`과 같습니다. [클라이언트 SDK](https://platform.claude.com/docs/ko/cli-sdks-libraries/overview)를 사용하는 경우 이는 자동으로 처리됩니다." --- 특정 API 버전에 대해 Anthropic은 다음을 유지합니다: * 기존 입력 매개변수 * 기존 출력 매개변수 그러나 Anthropic은 다음을 수행할 수 있습니다: * 추가적인 선택적 입력 추가 * 출력에 추가적인 값 추가 * 특정 오류 유형에 대한 조건 변경 * 열거형(enum)과 유사한 출력 값에 새로운 변형 추가(예: 스트리밍 이벤트 유형) 일반적으로 이 레퍼런스에 문서화된 대로 API를 사용하고 있다면, Anthropic은 여러분의 사용 방식을 깨뜨리지 않습니다. ## 버전 기록 Anthropic은 가능한 한 최신 API 버전을 사용할 것을 권장합니다. * `2026-10-21` * [API 버전 2026-10-21로 마이그레이션](https://platform.claude.com/docs/ko/api/migration-2026-10-21)에서 업그레이드 방법을 확인할 수 있습니다. * Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry](https://platform.claude.com/docs/ko/build-with-claude/claude-in-microsoft-foundry), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/google-managed)에서 사용할 수 있습니다. [Amazon Bedrock](https://platform.claude.com/docs/ko/build-with-claude/claude-in-amazon-bedrock)에서는 Claude 4.7 이후 모델에서 사용할 수 있습니다. Bedrock의 다른 모델에 대해서는 [API 버전 2026-10-21 마이그레이션 가이드](https://platform.claude.com/docs/ko/api/migration-2026-10-21#upgrade)를 참조하세요. * Messages API: * `assistant` 메시지에 `document` 블록을 직접 배치하는 요청은 400 오류를 반환합니다. * `user` 메시지에서 비어 있지 않은 `citations` 배열을 가진 `text` 블록을 직접 또는 `search_result` 블록 내부에 보내면 400 오류를 반환합니다. * `temperature`, `top_p`, `top_k` 요청 매개변수가 제거되었습니다. 이 중 하나라도 보내는 요청은 모든 모델에서 400 오류를 반환합니다. * Admin API: * [RBAC 그룹](https://platform.claude.com/docs/ko/api/beta/organization/rbac_groups/list)은 더 이상 `roles`를 반환하지 않습니다. 대신 `role_ids`를 사용하세요. * [RBAC 그룹 멤버](https://platform.claude.com/docs/ko/api/beta/organization/rbac_groups/members/list) 및 멤버 제거에 대한 응답은 더 이상 `group_id`를 반환하지 않습니다. 대신 `rbac_group_id`를 사용하세요. * [RBAC 역할](https://platform.claude.com/docs/ko/api/beta/organization/rbac_roles/list)은 더 이상 `name`을 반환하지 않습니다. 대신 `display_name`을 사용하세요. * [조직](https://platform.claude.com/docs/ko/api/organization/rate_limits/list) 및 [워크스페이스](https://platform.claude.com/docs/ko/api/organization/workspaces/rate_limits/list) 속도 제한 항목, 그리고 [워크스페이스의 속도 제한 설정](https://platform.claude.com/docs/ko/api/organization/workspaces/rate_limits/update)에 대한 응답은 더 이상 `group_type`을 반환하지 않습니다. 대신 `group.type`을 사용하세요. * [API 키](https://platform.claude.com/docs/ko/api/organization/api_keys/list)는 더 이상 `workspace_id`를 반환하지 않습니다. 대신 `scope.workspace_id`를 사용하세요. 이 값은 기본 워크스페이스의 경우에도 워크스페이스의 실제 ID를 제공합니다(모든 워크스페이스용 키는 `scope`에 `workspace_id`가 없습니다). * Claude Enterprise Analytics API: * 사용자별 [사용량](https://platform.claude.com/docs/ko/api/beta/organization/analytics/user_usage_report/list) 및 [비용](https://platform.claude.com/docs/ko/api/beta/organization/analytics/user_cost_report/list) 보고서에는 더 이상 `actor.email`이 없습니다. 대신 `actor.email_address`를 사용하세요. * [활동 요약](https://platform.claude.com/docs/ko/api/beta/organization/analytics/summaries/list) 응답에는 더 이상 `summaries`가 없습니다. 대신 `data`를 사용하세요. * `2023-06-01` * [스트리밍](https://platform.claude.com/docs/ko/build-with-claude/streaming) “server-sent events”(서버 전송 이벤트), 즉 SSE의 새로운 형식: * 완성(completion)이 증분 방식으로 제공됩니다. 예를 들어 `" Hello"`, `" Hello my"`, `" Hello my name"`, `" Hello my name is"`, `" Hello my name is Claude."` 대신 `" Hello"`, `" my"`, `" name"`, `" is"`, `" Claude." `와 같이 제공됩니다. * 모든 이벤트는 [데이터 전용 이벤트](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#data-only%5Fmessages)가 아닌 [명명된 이벤트](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#named%5Fevents)입니다. * 불필요한 `data: [DONE]` 이벤트를 제거했습니다. * 응답에서 레거시 `exception` 및 `truncated` 값을 제거했습니다. * `2023-01-01`: 최초 릴리스.