Claude 메시지 스레드 공개 베타: 긴 에이전트 대화의 재전송과 복구

긴 대화를 이어가는 AI 에이전트는 매번 이전 메시지와 도구 실행 결과를 다시 보내야 한다. 대화가 길어질수록 요청도 커진다. Anthropic은 11월 2일 Messages API에서 대화 상태를 잠시 보관하고 새 메시지만 전송하는 메시지 스레드를 공개 베타로 발표했다.

새 메시지와 이전 응답 ID로 이어가기

공식 문서에 따르면 첫 요청에는 전체 대화와 시스템 지시, 도구 정의를 담고 thread에 type: create를 지정한다. 다음 요청에는 새 메시지와 직전 응답의 ID를 previous_message_id로 보낸다. 이어지는 요청에는 system과 tools를 다시 넣지 않는다. 모든 스레드 요청에 message-threads-2026-08-12 베타 헤더가 필요하다.

스레드는 순서대로만 이어진다. 하나의 응답 ID는 한 번만 이어 쓸 수 있으므로 가장 최근 응답 ID를 사용해야 한다. 이전 대화에서 다른 방향으로 갈라지거나 내용을 수정하려면 새 스레드를 시작해야 한다. 모델과 도구 선택 등 문서에 지정된 고정 필드도 생성 요청과 동일하게 유지해야 한다.

5분 만료에 대비해 원본 대화를 보관하자

서버의 스레드는 영구 저장소가 아니다. 마지막 요청 후 5분이 지나면 만료되고 마지막 사용 후 최대 1시간 이내에 삭제된다. 서버가 응답을 저장하지 못하는 등 다른 이유로도 이어가기 요청에 404가 나올 수 있다. 애플리케이션은 전체 메시지를 직접 보관해야 한다. 이어갈 수 없으면 전체 대화로 새 스레드를 만드는 복구 경로도 필요하다. SDK의 스레드 헬퍼는 문서에 명시된 일부 오류에서 재생을 돕지만, 헬퍼가 보유한 메시지는 프로세스 밖에 자동 저장되지 않는다.

스트리밍에서는 응답의 message_stop까지 받은 뒤 해당 ID로 이어가야 한다. 스레드를 목록 조회하거나 읽고 삭제하는 API는 제공되지 않는다. 배치 처리, 토큰 계산 요청, 온디맨드 압축 등 지원하지 않는 기능도 있으므로 기존 호출 경로에 그대로 적용하기 전에 문서의 제한을 확인해야 한다.

속도와 데이터 보관은 별도로 판단

Anthropic은 공식 발표에서 Claude Code의 50만~100만 토큰 요청을 대상으로 첫 토큰까지 걸리는 시간의 중앙값이 약 35% 줄었다고 밝혔다. 이는 회사가 제시한 특정 조건의 측정치이며 모든 앱에서 같은 개선을 보장하지 않는다. 요금과 속도 제한은 스레드를 사용해도 바뀌지 않는다.

대화 내용은 서버 관리 키로 암호화된 메모리에 보관되며 이 기능은 ZDR(무보관) 대상이 아니다. HIPAA 준비가 활성화된 조직에서는 사용할 수 없다고 문서는 설명한다. 민감한 데이터를 다루는 서비스라면 대화 보관 정책과 조직 설정을 먼저 검토하고, 지연 시간은 실제 요청 길이와 복구 빈도를 포함해 직접 측정하는 편이 좋다.