API

Anthropic의 API 및 개발자 콘솔 전반의 업데이트를 따라가세요.

2025년 9월 10일

• 베타 버전으로 웹 페치 도구를 출시했습니다. Claude가 지정된 웹 페이지와 PDF 문서에서 전체 콘텐츠를 검색할 수 있습니다. 웹 페치 도구 문서에서 자세히 알아보세요.

2025년 9월 5일

• 콘솔 사용량 페이지에 속도 제한 차트를 출시했습니다. 시간에 따른 API 속도 제한 사용량과 캐싱 비율을 모니터링할 수 있습니다.

2025년 9월 3일

• 클라이언트 측 도구 결과에서 인용 가능한 문서 지원을 출시했습니다. 도구 사용 문서에서 자세히 알아보세요.

2025년 9월 2일

• 공개 베타로 코드 실행 도구 v2를 출시했습니다. 기존 Python 전용 도구를 Bash 명령 실행 및 직접 파일 조작 기능으로 교체했으며, 다른 언어로 코드 작성도 포함됩니다.

2025년 8월 27일

• PHP SDK의 베타 버전을 출시했습니다.

2025년 8월 26일

• Anthropic API에서 Claude Sonnet 4의 1M 토큰 컨텍스트 윈도우에 대한 속도 제한을 증가시켰습니다. 자세한 정보는 긴 컨텍스트 속도 제한을 참조하세요.
• 1m 토큰 컨텍스트 윈도우가 이제 Google Cloud의 Vertex AI에서 사용 가능합니다. 자세한 정보는 Vertex AI의 Claude를 참조하세요.

2025년 8월 19일

• 요청 ID가 이제 기존 request-id 헤더와 함께 오류 응답 본문에 직접 포함됩니다. 오류 문서에서 자세히 알아보세요.

2025년 8월 18일

• 관리자가 조직의 사용량 및 비용 데이터를 프로그래밍 방식으로 모니터링할 수 있는 사용량 및 비용 API를 출시했습니다.
• 조직 정보를 검색하기 위한 새로운 엔드포인트를 Admin API에 추가했습니다. 자세한 내용은 조직 정보 Admin API 참조를 참조하세요.

2025년 8월 13일

• Claude Sonnet 3.5 모델(claude-3-5-sonnet-20240620 및 claude-3-5-sonnet-20241022)의 사용 중단을 발표했습니다. 이 모델들은 2025년 10월 22일에 폐기될 예정입니다. 향상된 성능과 기능을 위해 Claude Sonnet 4(claude-sonnet-4-20250514)로 마이그레이션하는 것을 권장합니다. 모델 사용 중단 문서에서 자세히 읽어보세요.
• 프롬프트 캐싱의 1시간 캐시 지속 시간이 이제 일반적으로 사용 가능합니다. 베타 헤더 없이 확장된 캐시 TTL을 사용할 수 있습니다. 프롬프트 캐싱 문서에서 자세히 알아보세요.

2025년 8월 12일

• Anthropic API와 Amazon Bedrock에서 Claude Sonnet 4의 1M 토큰 컨텍스트 윈도우에 대한 베타 지원을 출시했습니다.

2025년 8월 11일

• 일부 고객은 API 사용량이 급격히 증가한 후 429(rate_limit_error) 오류를 경험할 수 있습니다. 이전에는 유사한 시나리오에서 529(overloaded_error) 오류가 발생했습니다.

2025년 8월 8일

• 검색 결과 콘텐츠 블록이 이제 Anthropic API와 Google Cloud의 Vertex AI에서 일반적으로 사용 가능합니다. 이 기능은 적절한 소스 속성을 가진 RAG 애플리케이션에 대한 자연스러운 인용을 가능하게 합니다. 베타 헤더 search-results-2025-06-09는 더 이상 필요하지 않습니다. 검색 결과 문서에서 자세히 알아보세요.

2025년 8월 5일

• 향상된 기능과 성능 개선을 가진 Claude Opus 4의 점진적 업데이트인 Claude Opus 4.1을 출시했습니다.^* 모델 및 가격 문서에서 자세히 알아보세요.

^{* - Opus 4.1은 temperature와 top_p 매개변수를 모두 지정하는 것을 허용하지 않습니다. 하나만 사용하세요.}

2025년 7월 28일

• 이전 버전의 일부 문제를 수정하고 대용량 파일을 볼 때 잘림 길이를 제어할 수 있는 선택적 max_characters 매개변수를 추가한 업데이트된 텍스트 편집기 도구 text_editor_20250728을 출시했습니다.

2025년 7월 24일

• Claude로 구축하고 확장할 수 있는 더 많은 용량을 제공하기 위해 Anthropic API에서 Claude Opus 4의 속도 제한을 증가시켰습니다. 사용량 등급 1-4 속도 제한을 가진 고객의 경우, 이러한 변경 사항이 계정에 즉시 적용됩니다 - 별도의 조치가 필요하지 않습니다.

2025년 7월 21일

• Claude 2.0, Claude 2.1, Claude Sonnet 3 모델을 폐기했습니다. 이러한 모델에 대한 모든 요청은 이제 오류를 반환합니다. 문서에서 자세히 읽어보세요.

2025년 7월 17일

• Claude로 구축하고 확장할 수 있는 더 많은 용량을 제공하기 위해 Anthropic API에서 Claude Sonnet 4의 속도 제한을 증가시켰습니다. 사용량 등급 1-4 속도 제한을 가진 고객의 경우, 이러한 변경 사항이 계정에 즉시 적용됩니다 - 별도의 조치가 필요하지 않습니다.

2025년 7월 3일

• RAG 애플리케이션에 대한 자연스러운 인용을 가능하게 하는 검색 결과 콘텐츠 블록을 베타로 출시했습니다. 도구는 이제 적절한 소스 속성을 가진 검색 결과를 반환할 수 있으며, Claude는 응답에서 이러한 소스를 자동으로 인용합니다 - 웹 검색의 인용 품질과 일치합니다. 이는 사용자 정의 지식 베이스 애플리케이션에서 문서 해결 방법의 필요성을 제거합니다. 검색 결과 문서에서 자세히 알아보세요. 이 기능을 활성화하려면 베타 헤더 search-results-2025-06-09를 사용하세요.

2025년 6월 30일

• Claude Opus 3 모델의 사용 중단을 발표했습니다. 문서에서 자세히 읽어보세요.

2025년 6월 23일

• 개발자 역할을 가진 콘솔 사용자는 이제 비용 페이지에 액세스할 수 있습니다. 이전에는 개발자 역할이 사용량 페이지에 대한 액세스를 허용했지만 비용 페이지는 허용하지 않았습니다.

2025년 6월 11일

• 버퍼링/JSON 검증 없이 Claude가 도구 사용 매개변수를 스트리밍할 수 있게 하는 기능인 세밀한 도구 스트리밍을 공개 베타로 출시했습니다. 세밀한 도구 스트리밍을 활성화하려면 베타 헤더 fine-grained-tool-streaming-2025-05-14를 사용하세요.

2025년 5월 22일

• 확장된 사고 기능을 가진 최신 모델인 Claude Opus 4와 Claude Sonnet 4를 출시했습니다. 모델 및 가격 문서에서 자세히 알아보세요.
• Claude 4 모델에서 확장된 사고의 기본 동작은 Claude의 전체 사고 과정의 요약을 반환하며, 전체 사고는 암호화되어 thinking 블록 출력의 signature 필드에 반환됩니다.
• Claude가 도구 호출 사이에 사고할 수 있게 하는 기능인 인터리브된 사고를 공개 베타로 출시했습니다. 인터리브된 사고를 활성화하려면 베타 헤더 interleaved-thinking-2025-05-14를 사용하세요.
• 파일을 업로드하고 Messages API 및 코드 실행 도구에서 참조할 수 있게 하는 Files API를 공개 베타로 출시했습니다.
• Claude가 안전하고 샌드박스된 환경에서 Python 코드를 실행할 수 있게 하는 도구인 코드 실행 도구를 공개 베타로 출시했습니다.
• Messages API에서 직접 원격 MCP 서버에 연결할 수 있게 하는 기능인 MCP 커넥터를 공개 베타로 출시했습니다.
• 답변 품질을 높이고 도구 오류를 줄이기 위해 Messages API에서 모든 모델에 대한 top_p nucleus sampling 매개변수의 기본값을 0.999에서 0.99로 변경했습니다. 이 변경을 되돌리려면 top_p를 0.999로 설정하세요. 또한 확장된 사고가 활성화된 경우 이제 top_p를 0.95와 1 사이의 값으로 설정할 수 있습니다.
• Go SDK를 베타에서 GA로 이동했습니다.
• 콘솔의 사용량 페이지에 분 및 시간 수준 세분성과 함께 사용량 페이지의 429 오류율을 포함했습니다.

2025년 5월 21일

• Ruby SDK를 베타에서 GA로 이동했습니다.

2025년 5월 7일

• Claude가 웹에서 최신 정보에 액세스할 수 있게 하는 웹 검색 도구를 API에서 출시했습니다. 웹 검색 도구 문서에서 자세히 알아보세요.

2025년 5월 1일

• 캐시 제어는 이제 tool_result 및 document.source의 부모 content 블록에서 직접 지정되어야 합니다. 역호환성을 위해 tool_result.content 또는 document.source.content의 마지막 블록에서 캐시 제어가 감지되면 대신 부모 블록에 자동으로 적용됩니다. tool_result.content 및 document.source.content 내의 다른 블록에서 캐시 제어는 검증 오류를 발생시킵니다.

2025년 4월 9일

• Ruby SDK의 베타 버전을 출시했습니다.

2025년 3월 31일

• Java SDK를 베타에서 GA로 이동했습니다.
• Go SDK를 알파에서 베타로 이동했습니다.

2025년 2월 27일

• Messages API에서 이미지와 PDF에 대한 URL 소스 블록을 추가했습니다. 이제 base64 인코딩 대신 URL을 통해 직접 이미지와 PDF를 참조할 수 있습니다. 비전 문서 및 PDF 지원 문서에서 자세히 알아보세요.
• Messages API의 tool_choice 매개변수에 Claude가 도구를 호출하지 않도록 하는 none 옵션에 대한 지원을 추가했습니다. 또한 tool_use 및 tool_result 블록을 포함할 때 더 이상 tools를 제공할 필요가 없습니다.
• 기존 OpenAI 통합에서 API 키, 기본 URL 및 모델 이름만 변경하여 Claude 모델을 테스트할 수 있게 하는 OpenAI 호환 API 엔드포인트를 출시했습니다. 이 호환성 계층은 핵심 채팅 완성 기능을 지원합니다. OpenAI SDK 호환성 문서에서 자세히 알아보세요.

2025년 2월 24일

• 지금까지 가장 지능적인 모델인 Claude Sonnet 3.7을 출시했습니다. Claude Sonnet 3.7은 거의 즉각적인 응답을 생성하거나 확장된 사고를 단계별로 보여줄 수 있습니다. 하나의 모델, 두 가지 사고 방식. 모델 및 가격 문서에서 모든 Claude 모델에 대해 자세히 알아보세요.
• Claude Haiku 3.5에 비전 지원을 추가하여 모델이 이미지를 분석하고 이해할 수 있게 했습니다.
• Claude와 도구를 사용할 때 전반적인 성능을 향상시키는 토큰 효율적인 도구 사용 구현을 출시했습니다. 도구 사용 문서에서 자세히 알아보세요.
• API의 기본 온도와 일관성을 위해 콘솔에서 새 프롬프트의 기본 온도를 0에서 1로 변경했습니다. 기존 저장된 프롬프트는 변경되지 않습니다.
• 텍스트 편집 및 bash 도구를 컴퓨터 사용 시스템 프롬프트에서 분리하는 업데이트된 버전의 도구를 출시했습니다:
  • bash_20250124: 이전 버전과 동일한 기능이지만 컴퓨터 사용과 독립적입니다. 베타 헤더가 필요하지 않습니다.
  • text_editor_20250124: 이전 버전과 동일한 기능이지만 컴퓨터 사용과 독립적입니다. 베타 헤더가 필요하지 않습니다.
  • computer_20250124: “hold_key”, “left_mouse_down”, “left_mouse_up”, “scroll”, “triple_click”, “wait”를 포함한 새로운 명령 옵션을 가진 업데이트된 컴퓨터 사용 도구입니다. 이 도구는 “computer-use-2025-01-24” anthropic-beta 헤더가 필요합니다. 도구 사용 문서에서 자세히 알아보세요.

2025년 2월 10일

• 모든 API 응답에 anthropic-organization-id 응답 헤더를 추가했습니다. 이 헤더는 요청에 사용된 API 키와 연결된 조직 ID를 제공합니다.

2025년 1월 31일

• Java SDK를 알파에서 베타로 이동했습니다.

2025년 1월 23일

• Claude가 정보에 대한 소스 속성을 제공할 수 있게 하는 API의 인용 기능을 출시했습니다. 인용 문서에서 자세히 알아보세요.
• Messages API에서 일반 텍스트 문서 및 사용자 정의 콘텐츠 문서에 대한 지원을 추가했습니다.

2025년 1월 21일

• Claude 2, Claude 2.1, Claude Sonnet 3 모델의 사용 중단을 발표했습니다. 문서에서 자세히 읽어보세요.

2025년 1월 15일

• 프롬프트 캐싱을 더 쉽게 사용할 수 있도록 업데이트했습니다. 이제 캐시 중단점을 설정하면 가장 긴 이전에 캐시된 접두사에서 자동으로 읽습니다.
• 도구를 사용할 때 이제 Claude의 입에 말을 넣을 수 있습니다.

2025년 1월 10일

• 캐시 적중률을 향상시키기 위해 Message Batches API에서 프롬프트 캐싱에 대한 지원을 최적화했습니다.

2024년 12월 19일

• Message Batches API에서 삭제 엔드포인트에 대한 지원을 추가했습니다.

2024년 12월 17일

다음 기능들이 이제 Anthropic API에서 일반적으로 사용 가능합니다:

• Models API: 사용 가능한 모델을 쿼리하고, 모델 ID를 검증하며, 모델 별칭을 정식 모델 ID로 해결합니다.
• Message Batches API: 표준 API 비용의 50%로 대량의 메시지 배치를 비동기적으로 처리합니다.
• 토큰 카운팅 API: Claude에게 보내기 전에 메시지의 토큰 수를 계산합니다.
• 프롬프트 캐싱: 프롬프트 콘텐츠를 캐싱하고 재사용하여 비용을 최대 90%, 지연 시간을 최대 80% 줄입니다.
• PDF 지원: PDF를 처리하여 문서 내의 텍스트와 시각적 콘텐츠를 모두 분석합니다.

또한 새로운 공식 SDK를 출시했습니다:

• Java SDK (알파)
• Go SDK (알파)

2024년 12월 4일

• 개발자 콘솔의 사용량 및 비용 페이지에 API 키별로 그룹화하는 기능을 추가했습니다.
• 개발자 콘솔의 API 키 페이지에 두 개의 새로운 마지막 사용 및 비용 열과 모든 열로 정렬하는 기능을 추가했습니다.

2024년 11월 21일

• 사용자가 조직의 리소스를 프로그래밍 방식으로 관리할 수 있게 하는 Admin API를 출시했습니다.

2024년 11월 20일

• Messages API의 속도 제한을 업데이트했습니다. 분당 토큰 속도 제한을 새로운 분당 입력 및 출력 토큰 속도 제한으로 교체했습니다. 문서에서 자세히 읽어보세요.
• 워크벤치에서 도구 사용에 대한 지원을 추가했습니다.

2024년 11월 13일

• 모든 Claude Sonnet 3.5 모델에 PDF 지원을 추가했습니다. 문서에서 자세히 읽어보세요.

2024년 11월 6일

• Claude 1 및 Instant 모델을 폐기했습니다. 문서에서 자세히 읽어보세요.

2024년 11월 4일

• Claude Haiku 3.5가 이제 Anthropic API에서 텍스트 전용 모델로 사용 가능합니다.

2024년 11월 1일

• 새로운 Claude Sonnet 3.5와 함께 사용할 PDF 지원을 추가했습니다. 문서에서 자세히 읽어보세요.
• Claude에게 보내기 전에 메시지의 총 토큰 수를 결정할 수 있게 하는 토큰 카운팅도 추가했습니다. 문서에서 자세히 읽어보세요.

2024년 10월 22일

• 새로운 Claude Sonnet 3.5와 함께 사용할 Anthropic 정의 컴퓨터 사용 도구를 API에 추가했습니다. 문서에서 자세히 읽어보세요.
• 지금까지 가장 지능적인 모델인 Claude Sonnet 3.5가 업그레이드되어 이제 Anthropic API에서 사용 가능합니다. 여기에서 자세히 읽어보세요.

2024년 10월 8일

• Message Batches API가 이제 베타로 사용 가능합니다. Anthropic API에서 대량의 쿼리 배치를 50% 적은 비용으로 비동기적으로 처리합니다. 문서에서 자세히 읽어보세요.
• Messages API에서 user/assistant 턴의 순서에 대한 제한을 완화했습니다. 연속된 user/assistant 메시지는 오류 대신 단일 메시지로 결합되며, 첫 번째 입력 메시지가 user 메시지일 필요가 없습니다.
• 표준 기능 세트(이전에 Build라고 불림)와 영업을 통해 사용 가능한 추가 기능을 위해 Build 및 Scale 플랜을 사용 중단했습니다. 여기에서 자세히 읽어보세요.

2024년 10월 3일

• API에서 병렬 도구 사용을 비활성화하는 기능을 추가했습니다. tool_choice 필드에서 disable_parallel_tool_use: true를 설정하여 Claude가 최대 하나의 도구를 사용하도록 합니다. 문서에서 자세히 읽어보세요.

2024년 9월 10일

• 개발자 콘솔에 워크스페이스를 추가했습니다. 워크스페이스를 사용하면 사용자 정의 지출 또는 속도 제한을 설정하고, API 키를 그룹화하고, 프로젝트별로 사용량을 추적하고, 사용자 역할로 액세스를 제어할 수 있습니다. 블로그 게시물에서 자세히 읽어보세요.

2024년 9월 4일

• Claude 1 모델의 사용 중단을 발표했습니다. 문서에서 자세히 읽어보세요.

2024년 8월 22일

• API 응답에서 CORS 헤더를 반환하여 브라우저에서 SDK 사용에 대한 지원을 추가했습니다. 이 기능을 활성화하려면 SDK 인스턴스화에서 dangerouslyAllowBrowser: true를 설정하세요.

2024년 8월 19일

• Claude Sonnet 3.5에 대해 8,192 토큰 출력을 베타에서 일반 사용 가능으로 이동했습니다.

2024년 8월 14일

• 프롬프트 캐싱이 이제 Anthropic API에서 베타 기능으로 사용 가능합니다. 프롬프트를 캐시하고 재사용하여 지연 시간을 최대 80%, 비용을 최대 90% 줄입니다.

2024년 7월 15일

• 새로운 anthropic-beta: max-tokens-3-5-sonnet-2024-07-15 헤더로 Claude Sonnet 3.5에서 최대 8,192 토큰 길이의 출력을 생성합니다.

2024년 7월 9일

• 개발자 콘솔에서 Claude를 사용하여 프롬프트에 대한 테스트 케이스를 자동으로 생성합니다.
• 개발자 콘솔의 새로운 출력 비교 모드에서 다른 프롬프트의 출력을 나란히 비교합니다.

2024년 6월 27일

• 개발자 콘솔의 새로운 사용량 및 비용 탭에서 달러 금액, 토큰 수, API 키별로 분류된 API 사용량 및 청구를 확인합니다.
• 개발자 콘솔의 새로운 속도 제한 탭에서 현재 API 속도 제한을 확인합니다.

2024년 6월 20일

• 지금까지 가장 지능적인 모델인 Claude Sonnet 3.5가 이제 Anthropic API, Amazon Bedrock, Google Vertex AI에서 일반적으로 사용 가능합니다.

2024년 5월 30일

• 도구 사용이 이제 Anthropic API, Amazon Bedrock, Google Vertex AI에서 일반적으로 사용 가능합니다.

2024년 5월 10일

• 프롬프트 생성기 도구가 이제 개발자 콘솔에서 사용 가능합니다. 프롬프트 생성기를 사용하면 Claude가 특정 작업에 맞춤화된 고품질 프롬프트를 쉽게 생성할 수 있습니다. 블로그 게시물에서 자세히 읽어보세요.