한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
업무·자동화 · 판정 관망
그림을 글로 풀면
수신과 완료 저장 구분하기
보고서가 도착해도 중단 이유와 필요한 내용부터 확인합니다.
- 대상
- Claude로 보고서를 만드는 자동화 담당자
- 무엇이 바뀜
- stop_reason은 응답 생성이 멈춘 이유를 알려 줍니다.
- 왜 중요한가
- 출력 한도로 끊긴 내용을 최종 보고서로 넘길 수 있습니다.
- 지금 할 일
- 중단 이유와 필수 항목을 대조한 뒤 완료 상태를 정합니다.
- 한계·미확인
- 개념 비유이며 API 호출·재개 시험은 하지 않았습니다.
- 공식 출처
- platform.claude.com
- 확인일
- 2026-09-19
문장이 있다는 사실과 끝까지 썼다는 판단 나누기
가상의 주간 보고서 자동화에서 앞부분이 자연스럽게 읽히면 파일을 바로 완료 폴더에 넣기 쉽습니다. Claude 공식 문서는 성공한 응답에도 생성 중단 이유인 stop_reason이 포함된다고 설명합니다. 이 글은 응답 본문을 받은 상태와 업무상 최종본으로 확정한 상태를 분리하는 자체 점검 방법을 제안합니다.
출력 한도에 닿았다면 미완성 표시부터 남기기
공식 문서에서 max_tokens는 요청에 지정한 출력 한도에 도달해 생성이 멈췄다는 뜻입니다. end_turn은 응답이 자연스럽게 끝났다는 뜻이며 보고서의 사실성이나 요구 충족을 보증하는 표시는 아닙니다. 잘린 응답에는 미완성 표시를 붙이고 출력 한도를 조정하거나 이어 생성하는 방법을 검토하되, 구체적인 재개 방식은 현재 모델과 요청 구조에 맞춰 확인해야 합니다.
후속 작업이 볼 상태를 명시하기
작업 기록에 중단 이유, 필수 항목 누락 여부, 최종본 확정 여부를 따로 두는 설계를 제안합니다. 예를 들어 결론 항목이 빠졌다면 자연 종료 응답이라도 검토 대상으로 남기는 방식입니다. 이 글은 두 중단 이유를 중심으로 설명하며 모든 도구 호출·거절·오류 분기를 구현한 예제는 아닙니다. 호출, 재시도 및 보고서 품질 시험은 수행하지 않았습니다.
참고 원문: Anthropic Claude 응답 중단 이유 공식 문서 · 원문 게시일 상시 문서(게시일 별도 미표기) · 확인일 2026-09-19
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- Messages API stop_reason 상시 문서·2026-09-19 확인; 특정 모델 호출·중단 재현 시험 없음
- 확인일
- 2026-09-19
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유이며 API 호출·재개 시험은 하지 않았습니다.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.