---
title: Claude Haiku 5.5 마이그레이션 가이드
url: https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide
description: 이 마이그레이션 가이드를 통해 이전 Haiku 모델에서 Claude Haiku 5.5로 전환하세요. Claude Haiku 5.5를 활성화하기 위한 안내에는 새 모델 ID, 오류를 반환하는 설정, 사고 관련 변경 사항, 그리고 시작 모델별 체크리스트가 포함되어 있습니다.
---

<Note>
  이 가이드는 [Messages API](https://platform.claude.com/docs/ko/build-with-claude/working-with-messages) 코드 마이그레이션을 다룹니다. [Claude Managed Agents](https://platform.claude.com/docs/ko/managed-agents/overview)를 사용하는 경우, 모델 이름을 업데이트하는 것 외에는 변경이 필요하지 않습니다.
</Note>

<Tip>
  **Claude API 스킬로 마이그레이션을 자동화하세요.** Claude Code에서 `/claude-api migrate`를 실행하여 번들로 제공되는 [Claude API 스킬](https://platform.claude.com/docs/ko/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model)을 호출하세요. 현재 제공되는 모든 Claude 모델을 대상으로 사용할 수 있습니다:

  Claude Code가 코드를 대신 마이그레이션하도록 하세요

  ```text
  /claude-api migrate 이 프로젝트를 claude-haiku-5-5 모델로 마이그레이션해 줘
  ```

  이 스킬은 코드베이스 전반에 걸쳐 모델 ID 교체를 적용하고, 필요에 따라 호환성이 깨지는 매개변수 변경, 프리필(prefill) 대체, 대상 모델에 맞춘 effort 보정을 수행한 다음, 수동으로 확인해야 할 항목의 체크리스트를 생성합니다. 파일을 편집하기 전에 마이그레이션 범위(전체 작업 디렉터리, 하위 디렉터리 또는 특정 파일 목록)를 확인하도록 요청합니다. 또한 이 스킬은 Amazon Bedrock 및 Claude Platform on AWS 클라이언트를 감지하여 해당 플랫폼에 맞게 모델 ID 형식과 기능 변경 사항을 조정합니다.
</Tip>

이 가이드는 Claude Haiku 4.5를 호출하는 코드를 Claude Haiku 5.5로 옮기는 방법을 다룹니다. Claude Haiku 3.5 또는 Claude Haiku 3을 호출하는 코드의 경우, [Claude Haiku 3.5 및 이전 Haiku 모델에서 Claude Haiku 5.5로 마이그레이션](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#migrating-from-haiku-35)의 변경 사항도 함께 적용하세요. 대신 Sonnet 또는 Opus 모델로 업그레이드하려면 [모델 버전 간 업그레이드](https://platform.claude.com/docs/ko/about-claude/models/migration-guide)를 참조하세요. Claude Haiku 4.5를 얼마나 오래 사용할 수 있는지는 [모델 지원 중단](https://platform.claude.com/docs/ko/about-claude/model-deprecations)을 참조하세요.

## 시작 모델별 마이그레이션 체크리스트

그룹을 위에서부터 차례로 진행하고, 현재 모델이 명시된 그룹까지 마친 후 멈추세요. Claude Haiku 4.5를 사용 중이라면 첫 번째 그룹이 전체 목록입니다. 각 항목은 코드에서 수행해야 할 하나의 변경 사항입니다.

### 모든 시작 모델

1. 모델 ID를 사용 중인 플랫폼의 Claude Haiku 5.5 ID로 교체하세요. [Claude Haiku 5.5 모델 ID 사용](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id)을 참조하세요.
2. 동일한 텍스트가 더 많은 토큰으로 계산되고 큰 이미지는 더 많은 시각 토큰으로 계산되므로, 프롬프트의 토큰 수를 다시 계산하고 `max_tokens` 제한과 비용 추정치를 재검토하세요. [토큰 다시 계산하기](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#recount-tokens)를 참조하세요.
3. 요청에서 `thinking: {"type": "enabled", "budget_tokens": N}`을 보내는 경우, `thinking`을 `{"type": "adaptive"}`로 변경하세요. [사고 구성하기](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#configure-thinking)를 참조하세요.
4. 코드가 첫 번째 콘텐츠 블록을 답변으로 읽는 경우, 대신 `type`으로 블록을 선택하세요. [사고 구성하기](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#configure-thinking)를 참조하세요.
5. 요청에서 `temperature`, `top_p`, `top_k`를 제거하세요. [샘플링 매개변수 제거하기](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#remove-sampling-parameters)를 참조하세요.
6. 요청이 모델이 이어서 작성하도록 어시스턴트 턴으로 `messages`를 끝내는 경우, 대신 사용자 턴으로 끝내세요. [어시스턴트 프리필 대체하기](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#replace-assistant-prefill)를 참조하세요.
7. 컴퓨터 사용 기능을 사용하는 경우 `computer_20250124`를 교체하세요. Claude API와 Google Cloud에서는 `computer_toolset_20260801` 도구 세트로, Amazon Bedrock에서는 `computer_20251124`와 `computer-use-2025-11-24` 베타 헤더로 교체합니다. [컴퓨터 사용을 도구 세트로 이동하기](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#computer-use-toolset)를 참조하세요.
8. 저장된 대화를 다른 계정을 통해 재생하는 경우, 각 대화를 해당 대화를 생성한 계정을 통해 재생하세요. [사고 블록을 생성한 계정을 통해 재생하기](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#replay-thinking-blocks-through-the-producing-account)를 참조하세요.
9. 코드가 대화 중 요청 사이에 `system`, `tools` 또는 이전 `messages`를 변경하고 사고 블록을 다시 보내는 경우, 대화를 추가 전용(append-only)으로 유지하세요. [이전 턴을 변경하지 않고 유지하기](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#keep-earlier-turns-unchanged)를 참조하세요.
10. `stop_reason: "refusal"`을 처리하세요. Claude Haiku 5.5는 요청을 거부할 수 있는 안전 분류기를 실행하며, 서버 측 폴백 기능이 없습니다. [안전장치 거부](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals)를 참조하세요.
11. Amazon Bedrock에서 [구조화된 출력](https://platform.claude.com/docs/ko/build-with-claude/structured-outputs)(`output_config.format` 또는 `strict: true` 도구)을 사용하는 경우, 프롬프트에서 형식을 설명하거나 `strict` 없이 도구를 사용하고, 코드에서 출력을 검증하세요. Amazon Bedrock에서는 Claude Haiku 5.5에 구조화된 출력을 사용할 수 없습니다.

조직에 Claude Haiku 4.5에 대한 [Priority Tier](https://platform.claude.com/docs/ko/api/service-tiers#supported-models) 약정이 있는 경우, 용량을 별도로 계획하세요. Priority Tier는 Claude Haiku 5.5에서 지원되지 않습니다.

### Claude Haiku 3.5 이하

1. Claude Haiku 3.5 또는 Claude Haiku 3 모델 ID를 사용 중인 플랫폼의 Claude Haiku 5.5 ID로 교체하세요. [Claude Haiku 3.5 및 이전 Haiku 모델에서 Claude Haiku 5.5로 마이그레이션](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#migrating-from-haiku-35)을 참조하세요.
2. 레거시 `code_execution_20250522` 도구를 사용하는 경우, `code_execution_20250825` 이상으로 이동하세요.
3. 텍스트 편집기 도구를 사용하는 경우, `text_editor_20250728`로 이동하세요.
4. `refusal` 및 `model_context_window_exceeded` 중지 사유를 처리하세요.
5. 코드가 도구 호출 문자열 매개변수를 정확히 일치시키는 경우, 후행 줄바꿈을 허용하세요.
6. 프롬프트를 검토하세요.

## Claude Haiku 5.5 모델 ID 사용

Claude Haiku 4.5 모델 ID를 사용 중인 플랫폼의 Claude Haiku 5.5 ID로 교체하세요.

| 플랫폼                    | Claude Haiku 4.5                                  | Claude Haiku 5.5             |
| ---------------------- | ------------------------------------------------- | ---------------------------- |
| Claude API             | `claude-haiku-4-5-20251001` 또는 `claude-haiku-4-5` | `claude-haiku-5-5`           |
| Amazon Bedrock         | `anthropic.claude-haiku-4-5`                      | `anthropic.claude-haiku-5-5` |
| Claude Platform on AWS | `claude-haiku-4-5`                                | `claude-haiku-5-5`           |
| Google Cloud           | `claude-haiku-4-5@20251001`                       | `claude-haiku-5-5`           |
| Microsoft Foundry      | `claude-haiku-4-5`                                | `claude-haiku-5-5`           |

`claude-haiku-5-5`는 날짜 접미사가 없고 별도의 별칭도 없는 고정 모델 ID입니다.

## 토큰 다시 계산하기

Claude Haiku 5.5는 Claude 4.7 및 이후 모델과 동일한 새로운 "tokenizer"(토크나이저)를 사용합니다. 이 토크나이저를 사용하는 모든 모델과 마찬가지로, 동일한 입력 텍스트가 Claude Haiku 4.5보다 Claude Haiku 5.5에서 약 30% 더 많은 토큰을 생성합니다. 정확한 증가량은 콘텐츠에 따라 다릅니다. 요청, 응답 및 스트리밍 이벤트의 형태는 동일하게 유지됩니다. 달라지는 것은 토큰 단위로 측정하거나 예산을 책정하는 모든 항목입니다:

* 동일한 텍스트에 대해 `usage` 필드와 [토큰 카운팅](https://platform.claude.com/docs/ko/build-with-claude/token-counting) 결과가 더 높게 나옵니다.
* 주어진 토큰 수에 담기는 텍스트가 더 적어집니다.
* Claude Haiku 4.5에 맞춰 조정된 `max_tokens` 제한은 동등한 출력을 잘라낼 수 있습니다.
* Claude Haiku 4.5의 토큰 수로 산출한 비용 추정치는 긴 프롬프트에 대한 더 높은 가격을 포함하여 Claude Haiku 5.5의 토큰 수와 [가격](https://platform.claude.com/docs/ko/about-claude/pricing)으로 다시 계산해야 합니다. [긴 컨텍스트 가격](https://platform.claude.com/docs/ko/about-claude/pricing#long-context-pricing)을 참조하세요.

큰 이미지도 더 많은 토큰을 소비할 수 있습니다. Claude Haiku 5.5는 고해상도 이미지 티어를 사용하며, 긴 변이 2,576픽셀 또는 4,784 시각 토큰을 초과하는 이미지를 축소합니다. Claude Haiku 4.5 및 이전 Haiku 모델은 표준 티어를 사용하며, 긴 변이 1,568픽셀 또는 1,568 시각 토큰을 초과하는 이미지를 축소합니다. 2,000 x 1,500픽셀 이미지는 Claude Haiku 5.5에서 Claude Haiku 4.5보다 약 2.5배 많은 시각 토큰을 소비합니다. [해상도 및 토큰 비용](https://platform.claude.com/docs/ko/build-with-claude/vision#evaluate-image-size)을 참조하세요.

Claude Haiku 4.5에서 측정한 토큰 수를 재사용하지 말고, `model`을 `claude-haiku-5-5`로 설정하여 프롬프트의 토큰 수를 계산하세요.

## 사고 구성하기

Claude Haiku 5.5는 Claude Haiku 4.5와 다른 방식으로 사고를 구성합니다. `{"type": "enabled", "budget_tokens": N}`의 `thinking` 값은 400 오류를 반환하므로, 이 값을 보내는 요청에는 새로운 `thinking` 값이 필요합니다.

변경 전에는 Claude Haiku 4.5에 대한 요청이 토큰 예산과 함께 `thinking`을 `enabled`로 설정했습니다:

```json
{
  "model": "claude-haiku-4-5",
  "max_tokens": 16000,
  "thinking": { "type": "enabled", "budget_tokens": 8000 },
  "messages": [{ "role": "user", "content": "..." }]
}
```

변경 후에는 Claude Haiku 5.5에 대한 동일한 요청이 "adaptive thinking"(적응형 사고)을 사용합니다. `thinking` 값이 변경되고, `output_config.effort`가 모델이 얼마나 사고할지를 설정합니다:

```json
{
  "model": "claude-haiku-5-5",
  "max_tokens": 16000,
  "thinking": { "type": "adaptive" },
  "output_config": { "effort": "medium" },
  "messages": [{ "role": "user", "content": "..." }]
}
```

적응형 사고는 기본적으로 켜져 있으므로, 요청에서 `thinking`을 설정하지 않더라도 응답이 하나 이상의 `thinking` 블록으로 시작할 수 있습니다. `thinking`을 설정하지 않거나 `{"type": "adaptive"}`로 설정하고, [effort](https://platform.claude.com/docs/ko/build-with-claude/effort)를 조절 수단으로 사용하세요. Claude Haiku 4.5가 사고 없이 실행되었거나 토큰을 절약하기 위해 작은 예산으로 실행되었던 경우에는 더 낮은 effort 수준을 선택하세요. 더 낮은 수준에서는 모델이 사고를 덜 하며, 더 간단한 요청에서는 사고를 완전히 건너뛸 수 있습니다. 프롬프트 작성 안내는 [effort를 사용하여 사고 제어하기](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#use-effort-to-control-thinking)를 참조하세요. 콘텐츠 블록은 위치가 아닌 `type` 필드로 선택하고, `thinking` 블록은 도구 결과와 함께 수정하지 않은 상태로 다시 전달하세요.

사고 토큰은 `max_tokens`에 포함되므로, 작은 `max_tokens`를 사용하는 요청은 `thinking` 블록 이후 텍스트가 나오기 전에 `stop_reason: "max_tokens"`로 중단될 수 있습니다. Claude Haiku 4.5에 작은 `max_tokens`를 설정했다면, 사고를 위한 여유를 두도록 값을 높이거나 더 낮은 [effort](https://platform.claude.com/docs/ko/build-with-claude/effort) 수준을 선택하세요.

이전 어시스턴트 턴의 사고 블록은 컨텍스트에 남아 입력 토큰으로 계산되며, Claude Haiku 4.5는 최신 턴의 사고 블록만 유지했습니다. 따라서 멀티턴 대화는 토크나이저 변경만으로 설명되는 것보다 더 많은 입력 토큰을 포함합니다. 오래된 블록을 제거하려면 [사고 블록 지우기](https://platform.claude.com/docs/ko/build-with-claude/context-editing#thinking-block-clearing)를 사용하세요. [모델별 사고 블록 보존](https://platform.claude.com/docs/ko/build-with-claude/thinking#thinking-block-preservation-by-model)을 참조하세요.

기본적으로 Claude Haiku 5.5는 각 `thinking` 블록을 빈 `thinking` 필드와 `signature`만 포함하여 반환하는 반면, Claude Haiku 4.5는 요약된 사고를 반환했습니다. 요약된 사고를 받으려면 `thinking: {"type": "adaptive", "display": "summarized"}`를 설정하세요.

Claude Haiku 5.5는 강제 `tool_choice`(`any` 또는 이름이 지정된 도구)를 허용하지만, 응답은 도구 호출로 시작하며 `thinking` 블록이 없습니다. 모델이 도구를 호출하기 전에 사고하도록 하려면 `tool_choice: {"type": "auto"}`를 사용하고 프롬프트에서 언제 도구를 사용할지 명시하세요.

Claude Haiku 5.5는 Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5 및 이전 모델의 사고 블록을 읽으므로, Claude Haiku 4.5에서 Claude Haiku 5.5로 전환한 대화는 추론을 유지합니다. Claude Opus 5, Claude Opus 5.5, Claude Sonnet 5.5 또는 모든 Claude Fable이나 Claude Mythos 모델의 블록은 읽지 않으며, API는 오류 없이 해당 블록을 삭제합니다. Claude API와 Google Cloud에서는 Claude Opus 5.5와 Claude Sonnet 5.5가 Claude Haiku 5.5의 블록을 읽습니다. [대화 중 모델 전환](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#switching-models)을 참조하세요.

## 샘플링 매개변수 제거하기

Claude Haiku 4.5는 `temperature`, `top_p`, `top_k`를 허용합니다. Claude Haiku 5.5에서는 세 가지 모두를 생략하고 대신 프롬프트를 사용하여 모델의 동작을 안내하세요. 요청에 `temperature`가 포함된 경우 값은 `1`이어야 합니다. `top_p`가 포함된 경우 기본값인 `0.99`여야 합니다. 그 외의 `temperature` 또는 `top_p` 값은 `1`인 `top_p`를 포함하여 400 오류를 반환합니다. 모든 `top_k` 값도 마찬가지이며, `temperature`와 `top_p`를 모두 포함하는 요청도 마찬가지입니다.

## 어시스턴트 프리필 대체하기

"Prefill"(프리필)은 모델이 이어서 작성하는 `messages`의 마지막 어시스턴트 턴입니다. Claude Haiku 4.5는 사고가 꺼져 있을 때 이를 허용합니다. Claude Haiku 5.5는 사고가 꺼져 있더라도 400 오류와 함께 이를 거부합니다. `messages`를 사용자 턴으로 끝내고, 각 프리필을 그 용도에 따라 대체하세요:

* **출력 형식:** [구조화된 출력](https://platform.claude.com/docs/ko/build-with-claude/structured-outputs)을 사용하거나, 분류에는 enum 필드가 있는 도구를 사용하세요. Amazon Bedrock에서는 Claude Haiku 5.5에 구조화된 출력을 사용할 수 없습니다. 이 경우 프롬프트에서 형식을 설명하거나 `strict` 없이 도구를 사용하고, 코드에서 출력을 검증하세요.
* **서두:** 시스템 프롬프트에서 직접적인 답변을 요청하세요.
* **이어쓰기:** 이를 사용자 메시지로 옮기세요. 예: "이전 응답이 중단되었으며 `[previous_response]`로 끝났습니다. 중단된 부분부터 계속하세요."
* **컨텍스트 알림:** 사용자 턴에 넣으세요.

## 컴퓨터 사용을 도구 세트로 이동하기

Claude Haiku 4.5는 `computer-use-2025-01-24` 베타 헤더와 함께 `computer_20250124` 도구를 통해 [컴퓨터 사용](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool)을 지원합니다. Claude API와 Google Cloud에서 Claude Haiku 5.5는 `computer_toolset_20260801` 도구 세트를 통해서만 컴퓨터 사용을 지원하며, `computer_20250124`를 선언하는 요청은 400 오류를 반환합니다. Amazon Bedrock에서도 Claude Haiku 5.5는 `computer_20250124`를 허용하지 않으므로, `computer-use-2025-11-24` 베타 헤더와 함께 `computer_20251124` 도구 버전을 사용하세요.

통합을 도구 세트로 이전하려면 `computer-use-2025-01-24` 베타 헤더를 제거하고 `tools` 항목을 `{"type": "computer_toolset_20260801"}`로 교체하세요. 그런 다음 [`computer_20251124`에서 마이그레이션](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124)에 있는 나머지 요청 및 에이전트 루프 변경 사항을 적용하세요. `input.action`이 아닌 각 멤버 `tool_use` 블록의 `name`과 `toolset_name`을 기준으로 분기하고, 한 턴의 모든 해당 블록을 처리하며, 결과에 `toolset_name`을 그대로 반영하세요. 도구 세트에서는 확대/축소(zoom)가 기본적으로 켜져 있으므로, 환경에서 이를 구현하지 않는 경우 `"configs": {"zoom": {"enabled": false}}`를 추가하세요. `fine-grained-tool-streaming-2025-05-14` 베타 헤더를 보내는 경우 제거하세요. 도구 세트 항목과 함께 사용하면 400 오류를 반환합니다. 다른 플랫폼의 경우 컴퓨터 사용 도구의 [호환성](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/computer-use-tool#compatibility) 섹션을 참조하세요.

Claude API와 Google Cloud에서 Claude Haiku 5.5는 웹페이지 내 작업을 위한 [브라우저 사용 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/browser-use-tool)(`browser_toolset_20260801`)도 지원합니다. Claude Haiku 4.5는 이를 지원하지 않습니다.

## 사고 블록을 생성한 계정을 통해 재생하기

Claude Haiku 5.5의 사고 블록은 해당 블록을 생성한 계정 또는 그 계정에 연결된 계정에서만 작동합니다. 다른 계정이 이러한 블록 중 하나를 보내면, API는 모델이 보기 전에 해당 블록을 삭제하고 요청은 그 추론 없이 성공합니다. 이는 대화를 저장하고 다른 계정을 통해 재생하는 코드에 영향을 미칩니다. 예를 들어 하나의 대화 저장소에서 여러 고객에게 서비스를 제공하는 서비스가 이에 해당합니다. 각 대화를 해당 대화를 생성한 계정을 통해 재생하세요. [사고 블록은 생성한 계정에 귀속됩니다](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#account-bound-thinking)를 참조하세요.

## 이전 턴을 변경하지 않고 유지하기

Claude Haiku 5.5 사고 블록은 그 이전에 전송된 모든 내용이 변경되지 않은 동안에만 유효합니다. `system`, `tools` 또는 이전 `messages`를 변경한 후 사고 블록을 다시 보내는 요청은 400 오류를 반환합니다. Claude Haiku 4.5는 이 검사를 실행하지 않습니다. 대화를 추가 전용으로 유지하세요. 2026년 8월 31일 00:00 UTC 이전에 생성된 계정에서는 `thinking.block_binding.prefix_mismatch_behavior`를 설정한 요청에서만 오류가 발생합니다. 오류를 유발하는 변경 사항과 대신 수행해야 할 작업은 [변경이 필요한 대상](https://platform.claude.com/docs/ko/build-with-claude/preserved-thinking#who-is-affected)을 참조하세요.

## Claude Haiku 3.5 및 이전 Haiku 모델에서 Claude Haiku 5.5로 마이그레이션

Claude Haiku 3.5는 Claude API와 Amazon Bedrock에서 종료되었으며, Claude Haiku 3은 Claude API와 Google Cloud에서 종료되었습니다. 종료된 모델에 대한 요청은 실패합니다. Google Cloud는 Claude Haiku 3.5를 지원 중단으로 표시하며 기존 고객만 사용할 수 있습니다. [모델 지원 중단](https://platform.claude.com/docs/ko/about-claude/model-deprecations)을 참조하세요.

두 모델 중 어느 것에서든, 먼저 앞의 모든 섹션을 적용한 다음 아래 변경 사항을 적용하세요.

* **모델 ID:** `claude-3-5-haiku-20241022`, 그 별칭인 `claude-3-5-haiku-latest` 또는 `claude-3-haiku-20240307`을 `claude-haiku-5-5`로 교체하세요. Google Cloud에서는 `claude-3-5-haiku@20241022`를 `claude-haiku-5-5`로 교체하세요. Amazon Bedrock에서는 [Claude Haiku 5.5 모델 ID 사용](https://platform.claude.com/docs/ko/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id)의 Claude Haiku 5.5 ID를 사용하세요.
* **코드 실행:** Claude Haiku 5.5는 `code_execution_20250825` 및 이후 버전을 허용합니다. 레거시 Python 전용 `code_execution_20250522`를 사용하는 경우, 그중 하나로 이동하세요. [최신 도구 버전으로 업그레이드](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/code-execution-tool#upgrade-to-latest-tool-version)를 참조하세요.
* **텍스트 편집기:** 텍스트 편집기 도구를 사용하는 경우, `undo_edit` 명령이 없는 `text_editor_20250728`(도구 이름 `str_replace_based_edit_tool`)로 이동하세요. [텍스트 편집기 도구](https://platform.claude.com/docs/ko/agents-and-tools/tool-use/text-editor-tool)를 참조하세요.
* **중지 사유:** `refusal` 및 `model_context_window_exceeded`를 처리하세요. [중지 사유 처리](https://platform.claude.com/docs/ko/build-with-claude/handling-stop-reasons)를 참조하세요.
* **후행 줄바꿈:** Claude 4.5 및 이후 모델은 도구 호출 문자열 매개변수에서 후행 줄바꿈을 유지합니다. 코드가 해당 문자열을 정확히 일치시키는 경우, 이를 허용하세요.
* **프롬프트:** Claude 4 및 이후 모델은 더 간결하고 직접적인 커뮤니케이션 스타일을 가지며 명시적인 지시가 필요합니다. [Claude Haiku 5.5 프롬프팅](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5) 및 [프롬프팅 모범 사례](https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/claude-prompting-best-practices)를 기준으로 프롬프트를 검토하세요.