진짜 응답 읽기: 블록과 멈춘 이유
왜 중요한가 이 모듈의 모든 버그는 같은 식으로 시작해요: reply["content"][0]["text"]를 읽고 그게 답이라고 여기는 코드. 현재 모델에서는 첫 블록이 아예 글이 아닌 경우가 많아요.
Claude Messages API의 응답은 dict예요. 답은 블록의 리스트인 content에 있고, 각 블록에는 type이 있어요:
"thinking": 모델이 답하기 전에 추론했어요. 현재 모델에서는 이 블록이 흔히 먼저 오고, 기본적으로 그thinking글은 비어 있어요(추론은 일어났지만 보이지 않아요)."text": 사용자를 위한 말. 글 블록이 여러 개일 수 있고, 답은 그 전부를 이은 거예요."tool_use": 모델이 도구를 실행해 달라고 해요(뒤의 레슨들).
콘텐츠 옆에는 모델이 왜 멈췄는지 말하는 stop_reason이 있어요: "end_turn"(끝냄), "max_tokens"(길이 한도에 닿아서, 답이 잘렸거나 아예 없을 수 있음), "tool_use"(도구 결과를 기다림), "refusal"(거절). "stop_sequence"와 "pause_turn" 같은 몇 가지가 더 있으니, "end_turn"이 아닌 건 모두 끝나지 않은 것으로 다루세요. 콘텐츠를 믿기 전에 늘 확인하세요.
{'id': 'msg_01',
'type': 'message',
'role': 'assistant',
'model': 'claude-opus-5-5',
'content': [{'type': 'thinking', 'thinking': '', 'signature': 'EuYBCkQYAiJA...'},
{'type': 'text',
'text': 'A context window is the amount of text a model can read at once.'}],
'stop_reason': 'end_turn',
'stop_sequence': None,
'usage': {'input_tokens': 412, 'output_tokens': 60}}
이 응답들에 대해: 시뮬레이션이에요. 각각은 Claude Messages API가 돌려주는 정확한 모양(콘텐츠 블록, stop_reason, usage)으로 이 강좌를 위해 썼고, 각각 실제 모델이 하는 무언가를 본떴어요. 살아 있는 모델의 녹화가 아니라서 정확한 문구는 우리가 쓴 것이지만, 모양과 문제는 내 코드가 만날 진짜예요.
다른 모든 블록 타입은 건너뛰고 글 블록을 전부 순서대로 이어 돌려주는(없으면 빈 문자열) reply_text(reply)를 쓰세요. stop_reason이 "end_turn"일 때만 True를 돌려주는 finished(reply)를 쓰세요. 시작 코드의 REPLIES는 그대로 두세요: 확인이 그것을 읽어요.
이 연습은 곧 열려요
앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.
이 브라우저가 learn.floati.life의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.