---
title: Claude Fable 5.2 프롬프팅
url: https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2
description: "Claude Fable 5.2 및 Claude Mythos 5.2에 특화된 프롬프팅 패턴: effort, 조기 중단, 승인, 코드 소유권, 진행 상황 업데이트, 서브에이전트, 누적되는 신중함, 이전 모델용으로 작성된 지침, 최종 보고서, 거부."
---

이 가이드는 Claude Fable 5.2에 특화된 프롬프팅 패턴을 다룹니다. 모델의 기능과 API 변경 사항은 [Claude Fable 5.2의 새로운 기능](https://platform.claude.com/docs/ko/models/fable-5-2/whats-new-fable-5-2)을 참조하세요. 현재의 모든 Claude 모델에 적용되는 기법은 [프롬프팅 모범 사례](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/claude-prompting-best-practices)를 참조하세요.

Claude Fable 5.2는 몇 가지 면에서 이전 모델과 다르게 동작합니다. 관찰한 현상에 해당하는 섹션부터 시작하세요:

* 어떤 노력 수준으로 실행할지 확실하지 않거나, 쉬운 요청에 시간이 너무 오래 걸리는 경우: [effort 보정하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#calibrate-effort)
* 작업이 끝나기 전에 턴이 종료되는 경우: [전체 작업 완료하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#finish-the-whole-task)
* 에이전트가 작업하는 동안 단계를 승인하거나, 시스템 프롬프트에 승인 규칙이 있는 경우: [승인](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#approvals)
* 코딩 에이전트가 기존 코드를 병합하는 대신 반복하거나, 주변 문제를 수정하지 않고 보고만 하는 경우: [코드의 소유자를 밝히기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#say-who-owns-the-code)
* 긴 에이전트 턴 동안 아무 말이 없는 것처럼 보이는 경우: [긴 턴 동안 사용자에게 진행 상황 알리기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#keep-users-informed-during-long-turns)
* 에이전트 세션이 작업에 필요한 것보다 더 많은 서브에이전트를 시작하는 경우: [서브에이전트에 대한 기대치 설정하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#set-expectations-for-subagents)
* 에이전트가 필요 없는 승인을 요청하거나, 일상적인 작업을 보류하는 경우: [신중함이 누적되지 않도록 하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#keep-caution-from-piling-up)
* Claude Fable 5.1 또는 Claude Opus 5.5용으로 작성된 시스템 프롬프트, 스킬 또는 하네스를 그대로 가져오는 경우: [이전 모델용으로 작성된 지침 검토하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)
* 사용자가 긴 작업 후 최종 보고서나 인계 문서를 읽는 경우: [보고서를 이해하기 쉽게 만들기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#make-reports-easy-to-follow)
* 요청이 `stop_reason: "refusal"`을 반환하는 경우: [안전장치에 의한 거부](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#safeguard-refusals)

<Note>
  이전 모델에서 마이그레이션할 때의 API 변경 사항은 [Claude Fable 5.2 및 Claude Mythos 5.2 마이그레이션 가이드](https://platform.claude.com/docs/ko/models/fable-5-2/migration-guide)를 참조하세요. 마이그레이션할 때 이 지침을 적용하는 순서는 [시작할 곳](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#where-to-start)을 참조하세요.

  이 페이지의 여러 섹션에서는 시스템 프롬프트에 추가할 텍스트, 시스템 프롬프트나 에이전트가 지니는 메모 및 규칙에서 제거할 줄, 또는 도구 설명의 변경 사항을 제안합니다. 이러한 변경은 새 대화에서만 적용하세요. Claude Fable 5.2에서는 API가 모든 계정에 대해 [접두사 검사](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#prefix-check)를 적용합니다. `system`, `tools` 또는 이전 메시지가 변경된 후 사고 블록을 다시 보내는 요청은 400 오류를 반환할 수 있으므로, 저장된 대화를 새 텍스트로 재개하면 실패할 수 있습니다. 대화 도중에 지침을 변경하려면 [가장 최근 턴에 넣으세요](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#changing-context). [대화 중 시스템 메시지](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages)를 사용할 수 있는 경우에는 대신 [대화에 시스템 메시지를 추가](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#new-instructions)할 수 있습니다.
</Note>

## effort 보정하기

Claude API의 기본값인 `high`에서 시작하세요. 사용 사례에 필요하다면 effort를 올리거나 내리고, 각 변경 사항을 자체 평가(eval)로 테스트하세요. [effort](https://platform.claude.com/docs/ko/build-with-claude/effort) 수준은 Claude Fable 5.2가 얼마나 많이 사고하는지, 턴이 얼마나 오래 걸리는지, 그리고 얼마나 많은 토큰을 사용하는지를 결정합니다. 이 수준은 모델이 사고하는 방식과 도구 호출 횟수도 바꾸므로, effort는 프롬프트와 함께 조정하세요.

일반적으로 노력 수준은 Claude 모델 전반에서 같은 순서로 작동하지만, 각 수준에서 이루어지는 사고의 양은 모델마다 다를 수 있습니다. 따라서 Claude Fable 5.1이나 Claude Opus 5.5에서 조정한 설정을 그대로 가져오지 말고 effort 스윕을 다시 실행하세요.

작업 유형에 따라 수준을 선택하세요:

* `low`는 빠른 주고받기, 명확하게 정의된 작업, 그리고 빠르고 지능적인 서브에이전트와 같은 대량 워크로드에 적합합니다. Anthropic의 테스트에서 `low`에서의 모델 점수는 더 높은 노력 수준에서의 Claude Fable 5.1 점수에 근접했습니다.
* `medium`은 대화형 코딩, 채팅, 일상적인 지식 작업에 적합합니다.
* `high`는 어려운 코딩, 연구, 에이전트 작업, 그리고 장시간 무인 실행에 적합합니다. 턴이 완료되기까지 `medium`보다 눈에 띄게 오래 걸립니다.
* `xhigh`는 가장 어려운 장기 실행 코딩 및 에이전트 작업 중 개선 효과를 측정한 경우를 위한 것입니다. Anthropic의 내부 코딩 평가에서 점수를 약간 높였고 훨씬 더 많은 토큰을 사용했습니다.
* `max`는 모델의 한계를 측정하거나, 시간과 토큰이 중요하지 않은 드문 작업을 위한 것입니다. 과학적 발견이나 수학과 같은 개방형 문제에 가장 적합합니다. 턴이 느리고 `xhigh`보다 훨씬 더 많은 토큰을 사용합니다.

능력 향상의 대부분은 이미 `high`에서 나타납니다. `medium`에서 `high`로의 단계는 Anthropic이 추적하는 대부분의 코딩 및 지식 작업 평가에서 점수를 높였습니다. 이 단계는 더 많은 토큰과 시간도 사용하므로, 평가에서 품질이 유지되는 경우에는 `medium`으로 낮추세요. `high` 이상에서는 향상이 고르지 않으며 작업에 따라 달라집니다.

수준을 선택할 때는 세 가지 동작에 유의하세요:

* 낮은 노력 수준에서는 모델이 조기에 중단할 가능성이 더 높습니다. `low` 또는 `medium`에서의 에이전트 작업에는 [전체 작업 완료하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#finish-the-whole-task)의 텍스트를 추가하세요.
* `high` 이상에서는 모델이 인사에 대한 답변을 포함해 거의 모든 답변 전에 사고합니다. 쉬운 요청에 시간이 너무 오래 걸리거나 비용이 너무 많이 든다면 해당 턴에는 더 낮은 노력 수준을 사용하세요. Anthropic의 테스트에서 숙고하지 말고 바로 답하라는 지침은 `medium` 이상에서 모델의 사고를 막지 못했습니다.
* effort는 모델 답변의 길이를 거의 바꾸지 않습니다. 답변의 길이와 어조를 바꾸려면 프롬프트를 사용하세요.

하나의 워크플로 안에서 여러 수준을 섞어 쓸 수도 있습니다. 예를 들어 모델과 함께 `medium`에서 계획하고 반복한 다음, 길고 무인으로 진행되는 부분에서 effort를 높일 수 있습니다. 대화 중에 수준을 바꾸면서 프롬프트 캐시를 유지하려면 [메시지별 effort 변경](https://platform.claude.com/docs/ko/build-with-claude/effort#change-effort-mid-conversation-beta)(베타, `mid-conversation-output-config-2026-07-01` 헤더)을 사용하세요. 해당 섹션에 이 기능을 사용할 수 있는 플랫폼이 나열되어 있습니다. 변경 사항은 다른 변경으로 대체될 때까지 유지됩니다. 메시지별 effort를 사용할 수 없는 경우에는 다음 요청에서 새로운 최상위 `effort` 값을 설정하세요. 이렇게 하면 캐시가 처음부터 다시 시작됩니다.

## 전체 작업 완료하기

길고 여러 단계로 이루어진 작업에서 Claude Fable 5.2는 때때로 작업이 끝나기 전에 턴을 종료합니다. 턴은 남은 작업 목록, 계속하겠다는 제안, 또는 타임아웃과 같은 일반적인 장애물에서의 중단으로 끝납니다. 이는 `low` 및 `medium` effort에서 더 자주 발생합니다.

에이전트에서 이러한 중단이 보이면 시스템 프롬프트에 다음과 같은 텍스트를 추가하세요:

```text wrap
# Finishing work
Please avoid stopping while you still owe work the user asked for. Be persistent and do not stop unless needed.

While status notes are welcome, as is clarifying with the user on open decisions, carry on with work that does not depend on the user's answer without unnecessary stops.

If you notice yourself inviting the user to redirect you or offering to wait, instead proceed on the next part of the task. You may meet ordinary obstacles like errors, timeouts, locked files, empty results or failing tools. Diagnose them first, and when they are not real blockers, work through them with the access you have (wait and retry, fix the request, use another tool or source) rather than stopping unnecessarily.

If someone clearly decided something is a hard blocker, such as a file marked not to be touched, access that was intentionally withheld, or a safety guardrail, leave it alone, say plainly what you found, and look for another safe way to finish the task. Stopping before the task is complete is very rarely merited, as in when the task can't move forward without user input, or where the blocker is deliberate and should not be worked past. This does not override the need for confirmation on risky or destructive actions.
```

이 텍스트는 두 종류의 장애물을 구분합니다. 오류, 타임아웃, 실패하는 도구와 같은 일반적인 장애물은 진단하고 해결해 나가도록 모델에 지시합니다. 건드리지 말라고 표시된 파일과 같은 의도적인 차단 요소는 그대로 두고 보고하도록 지시합니다. 이 텍스트를 출발점으로 삼고, 애플리케이션에 맞게 수정할 때도 그 구분을 유지하세요.

Anthropic은 에이전트 코딩 제품에서 기록된 세션을 `medium` effort로 재실행했습니다. 이 텍스트의 한 버전을 사용하자, 처리 가능한 작업이 남은 채로 끝난 세션이 약 절반으로 줄었습니다. 이 텍스트는 허락을 구하거나 계속하겠다고 제안하는 종료 대부분을 없앴지만, 남은 작업을 나열한 뒤 중단하는 종료는 없애지 못했습니다. 출력 토큰은 약 30퍼센트 증가했습니다.

이 텍스트를 사용하면 모델이 묻는 빈도가 줄어들므로, 위험하거나 되돌릴 수 없는 작업에 대해서는 자체 확인 단계를 유지하세요.

### 승인

모델에 계속 진행하라고 할 때는 단순히 "계속"이라고 보내는 대신 원하는 것을 명확하게 말하세요. 예를 들어 "진행"이나 엄지척을 보냈을 상황에서 "네, 스테이징 데이터베이스에서 마이그레이션을 실행하세요"라고 답하세요.

시스템 프롬프트에 승인 규칙이 있다면, 모델은 규칙을 작성된 그대로 적용하므로 규칙이 적용되는 작업을 정확하게 명시하세요. 승인할 사람이 없는 시뮬레이션 작업에 대한 Anthropic의 테스트에서, 한 규칙은 승인이 필요한 단계 중 하나로 "이 대화 외부의 사람에게 메시지 보내기"를 나열했습니다. 이 규칙이 있을 때 모델은 동료와 다른 팀에 보내는 일상적인 요청의 약 절반을 보류했습니다.

## 코드의 소유자를 밝히기

Claude Fable 5.2는 작업하는 코드의 소유자가 누구인지에 대해 프롬프트가 말하는 내용에 민감하게 반응합니다. 소규모 코딩 작업에 대한 Anthropic의 테스트에서, 프롬프트가 소유권에 대해 아무 말도 하지 않거나 코드베이스를 다른 사람의 것으로 제시했을 때, 모델은 기존 코드를 반복하게 되더라도 기존 구조에 덧붙이는 경향이 있었습니다. 또한 주변 문제를 수정하는 대신 보고하는 경향이 있었습니다. 프롬프트에서 코드베이스가 모델 자신의 것이라고 말하면, 모델은 요청받지 않아도 반복된 코드를 병합하고 관련 수정을 하는 경우가 많습니다.

모델이 작업하면서 구조를 개선하기를 원한다면, 코드가 모델 자신의 것이라고 말하세요:

```text wrap
This codebase is yours: what it's for and how it's built are your call, and you'll keep building on it.
```

소규모 코딩 작업에 대한 Anthropic의 테스트에서, 모델은 이 문장이 있을 때 시도의 약 절반에서, 없을 때는 10분의 1 미만에서 반복된 코드를 병합했습니다. 비율은 작업에 따라 달랐습니다. 이 결과는 문장이 긴 시스템 프롬프트 안에 있을 때도 유지되었습니다. 요청된 기능은 어느 쪽이든 거의 모든 시도에서 작동했습니다.

같은 테스트에서 모델은 이 문장이 있을 때 출력 토큰을 약 1.5배 사용했고, 아무도 요청하지 않은 여러 변경을 했으며, 그중 다수는 새 테스트와 문서였습니다. 버그 수정을 제외하면, 6\~10번의 시도 중 한 번꼴로 기존 기능의 동작 방식을 바꾸었고, effort가 높을수록 더 자주 그랬습니다. 마지막 요약에는 큰 변경 사항은 언급되었지만 작은 변경은 자주 빠졌으므로, 요약만이 아니라 diff도 검토하세요.

사용자가 코드를 소유하고 변경을 최소화하기를 원하는 경우에는 소유권 문장을 빼세요. 프롬프트의 다른 곳에 있는 범위 제한 규칙은 소유권 문장을 상쇄하지 않습니다. Anthropic의 테스트에서 같은 프롬프트 앞부분에 “No drive-by refactors, renames or cleanups”가 있었는데도, 모델은 여전히 시도의 약 3분의 1에서 반복된 코드를 병합했습니다.

## 긴 턴 동안 사용자에게 진행 상황 알리기

Claude Fable 5.2는 긴 도구 호출 실행 동안 사용자에게 보이는 텍스트를 거의 작성하지 않는 경우가 있습니다. 또한 무엇을 하려는지 말하지 않고 첫 번째 도구 호출을 할 수도 있습니다.

먼저 클라이언트가 모델의 업데이트를 받고 있는지 확인하세요. Claude Fable 5.2에서는 모델이 도구 호출 사이에 작성하는 업데이트가 [진행 상황 업데이트 `thinking` 블록](https://platform.claude.com/docs/ko/build-with-claude/thinking#progress-updates)으로 반환됩니다. 이러한 업데이트는 모델이 발견한 내용과 다음에 할 일을 알려 줍니다. 기본 `thinking.display` 값인 `"omitted"`에서는 그 텍스트가 비어 있습니다. 따라서 `text` 블록만 렌더링하는 클라이언트는 긴 에이전트 턴 동안 아무 말이 없는 것처럼 보일 수 있습니다. 각 업데이트의 짧은 요약을 받으려면 `display: "updates"`(베타, `thinking-display-updates-2026-08-18` 헤더)를 설정하고, 업데이트와 함께 요약된 추론을 받으려면 `"summarized"`를 설정하세요. 그런 다음 도구 호출 사이의 비어 있지 않은 `thinking` 블록을 렌더링하세요.

잦은 업데이트는 대화형 코딩처럼 사용자가 작업을 실시간으로 지켜볼 때 가장 중요합니다. 사용자가 작업을 지켜보는데도 업데이트가 너무 적다면, 다음 옵션 중 하나 이상을 사용하세요.

하네스를 변경할 수 있다면, 효과적인 옵션은 하네스가 사용자에게 읽을거리를 제공하지 않는, 즉 `text` 블록도 없고 텍스트가 있는 `thinking` 블록도 없는 연속된 도구 호출 단계 수를 세도록 하는 것입니다. `"omitted"`에서는 모든 `thinking` 블록이 비어 있으므로, `display`를 `"updates"` 또는 `"summarized"`로 설정한 상태에서 세세요. 이 옵션은 플랫폼이 [대화 중 시스템 메시지](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages)를 지원하는 경우에 작동합니다. 이러한 단계가 연속으로 여러 번 발생하면, 하네스가 최신 도구 결과 뒤에 다음 알림을 [턴 범위 시스템 메시지](https://platform.claude.com/docs/ko/build-with-claude/mid-conversation-system-messages#turn-scoped-system-messages)(`clear_at: "next_user_message"`, 베타, `mid-conversation-system-clear-at-2026-08-21` 헤더)로 추가하도록 하세요:

```text wrap
The user hasn't heard from you in a while: say in a few words what you're doing, then continue.
```

멀티턴 코딩 작업에 대한 Anthropic의 테스트에서, 이 알림은 가장 긴 침묵 구간을 대략 절반으로 줄였으며, 토큰이나 시간의 눈에 띄는 증가는 없었습니다.

각 알림은 이후 요청에서도 `messages`에 그대로 두세요. 알림을 제거하거나 문구를 바꾸면 이전 턴을 편집하게 되어, 그 뒤의 사고 블록이 무효화됩니다. [턴별 리마인더를 턴 범위 시스템 메시지로 보내기](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#per-turn-reminders)를 참조하세요.

첫 번째 도구 호출 전의 시작 문장, 간단한 업데이트, 그리고 마무리 요약도 받으려면 시스템 프롬프트에 다음 텍스트를 추가하세요:

```text wrap
Before you start, say in a line what you're about to do; brief updates while you work help the user follow along. Close with a short recap that stands on its own (what you found, what you did, and what's next), so a reader who only sees the last message has the full picture.
```

코딩 작업에 대한 Anthropic의 테스트에서, 이 텍스트가 있을 때 모델은 매번 첫 번째 도구 호출 전에 말을 했습니다. 이 텍스트는 작업당 출력 토큰도 대략 20퍼센트 늘렸습니다. 사람이 직접 루프에 참여하는 경우에 이 텍스트를 사용하세요. 가장 많은 업데이트를 받으려면 하네스가 추가하는 알림과 함께 사용하세요.

하네스를 변경할 수 없거나 플랫폼에 대화 중 시스템 메시지가 없다면, 시스템 프롬프트에 다음 문장을 추가하세요:

```text wrap
Every few tool calls, give the user a one-line update on where things stand.
```

워크플로 자동화 작업에 대한 Anthropic의 테스트에서, 이 문장은 긴 침묵 구간의 대부분을 없앴습니다.

알림과 시작 및 요약 텍스트를 함께 사용하더라도, 업데이트 사이에 여러 번의 도구 호출이 이어질 수 있다고 예상하세요. Claude Fable 5.2는 사용자가 각 단계를 지켜보는 대신 결과를 확인하러 돌아오는 장기 실행 비동기 작업에서 잘 작동합니다. 그런 경우에는 업데이트 사이의 공백이 덜 중요합니다.

## 서브에이전트에 대한 기대치 설정하기

Claude Fable 5.2가 서브에이전트에 얼마나 많은 작업을 위임하는지는 하네스와 작업에 따라 달라집니다. 서브에이전트를 시작하는 최소한의 도구를 사용한 짧은 작업에 대한 Anthropic의 테스트에서는 서브에이전트를 거의 시작하지 않았습니다. 프롬프트가 위임을 권장하는 에이전트 코딩 제품에서는 쉽게 위임합니다.

시스템 프롬프트, 스킬 또는 에이전트 파일이 모델에 위임하라고 지시한다면, 먼저 해당 줄을 검토하세요. Claude Fable 5.2가 여전히 작업에 필요한 것보다 더 많은 서브에이전트를 시작하는 경우에만 서브에이전트를 시작하는 도구의 설명을 변경하세요. 도구에 평범한 설명이 있고 프롬프트의 다른 어떤 부분도 위임을 요청하지 않는다면, 새 설명은 필요하지 않을 가능성이 높습니다.

새 설명에서는 서브에이전트가 세션 비용에 무엇을 더하는지 명시하고, 위임이 가치 있는 경우와 그렇지 않은 경우를 말하며, 시작하는 서브에이전트에게 어떻게 브리핑할지 모델에 알려 주세요. Anthropic이 테스트한 설명은 이 세 가지를 수행하며 비용을 가장 먼저 다룹니다. 이런 종류의 설명은 하네스가 이미 위임을 권장하고 서브에이전트가 토큰 사용량의 큰 비중을 차지할 때 가장 유용합니다.

짧은 작업에 대한 Anthropic의 테스트에서, 테스트한 설명을 사용했을 때 모델은 주로 위임할 이유를 나열한 설명에 비해 약 3분의 1 적게 위임했습니다. 작업 성공률은 같았습니다.

테스트한 설명에서는 비용에 관한 첫 문장들이 위임을 억제합니다. 모델이 너무 적게 위임한다면 비용에 대해 덜 말하세요. 여전히 너무 많이 위임한다면 하네스에서 서브에이전트에 드는 비용에 대해 더 말하고, 변경 사항을 테스트하세요.

Anthropic은 또한 에이전트 코딩 제품에서 `xhigh` 및 `max`와 같은 더 높은 노력 수준일 때 Claude Fable 5.2가 서브에이전트를 사용해 자신의 작업을 검토하는 것을 관찰했습니다. Claude Fable 5.1은 같은 작업에서 이렇게 하지 않았습니다. 초기 테스터들은 Claude Fable 5.2를 다른 모델의 플래너이자 오케스트레이터로 사용해 좋은 결과를 얻었습니다. 위임은 병렬로 잘 실행되는 작업의 속도를 높일 수 있습니다. 하지만 서브에이전트는 세션 비용의 큰 부분을 차지할 수 있으므로, 하네스가 기본적으로 어떤 모델에서 서브에이전트를 실행하는지 확인하세요.

## 신중함이 누적되지 않도록 하기

신중한 지침은 메모리, 메모, 지침 파일, 에이전트 간 메시지 등 컨텍스트가 이어지는 곳이면 어디에서나 쌓입니다. Claude Fable 5.2는 이러한 지침을 면밀히 따르므로, 필요 없는 승인을 요청하거나 일상적인 작업을 보류할 수 있습니다. 일부 초기 테스터들이 주로 여러 에이전트가 함께 작업하는 환경에서 이 동작을 확인했습니다. 이전 모델들도 이러한 지침을 따르지만, 여기에 설명된 설정 중 하나에서는 Claude Fable 5.2만 작업을 보류했습니다.

이 동작이 보이면 에이전트가 지니고 다니는 내용을 정리하세요:

* **더 이상 필요 없는 메모를 제거하세요.** 시뮬레이션 작업에 대한 Anthropic의 테스트에서, 이전 세션의 메모 십여 개 중 하나가 절대 재시도하지 말라고 했습니다. 이 메모들이 컨텍스트에 있고 프롬프트에 재시도를 허용하는 내용이 없을 때, 모델은 도구가 사용 중이었던 후 약 10번 중 4번 재시도했으며, 이 메모들이 없을 때는 거의 모든 경우에 재시도했습니다.
* **승인이 필요 없는 단계를 명시하세요.** 시뮬레이션 작업에 대한 Anthropic의 테스트에서, 컨텍스트에는 "절대" 규칙, 메모, 그리고 검토자의 조건이 있었습니다. 규칙 끝에 승인이 필요 없는 단계로 재시도를 나열한 줄을 추가하자, 재시도 비율이 거의 0에서 시도의 약 절반으로 올라갔습니다. 같은 설정에서 더 자유롭게 행동하라는 일반적인 지침은 아무것도 바꾸지 못했습니다. 반복해도 안전한 호출에 대해서만 재시도를 명시하세요.
* **검토자 에이전트가 첨부하는 내용을 확인하세요.** 시뮬레이션 작업에 대한 Anthropic의 테스트에서, 한 설정에는 승인이 필요 없는 단계로 재시도를 나열한 줄이 프롬프트에 있었고, 컨텍스트에는 검토자의 "첫 번째 오류에서 중단하라"가 있었습니다. Claude Fable 5.2는 시도의 약 3분의 1에서 재시도하지 않았습니다. Claude Fable 5.1과 Claude Opus 5.5는 재시도했습니다.
* **예외를 규칙 안에 작성하세요.** 시뮬레이션 작업에 대한 Anthropic의 테스트에서, 책임자가 한 단계를 승인했습니다. "절대" 규칙 아래에서 모델은 약 10번 중 1번 그 단계를 실행했습니다. 승인된 단계는 진행 허가를 받은 것이라고 말하는 별도의 줄은 그 비율을 크게 바꾸지 못했습니다. 규칙 자체가 먼저 진행 허가를 받으라고 말했을 때, 모델은 약 10번 중 9번 그 단계를 실행했습니다. [승인](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#approvals)을 참조하세요.

또한 위험하거나 되돌릴 수 없는 작업에 대해서는 자체 확인 단계를 유지하세요.

## 이전 모델용으로 작성된 지침 검토하기

Claude Fable 5.2로 마이그레이션할 때는 프롬프트를 검토하세요. Anthropic의 테스트에서 이전 모델용으로 작성된 일부 지침은 비용을 높이거나, 부작용을 일으키거나, 더 이상 효과가 없었습니다. 다음 지침을 재검토하세요:

* **위임에 대한 상시 지침:** 작업을 서브에이전트로 넘기는 줄은 시스템 프롬프트, 스킬, 에이전트 파일에 있을 수 있습니다. 마이그레이션하기 전에 해당 파일을 읽어 보세요. 테스트에서 모델이 작업에 필요한 것보다 더 많은 서브에이전트를 시작한다면, 더 이상 필요 없는 줄을 제거하세요. [서브에이전트에 대한 기대치 설정하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#set-expectations-for-subagents)를 참조하세요.
* **하네스가 프롬프트에 작성하는 토큰 예산:** 일부 하네스는 작업이 사용할 수 있는 토큰 수와 남은 토큰 수를 프롬프트에서 모델에 알려 줍니다. 그 예산의 크기는 Claude Fable 5.2가 얼마나 많이 소비하는지를 바꿉니다. `high` 및 `xhigh` effort에서의 코딩 작업에 대한 Anthropic의 테스트에서, 큰 예산을 제거하자 동등한 성능으로 비용이 낮아졌습니다. 예산 없이 작업을 테스트하세요. 이 결과는 프롬프트 안의 텍스트에 관한 것이며, 테스트에서 다루지 않은 베타 기능인 API의 [작업 예산](https://platform.claude.com/docs/ko/build-with-claude/task-budgets)에 관한 것이 아닙니다.
* **이전 턴을 편집하는 하네스 코드:** Claude Fable 5.2는 [보존된 사고](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking)를 사용합니다. 하네스가 요청 사이에 시스템 프롬프트, 도구 또는 이전 메시지를 변경하면, 기록에서 변경된 지점 뒤에 오는 사고 블록이 무효가 됩니다. 그러면 기본적으로 Messages API는 요청을 거부하고, Message Batches API는 해당 블록을 삭제합니다. 이 오류 없이 기록을 줄이려면 [컨텍스트 편집](https://platform.claude.com/docs/ko/build-with-claude/context-editing) 또는 요약 뒤에 이전 턴을 남기지 않는 [압축](https://platform.claude.com/docs/ko/build-with-claude/compaction)을 사용하세요. Messages API에서도 해당 블록을 삭제하도록 하려면 `thinking.block_binding.prefix_mismatch_behavior`를 `"drop_block"`(베타, `thinking-binding-controls-2026-08-01` 헤더)으로 설정하세요. Anthropic의 테스트에서 매 턴마다 이전 사고가 삭제되자, 모델은 다시 사고하며 더 많은 출력 토큰을 사용했습니다. 이는 최악의 경우이며, 증가 폭은 하네스가 이전 턴을 얼마나 자주 편집하는지에 따라 달라집니다. 압축과 컨텍스트 편집 외에는 기록을 추가 전용(append-only)으로 유지하세요. 그러면 캐시 적중률이 높게 유지되고 사고가 삭제되지 않습니다. `"drop_block"`에 의존하기 전에 자체 작업에서 출력 토큰을 측정하세요. [API가 유효하지 않은 블록을 처리하는 방식](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#mismatch-behavior) 및 [접두사를 편집하지 않고 변경하기](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#replace-prefix-edits)를 참조하세요.
* **"그 답변을 완료된 것으로 간주하라" 줄:** [Claude Opus 5.5 프롬프팅](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#thinking-instructions-in-chat-system-prompts)에서는 채팅 시스템 프롬프트용으로 두 문장을 제공합니다. 이 문장들은 모델에게 이전 답변을 완료된 것으로 간주하고 새 메시지에 사고를 집중하라고 지시합니다. `high` effort에서의 Anthropic 테스트에서, 이 문장들은 후속 질문에 대한 Claude Fable 5.2의 사고를 줄였지만, 모델이 이전 답변의 실수를 지적할 가능성도 크게 낮아졌습니다. 모델이 이전 답변을 계속 재검토하기를 원하는 경우에는 이 줄을 빼세요. 그 밖의 경우에는 이 줄을 채택하기 전에 모델이 여전히 자신의 실수를 지적하는지 테스트하세요.
* **사고를 줄이라는 지침:** Claude Fable 5.1은 대개 "숙고하지 말고 바로 답하라"와 같은 줄을 따릅니다. Anthropic의 테스트에서 이러한 줄은 `medium` 이상에서 Claude Fable 5.2의 사고를 막지 못했습니다. [effort 보정하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#calibrate-effort)에 설명된 대로, 이러한 줄을 제거하고 노력 수준을 낮추세요.
* **글쓰기 스타일 규칙:** Claude Fable 5.2는 스타일 규칙을 면밀히 따르므로, "문장당 하나의 지침, 20단어 이하"와 같은 엄격한 제한은 문장을 뚝뚝 끊기게 만들 수 있습니다. [보고서를 이해하기 쉽게 만들기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#make-reports-easy-to-follow)의 텍스트를 추가하기 전에 더 이상 필요 없는 규칙을 제거하세요.
* **누적된 규칙, 메모, 메모리:** 메모리 파일, 메모, 지침 파일에는 시간이 지나면서 주의 사항이 쌓이며, 그중 일부는 모델이 직접 작성했을 수도 있습니다. 마이그레이션하기 전에 더 이상 이유가 유효하지 않은 주의 사항을 삭제하고, 절대적인 규칙은 범위와 이유를 명시하도록 다시 작성하세요. 시스템이 이미 막혀 있다면 메모리와 메모를 정리한 상태로 다시 시작하는 것을 고려하고, 원본의 사본을 보관하세요. [신중함이 누적되지 않도록 하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#keep-caution-from-piling-up)를 참조하세요.

## 보고서를 이해하기 쉽게 만들기

긴 에이전트 작업 후 Claude Fable 5.2의 최종 보고서를 읽는 사람들은 대개 그 이면의 도구 호출이나 파일을 보지 못했습니다. 보고서는 그 자체로 이해될 수 있어야 합니다.

Claude Fable 5.2에 최종 보고서나 인계 문서 작성을 요청한다면, 시스템 프롬프트에 다음 텍스트를 추가하고 독자와 제품에 맞게 조정하세요:

```text wrap
# Communicating clearly
Write for an intelligent but low-context reader. The person reading has not seen your tool calls, your reasoning or the files you opened, and may be switching in from other work. Messages should generally be self-contained: the reader should understand what you mean without having to dig for other context. Put the key points in the first few sentences. Practice progressive disclosure in your sentence order, and do not use undefined references and ideas in line 1 that won't make sense until the reader reaches line 12.

Use plain words, and write in clear, understandable full sentences. Do not use a term or abbreviation that you made up during the work. Say what the thing is in a way any reader would understand. Write mostly in the style of ASD-STE100 Simplified Technical English: short sentences, one idea per sentence, active voice, and consistently using the same word for the same thing. Use a paragraph of flowing prose where ideas connect, and keep bullets for lists of separate items. Leave out unnecessary details unless the reader asks and practice concision, but do ensure that your messages have the key context. Aim to make your user-facing text as human-readable and clear as possible.
```

에이전트 작업에 대한 Anthropic의 테스트에서, 이 텍스트는 최종 보고서의 밀도를 낮추고 세미콜론 사용을 줄였습니다. 워크플로 자동화 작업에서는 문장도 짧아졌습니다. 길이에 관한 지침을 추가하거나 모델에 특정 세부 정보를 포함하도록 요청할 수도 있습니다.

## 안전장치에 의한 거부

Claude Fable 5.2는 요청을 거절할 수 있는 안전 분류기를 실행합니다. 거절된 요청은 `stop_reason: "refusal"`을 반환하며, `stop_details.category`에 [거부 카테고리](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#refusal-response)가 명시됩니다:

* `cyber`: 요청이 악성코드나 익스플로잇 개발과 같은 사이버 피해를 가능하게 할 수 있습니다.
* `bio`: 요청이 위험한 실험실 방법과 같은 생물학적 피해를 가능하게 할 수 있습니다.
* `frontier_llm`: 요청이 경쟁 AI 모델 개발에 도움이 될 수 있습니다.
* `reasoning_extraction`: 요청이 모델에 내부 추론을 응답 텍스트에 재현하도록 요구합니다.
* `general_harms`: 요청이 다른 사용 정책 영역에 해당합니다.

무해한 사이버보안 및 생명과학 작업도 `cyber` 및 `bio` 분류기를 작동시킬 수 있습니다. 이 분류기가 조직의 정당한 작업을 차단한다면 Anthropic의 [Cyber Verification Program](https://support.claude.com/en/articles/14604842) 및 [생명과학 검증 프로그램](https://www.anthropic.com/news/life-sciences-verification-program)을 참조하세요. [Claude Mythos 5.2](https://platform.claude.com/docs/ko/models/mythos-5-2/overview)는 이러한 프로그램을 통해 검증된 조직에만 Claude Fable 5.2와 동일한 기능을 제공합니다.

프롬프트, 스킬 또는 도구 설명이 모델에 응답 안에 추론을 작성하도록 요청한다면, 해당 지침을 제거하세요. 모델이 어떻게 추론했는지 보려면 `display: "summarized"`를 설정하고 사고 블록을 읽으세요. [추론을 사고 블록에 유지하기](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#keep-reasoning-in-thinking-blocks)를 참조하세요.

거절된 요청을 다른 모델로 재시도하려면 [거부, 폴백 및 요금 청구](https://platform.claude.com/docs/ko/models/fable-5-2/whats-new-fable-5-2#refusals-fallback-and-billing)를 참조하세요.

## 시작할 곳

마이그레이션할 때는 다음 단계를 순서대로 진행하세요:

1. `effort`를 명시적으로 `high`로 설정한 다음, `medium` 및 `xhigh`에서도 평가를 실행하세요.
2. 가져오는 시스템 프롬프트, 스킬, 에이전트 파일, 메모리 파일, 메모, 하네스 텍스트를 읽어 보세요. [이전 모델용으로 작성된 지침 검토하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)에 나열된 지침을 제거하거나 테스트하세요.
3. 가장 긴 에이전트 작업을 실행하세요. 모델이 조기에 중단하는 곳, 필요 없는 승인을 요청하는 곳, 조용해지는 곳, 작업에 필요한 것보다 더 많이 위임하는 곳, 또는 재구성을 원했는데 기존 코드에 덧붙이는 곳을 기록하세요.
4. 관찰한 각 동작에 대한 지침을 한 번에 하나씩 적용하고, 자체 작업에서 그 효과와 토큰 비용을 측정하세요.