마이그레이션 가이드

적응형 사고로 마이그레이션: thinking: {type: "enabled", budget_tokens: N}은 Claude 4.6 모델에서 더 이상 사용되지 않으며 향후 모델 릴리스에서 제거될 예정입니다. thinking: {type: "adaptive"}로 전환하고 effort 매개변수를 사용하여 사고 깊이를 제어하세요. 적응형 사고를 참조하세요.
```
response = client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 32000},
    betas=["interleaved-thinking-2025-05-14"],
    messages=[...],
)
```
마이그레이션은 또한 client.beta.messages.create에서 client.messages.create로 이동합니다. 적응형 사고와 effort는 GA 기능이며 베타 SDK 네임스페이스나 베타 헤더가 필요하지 않습니다.
Effort 베타 헤더 제거: effort 매개변수는 이제 GA입니다. 요청에서 betas=["effort-2025-11-24"]를 제거하세요.
세분화된 도구 스트리밍 베타 헤더 제거: 세분화된 도구 스트리밍은 이제 GA입니다. 요청에서 betas=["fine-grained-tool-streaming-2025-05-14"]를 제거하세요.
인터리브된 사고 베타 헤더 제거: 적응형 사고는 Opus 4.6과 Sonnet 4.6 모두에서 인터리브된 사고를 자동으로 활성화합니다. 요청에서 betas=["interleaved-thinking-2025-05-14"]를 제거하세요. 헤더는 여전히 수동 확장 사고를 사용하는 Sonnet 4.6에서 작동하지만 수동 모드는 더 이상 사용되지 않습니다.
output_config.format으로 마이그레이션: 구조화된 출력을 사용하는 경우 output_format={...}을 output_config={"format": {...}}로 업데이트하세요. 이전 매개변수는 계속 작동하지만 더 이상 사용되지 않으며 향후 모델 릴리스에서 제거될 예정입니다.

# Opus 4.1에서
model = "claude-opus-4-1-20250805"  # 이전
model = "claude-opus-4-6"  # 이후

# Sonnet 4에서
model = "claude-sonnet-4-20250514"  # 이전
model = "claude-opus-4-6"  # 이후

# Sonnet 3.7에서
model = "claude-3-7-sonnet-20250219"  # 이전
model = "claude-opus-4-6"  # 이후

샘플링 매개변수 업데이트

이는 Claude 3.x 모델에서 마이그레이션할 때의 주요 변경 사항입니다.

temperature 또는 top_p만 사용하고 둘 다 사용하지 마세요:

Python

# 이전 - Claude 4+ 모델에서 오류가 발생합니다
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # 둘 다 사용할 수 없습니다
    # ...
)

# 이후
response = client.messages.create(
    model="claude-opus-4-6",
    temperature=0.7,  # temperature 또는 top_p를 사용하되 둘 다 사용하지 마세요
    # ...
)

도구 버전 업데이트

이는 Claude 3.x 모델에서 마이그레이션할 때의 주요 변경 사항입니다.

최신 도구 버전으로 업데이트하세요. undo_edit 명령을 사용하는 모든 코드를 제거하세요.
```
# 이전
tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# 이후
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
```
- 및 을 사용하세요. 자세한 내용은 를 참조하세요.

refusal 중지 이유 처리

refusal 중지 이유를 처리하도록 애플리케이션을 업데이트하세요:

Python

response = client.messages.create(...)

if response.stop_reason == "refusal":
    # 거부를 적절히 처리합니다
    pass

model_context_window_exceeded 중지 이유 처리

Claude 4.5+ 모델은 요청된 max_tokens 제한이 아닌 컨텍스트 창 제한에 도달하여 생성이 중지될 때 model_context_window_exceeded 중지 이유를 반환합니다. 이 새로운 중지 이유를 처리하도록 애플리케이션을 업데이트하세요:
Python
```
response = client.messages.create(...)

if response.stop_reason == "model_context_window_exceeded":
    # 컨텍스트 창 제한을 적절히 처리합니다
    pass
```
도구 매개변수 처리 확인(후행 줄바꿈)

Claude 4.5+ 모델은 이전에 제거되었던 도구 호출 문자열 매개변수의 후행 줄바꿈을 유지합니다. 도구가 도구 호출 매개변수에 대한 정확한 문자열 일치에 의존하는 경우 논리가 후행 줄바꿈을 올바르게 처리하는지 확인하세요.
동작 변경에 대한 프롬프트 업데이트

Claude 4+ 모델은 더 간결하고 직접적인 통신 스타일을 가지며 명시적 지시가 필요합니다. 최적화 지침은 프롬프팅 모범 사례를 검토하세요.

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-sonnet-4-6",
    "max_tokens": 8192,
    "output_config": {
        "effort": "low"
    },
    "messages": [
        {
            "role": "user",
            "content": "Your prompt here"
        }
    ]
}'

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-sonnet-4-6",
    "max_tokens": 64000,
    "thinking": {
        "type": "adaptive"
    },
    "output_config": {
        "effort": "medium"
    },
    "messages": [
        {
            "role": "user",
            "content": "Your prompt here"
        }
    ]
}'

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "anthropic-beta: interleaved-thinking-2025-05-14" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-sonnet-4-6",
    "max_tokens": 16384,
    "thinking": {
        "type": "enabled",
        "budget_tokens": 16384
    },
    "output_config": {
        "effort": "medium"
    },
    "messages": [
        {
            "role": "user",
            "content": "Your prompt here"
        }
    ]
}'

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "anthropic-beta: interleaved-thinking-2025-05-14" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-sonnet-4-6",
    "max_tokens": 8192,
    "thinking": {
        "type": "enabled",
        "budget_tokens": 16384
    },
    "output_config": {
        "effort": "low"
    },
    "messages": [
        {
            "role": "user",
            "content": "Your prompt here"
        }
    ]
}'

# Sonnet 4에서
model = "claude-sonnet-4-20250514"  # 이전
model = "claude-sonnet-4-5-20250929"  # 이후

# Sonnet 3.7에서
model = "claude-3-7-sonnet-20250219"  # 이전
model = "claude-sonnet-4-5-20250929"  # 이후

# Haiku 3.5에서
model = "claude-3-5-haiku-20241022"  # 이전
model = "claude-haiku-4-5-20251001"  # 이후

# Haiku 3에서
model = "claude-3-haiku-20240307"  # 이전
model = "claude-haiku-4-5-20251001"  # 이후

text_editor_20250728

str_replace_based_edit_tool

마이그레이션 가이드

Claude 4.6으로 마이그레이션

모델 이름 업데이트

주요 변경 사항

마이그레이션 가이드

Claude 4.6으로 마이그레이션

모델 이름 업데이트

주요 변경 사항

권장 변경 사항

Claude 4.1 이전 버전에서 Claude 4.6으로 마이그레이션

추가 주요 변경 사항

추가 권장 변경 사항

Claude 4.6 마이그레이션 체크리스트

Claude Sonnet 4.6으로 마이그레이션

주요 변경 사항

Sonnet 4.5에서 마이그레이션할 때

Claude 3.x에서 마이그레이션할 때

권장 변경 사항

Sonnet 4.5에서 마이그레이션

확장 사고를 사용하지 않는 경우

확장 사고를 사용하는 경우

적응형 사고로 마이그레이션

마이그레이션 중 budget_tokens 유지

코딩 및 에이전트 사용 사례

채팅 및 비코딩 사용 사례

Sonnet 4.6 마이그레이션 체크리스트

Claude Sonnet 4.5로 마이그레이션

주요 변경 사항

Sonnet 4.5 마이그레이션 체크리스트

Claude Haiku 4.5로 마이그레이션

주요 변경 사항

Haiku 4.5 마이그레이션 체크리스트

도움 받기