Claude 플랫폼 업데이트 로그 11월 2일: Messages API에 message threads(메시지 스레드)가 베타 형식으로 추가되었으며, message-threads-2026-08-12 베타 헤드가 필요합니다. 첫 번째 요청에서는 기존과 같이 전체 대화, system 및 tools를 전송하고 "thread": {"type": "create"}를 추가합니다. 이후 각 턴에서는 새 메시지와 이전 응답의 id("type": "continue")만 전송하며, 서버가 전체 대화를 재구성한 후 모델을 호출합니다. 스레드는 마지막 요청 후 5분 후 만료되며, 늦어도 1시간 내에 삭제됩니다. Claude API, AWS의 Claude Platform, Google Cloud의 Claude Models(Anthropic 관리) 및 Microsoft Foundry의 Claude에서 모두 사용할 수 있습니다.
신뢰도: 높음(80) · 이벤트 시간 2026-11-02
이유
- 스레드를 사용하지 않으면 매 턴마다 전체 대화를 다시 업로드해야 하며, API도 이를 다시 검증하고 토큰화해야 합니다. 수십에서 수백 번의 도구 호출이 발생하는 에이전트 루프의 경우 요청 본문이 점점 커지고 첫 토큰 지연 시간이 증가합니다. 공식 문서에 따르면 스레드를 사용하면 대부분의 작업이 새로운 한 턴에만 적용되므로 첫 토큰 지연 시간이 더 낮고 안정적입니다.
- 이는 프롬프트 캐시를 대체하지 않습니다: 캐시 지점은 여전히 개발자가 직접 설정해야 하며, 최상위 cache_control을 사용하여 매 턴 자동 캐싱을 활성화할 수 있습니다. 두 기능을 함께 사용해야 지연 시간과 비용을 동시에 절감할 수 있습니다.
사용법
- 요청 헤더에 anthropic-beta: message-threads-2026-08-12를 추가합니다. 첫 번째 턴에서는 thread: {type: "create"}를 추가하고, 이후에는 thread: {type: "continue", previous_message_id: \u003c이전 응답 id\u003e}를 사용하여 새 메시지 전송만 수행하며 system과 tools는 전송하지 않습니다(전송 시 400 오류 발생). 공식 SDK에는 thread 헬퍼 객체가 있어 베타 헤더와 404 이후의 재전송을 자동으로 처리합니다. 문서는 platform.claude.com/docs의 “Message threads” 페이지를 참조하세요.
리스크
- 스레드는 “최선의 노력(best-effort)” 방식으로 작동합니다: 만료, 백업 모델이 생성한 응답, 사용자 또는 작업 공간 변경 등의 상황에서 continue 요청은 404을 반환하므로, 전체 대화를 사용하여 다시 create해야 합니다. 따라서 애플리케이션은 여전히 모든 메시지를 자체적으로 저장하고 재전송 로직을 사전에 구현해야 합니다.
- model, thinking, tool_choice 등의 필드는 전체 스레드 동안 변경되어서는 안 되며, 변경 시 thread_fingerprint_mismatch 오류가 발생합니다. Opus 5.5 등의 모델에서 system 또는 tools를 변경하면 기존 thinking 블록이 무효화됩니다. 베타 단계에서는 동작이 변경될 수 있습니다.