한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
모델·API · 판정 관망
그림을 글로 풀면
멈춤과 완료 구분
pause_turn은 서버 도구 반복 처리의 일시 중단이며 이어 요청해야 합니다.
- 대상
- Claude 서버 도구를 연결하는 개발자
- 무엇이 바뀜
- 응답 수신과 전체 처리 완료는 서로 다른 상태입니다.
- 왜 중요한가
- 중단된 내용을 최종 결과로 저장할 수 있습니다.
- 지금 할 일
- stop_reason을 확인하고 받은 내용을 보존해 이어 요청하세요.
- 한계·미확인
- 개념 비유. API 호출·재개·성능 시험 없음.
- 공식 출처
- platform.claude.com
- 확인일
- 2026-10-10
답변이 돌아와도 아직 읽을 책이 남은 상황
웹 검색 같은 서버 도구를 연결한 가상 조사 작업을 생각해 봅니다. 응답이 도착했지만 stop_reason이 pause_turn이라면 이를 완성된 보고서로 바로 저장하지 마세요. 그림에서 펼친 기록과 남은 책은 작업 문맥이 유지된 채 처리가 잠시 멈춘 상태를 나타냅니다. 일반적인 오류 응답이나 사용자 도구 실행 요청과도 구분해야 합니다.
받은 내용을 보존해 다음 요청에 연결하기
Anthropic 문서는 서버 도구 반복 처리가 요청별 반복 한도에 도달하면 pause_turn을 반환할 수 있다고 설명합니다. 계속 처리하려면 응답의 content를 assistant 메시지로 대화에 포함해 다음 API 요청으로 보냅니다. 텍스트만 추려 넣기보다 반환된 내용 전체를 유지하는 것이 공식 안내입니다. 자연스러운 종료를 나타내는 end_turn과는 처리 방식이 다릅니다.
모든 멈춤을 같은 재시도로 다루지 않기
클라이언트 도구를 실행해 달라는 tool_use라면 해당 도구의 결과를 보내야 하므로 pause_turn의 이어 요청과 혼동하지 마세요. AINOW는 중단 이유, 계속 처리 횟수와 최종 종료 상태를 따로 기록하고 애플리케이션의 재개 한도도 정하도록 제안합니다. 무한 반복을 뜻하는 안내가 아니며 이번 글에서 실제 API 재개나 보고서 완성도를 시험하지 않았습니다.
참고 원문: Anthropic 공식 문서 — Stop reasons and fallback · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-10
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- 2026-10-10 Messages API stop_reason의 pause_turn·end_turn·tool_use 구분 확인. 실제 API 호출·재개 시험 없음
- 확인일
- 2026-10-10
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. API 호출·재개·성능 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.