‘이 모델은 assistant 메시지 프리필을 지원하지 않습니다’ — 어떤 Claude 모델이 프리필을 중단했으며 무엇으로 대체하는가

프리필을 거부하는 Claude 모델(2026년 9월 기준)

Anthropic의 오류 참조 문서는 명확합니다. Claude 4.6 이상 모델은 마지막 assistant 메시지의 프리필을 지원하지 않으며, 이를 수행하는 요청은 정확히 이 400 오류를 반환합니다(https://platform.claude.com/docs/en/api/errors#prefill-not-supported). 모델 이름으로는 Claude Opus 4.6 및 이후의 모든 Opus(Claude Opus 5.5 포함)(https://platform.claude.com/docs/en/models/opus-5-5/migration-guide), Claude Sonnet 4.6 및 Claude Sonnet 5(https://platform.claude.com/docs/en/models/sonnet-5/migration-guide), Claude Fable 5 및 Fable 5.1(https://platform.claude.com/docs/en/models/fable-5-1/migration-guide)이 해당합니다. Claude Haiku 4.5와 Claude Sonnet 4.5 및 Claude Opus 4.5는 여전히 프리필을 허용합니다. 따라서 이 오류는 코드 변경보다 모델 ID 변경과 함께 발생하는 경우가 많습니다. 대화 초반의 assistant 메시지와 few-shot 예시는 영향을 받지 않습니다.

user 턴으로 끝내기 — 한 줄 수정 포함

누군가 의도적으로 프리필을 작성한 경우가 아닌 경우가 많습니다. 스택의 어떤 요소가 마지막에 assistant 메시지를 배치한 것입니다. 공개 보고에 따르면 메시리를 추가하는 메모리 관리자(Strands issue #1694), 아직 끝나지 않았다고 잘못 판단한 턴 이후 다시 요청하는 에이전트 루프(opencode issue #46415), 연속 응답 및 에이전트 핸드오프(LiveKit issue #4907), 마지막에 남은 빈 assistant 메시지(AutoGen PR #7931)에서 발생합니다. 후행 메시지가 비어 있다면 삭제하세요 — 이것이 한 줄 수정입니다. 계속 이어가고 싶은 텍스트가 있다면 Anthropic의 마이그레이션 가이드가 안내하는 연속 방식대로, 답변이 중단된 위치를 인용한 연속 요청을 user 메시지에 넣으세요. 그대로 두어야 하는 문서화된 예외가 하나 있습니다. 웹 검색과 같은 서버 도구의 pause_turn은 일시 중지된 assistant 콘텐츠를 그대로 다시 보내 계속합니다(https://platform.claude.com/docs/en/agents-and-tools/tool-use/server-tools).

from openai import OpenAI

client = OpenAI(base_url="https://api.kunavo.com/v1", api_key="sk-kn-...")

def end_on_user(messages: list[dict]) -> list[dict]:
    """Claude 4.6 and later reject a conversation whose last turn is the assistant's."""
    last = messages[-1] if messages else None
    if not last or last["role"] != "assistant" or last.get("tool_calls"):
        return messages               # tool_calls are owed tool results instead
    content = last.get("content")
    if not content or (isinstance(content, str) and not content.strip()):
        return messages[:-1]          # the one line: drop an empty tail
    tail = content[-200:] if isinstance(content, str) else "..."
    return messages + [{
        "role": "user",
        "content": f"Your previous response was interrupted and ended with {tail!r}. "
                   "Continue from where you left off.",
    }]

messages = [
    {"role": "user", "content": "Explain HTTP caching in three bullets."},
    {"role": "assistant", "content": ""},  # the empty tail a framework left behind
]

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=end_on_user(messages),
)
print(resp.choices[0].message.content)

프리필이 수행하던 작업을 대체하기

Anthropic의 프롬프팅 가이드는 기존의 각 프리필 사용 사례를 대체 방식에 매핑합니다(https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#migrating-away-from-prefilled-responses). JSON 강제: 응답을 스키마에 제한하는 구조화된 출력은 Claude Haiku 4.5, Sonnet 4.5, Opus 4.5 및 이후 모든 모델에서 사용할 수 있습니다(https://platform.claude.com/docs/en/build-with-claude/structured-outputs). YAML 또는 다른 형식의 경우, 가이드에서는 구조를 요청하고 누락되면 재시도하라고 권장합니다. 분류: 유효한 라벨의 enum을 가진 도구 또는 구조화된 출력. 프리앰블 생략: “프리앰블 없이 직접 응답하세요”와 같은 시스템 프롬프트 지시문. 페르소나 유지: 시스템 프롬프트에서 역할을 설정하고(https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#give-claude-a-role), 프리필된 assistant 메시지 대신 user 턴에 주기적인 알림을 넣으세요. 중단된 답변: 위의 user 턴 연속 방식. 도구 호출 강제는 모든 곳에서 바로 대체할 수 있는 방법이 아닙니다 — Claude Fable 5.1 및 Claude Opus 5.5는 tool_choice any와 tool을 거부하며 자체적인 400 오류를 반환합니다(https://platform.claude.com/docs/en/api/errors#forced-tool-use-not-supported).

# Before: messages ended with {"role": "assistant", "content": "{"}
# Kunavo forwards output_config as sent; the reply is constrained to the schema.
curl https://api.kunavo.com/v1/messages \
  -H "x-api-key: sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Extract the name and email: John Smith <john@example.com>"}
    ],
    "output_config": {
      "format": {
        "type": "json_schema",
        "schema": {
          "type": "object",
          "properties": {
            "name": {"type": "string"},
            "email": {"type": "string"}
          },
          "required": ["name", "email"],
          "additionalProperties": false
        }
      }
    }
  }'

어떤 Claude 모델이 assistant 메시지 프리필을 지원하지 않나요?

2026년 9월 기준 Anthropic 문서에 따르면 4.6부터의 모든 Claude 모델입니다. Claude Opus 4.6 및 이후의 모든 Opus, Claude Sonnet 4.6 및 Sonnet 5, Claude Fable 5 및 5.1, Mythos 모델이 해당합니다. Claude Haiku 4.5, Sonnet 4.5 및 Opus 4.5는 여전히 프리필을 허용합니다.

프리필 없이 Claude의 JSON 출력을 강제하려면 어떻게 하나요?

구조화된 출력을 사용하세요. output_config.format에 JSON 스키마를 전달하면 응답이 해당 스키마로 제한됩니다. OpenAI 호환 엔드포인트를 통해서는 type json_schema인 response_format으로 보내세요. Kunavo가 이를 output_config.format으로 변환합니다. Anthropic은 어떤 경우에도 메시지 프리필이 JSON 출력과 호환되지 않는다고 명시합니다.

아무것도 프리필하지 않았는데 왜 이 오류가 발생하나요?

스택의 어떤 요소가 assistant 메시지를 마지막에 남긴 것입니다. 메모리 또는 세션 관리자, 턴 이후 다시 요청하는 에이전트 루프, 에이전트 핸드오프, 또는 아무도 제거하지 않은 빈 assistant 메시지일 수 있습니다. 전송되는 messages 배열을 있는 그대로 기록하세요. 마지막 요소의 role은 "assistant"일 것입니다.

대화에 assistant 메시지를 계속 포함할 수 있나요?

예. 최종 턴만 제한되며, few-shot 예시를 포함한 이전 assistant 메시지는 영향을 받지 않습니다.

OpenAI 호환 엔드포인트를 통해서도 왜 발생하나요?

게이트웨이가 사용자의 최종 role: "assistant" 메시지를 최종 Claude assistant 턴으로 전달하기 때문입니다. 형태만 바뀐 동일한 프리필입니다. Kunavo의 채팅 변환기가 정확히 그렇게 처리하며, 다른 OpenAI 호환 게이트웨이를 통해서도 동일한 메시지가 보고되었습니다(opencode issue #13768). 수정 방법도 같습니다. user 메시지로 끝내세요.