Claude Opus 4.6은 Claude 4.5의 거의 드롭인 대체 모델이지만, 알아야 할 몇 가지 주요 변경 사항이 있습니다. 새로운 기능의 전체 목록은 Claude 4.6의 새로운 기능을 참조하세요.
# Opus 마이그레이션
model="claude-opus-4-5" # 이전
model="claude-opus-4-6" # 이후프리필 제거: Claude 4.6 모델에서 어시스턴트 메시지 프리필은 400 오류를 반환합니다. 대신 구조화된 출력, 시스템 프롬프트 지침 또는 output_config.format을 사용하세요.
도구 매개변수 따옴표 처리: Claude 4.6 모델은 도구 호출 인수에서 약간 다른 JSON 문자열 이스케이프를 생성할 수 있습니다(예: 유니코드 이스케이프 또는 슬래시 이스케이프의 다른 처리). JSON 파서 대신 원시 문자열로 도구 호출 input을 파싱하는 경우, 파싱 로직을 확인하세요. 표준 JSON 파서(json.loads() 또는 JSON.parse() 등)는 이러한 차이를 자동으로 처리합니다.
필수는 아니지만 경험을 개선할 수 있습니다:
적응형 사고로 마이그레이션: 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"]를 제거하세요.
인터리브 사고 베타 헤더 제거: 적응형 사고는 자동으로 인터리브 사고를 활성화합니다. 요청에서 betas=["interleaved-thinking-2025-05-14"]를 제거하세요.
output_config.format으로 마이그레이션: 구조화된 출력을 사용하는 경우, output_format={...}을 output_config={"format": {...}}로 업데이트하세요. 이전 매개변수는 계속 작동하지만 더 이상 사용되지 않으며 향후 모델 릴리스에서 제거될 예정입니다.
Opus 4.1, Sonnet 4 또는 이전 모델에서 직접 Claude 4.6으로 마이그레이션하는 경우, 위의 Claude 4.6 주요 변경 사항과 이 섹션의 추가 변경 사항을 적용하세요.
# 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 중 하나만 사용하세요. 둘 다 사용하지 마세요:
# 이전 - 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"}]text_editor_20250728과 str_replace_based_edit_tool을 사용하세요. 자세한 내용은 텍스트 편집기 도구 문서를 참조하세요.code_execution_20250825로 업그레이드하세요. 마이그레이션 지침은 코드 실행 도구 문서를 참조하세요.refusal 중지 사유 처리
애플리케이션을 업데이트하여 refusal 중지 사유를 처리하세요:
response = client.messages.create(...)
if response.stop_reason == "refusal":
# 거부를 적절히 처리
passmodel_context_window_exceeded 중지 사유 처리
Claude 4.5+ 모델은 요청된 max_tokens 제한이 아닌 컨텍스트 윈도우 제한에 도달하여 생성이 중지될 때 model_context_window_exceeded 중지 사유를 반환합니다. 이 새로운 중지 사유를 처리하도록 애플리케이션을 업데이트하세요:
response = client.messages.create(...)
if response.stop_reason == "model_context_window_exceeded":
# 컨텍스트 윈도우 제한을 적절히 처리
pass도구 매개변수 처리 (후행 줄바꿈)
Claude 4.5+ 모델은 이전에 제거되었던 도구 호출 문자열 매개변수의 후행 줄바꿈을 보존합니다. 도구가 도구 호출 매개변수에 대한 정확한 문자열 매칭에 의존하는 경우, 로직이 후행 줄바꿈을 올바르게 처리하는지 확인하세요.
동작 변경에 맞게 프롬프트 업데이트
Claude 4+ 모델은 더 간결하고 직접적인 커뮤니케이션 스타일을 가지며 명시적인 지시가 필요합니다. 최적화 가이드는 프롬프팅 모범 사례를 검토하세요.
token-efficient-tools-2025-02-19와 output-128k-2025-02-19를 제거하세요 — 모든 Claude 4+ 모델에는 토큰 효율적 도구 사용이 내장되어 있으며 이러한 헤더는 효과가 없습니다.claude-opus-4-6으로 업데이트output_config.format 사용thinking: {type: "enabled", budget_tokens: N}에서 thinking: {type: "adaptive"}로 마이그레이션하고 effort 매개변수 사용 (budget_tokens는 더 이상 사용되지 않으며 향후 릴리스에서 제거 예정)effort-2025-11-24 베타 헤더 제거 (effort는 이제 GA)fine-grained-tool-streaming-2025-05-14 베타 헤더 제거interleaved-thinking-2025-05-14 베타 헤더 제거output_format을 output_config.format으로 마이그레이션 (해당하는 경우)temperature 또는 top_p 중 하나만 사용하도록 업데이트text_editor_20250728, code_execution_20250825)refusal 중지 사유 처리model_context_window_exceeded 중지 사유 처리token-efficient-tools-2025-02-19, output-128k-2025-02-19)Claude Sonnet 4.5는 강력한 지능과 빠른 성능을 결합하여 일상적인 코딩, 분석 및 콘텐츠 작업에 이상적입니다.
기능의 전체 개요는 모델 개요를 참조하세요.
Sonnet 4.5 가격은 입력 토큰 100만 개당 $3, 출력 토큰 100만 개당 $15입니다. 자세한 내용은 Claude 가격을 참조하세요.
모델 이름 업데이트:
# 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" # 이후확장 사고 활성화 고려 — 코딩 및 추론 작업에서 상당한 성능 향상을 제공합니다 (기본적으로 비활성화):
response = client.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 10000},
messages=[...]
)이러한 주요 변경 사항은 Claude 3.x Sonnet 모델에서 마이그레이션할 때 적용됩니다.
샘플링 매개변수
이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.
temperature 또는 top_p 중 하나만 사용하세요. 둘 다 사용하지 마세요.
도구 버전
이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.
최신 도구 버전(text_editor_20250728, code_execution_20250825)으로 업데이트하세요. undo_edit 명령을 사용하는 코드를 제거하세요.
refusal 중지 사유 처리
애플리케이션을 업데이트하여 refusal 중지 사유를 처리하세요.
동작 변경에 맞게 프롬프트 업데이트
Claude 4 모델은 더 간결하고 직접적인 커뮤니케이션 스타일을 가집니다. 최적화 가이드는 프롬프팅 모범 사례를 검토하세요.
claude-sonnet-4-5-20250929으로 업데이트text_editor_20250728, code_execution_20250825) — 레거시 버전 미지원 (3.x에서 마이그레이션하는 경우)undo_edit 명령을 사용하는 코드 제거 (해당하는 경우)temperature 또는 top_p 중 하나만 사용하도록 업데이트 (3.x에서 마이그레이션하는 경우)refusal 중지 사유 처리Claude Haiku 4.5는 거의 최첨단 성능을 갖춘 가장 빠르고 지능적인 Haiku 모델로, 대화형 애플리케이션과 대량 처리를 위한 프리미엄 모델 품질을 제공합니다.
기능의 전체 개요는 모델 개요를 참조하세요.
Haiku 4.5 가격은 입력 토큰 100만 개당 $1, 출력 토큰 100만 개당 $5입니다. 자세한 내용은 Claude 가격을 참조하세요.
모델 이름 업데이트:
# Haiku 3.5에서
model="claude-3-5-haiku-20241022" # 이전
model="claude-haiku-4-5-20251001" # 이후새로운 속도 제한 검토: Haiku 4.5는 Haiku 3.5와 별도의 속도 제한을 가집니다. 자세한 내용은 속도 제한 문서를 참조하세요.
확장 사고 활성화 고려 — 코딩 및 추론 작업에서 상당한 성능 향상을 제공합니다 (기본적으로 비활성화):
response = client.messages.create(
model="claude-haiku-4-5-20251001",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 5000},
messages=[...]
)확장 사고는 프롬프트 캐싱 효율성에 영향을 미칩니다.
새로운 기능 탐색: 컨텍스트 인식, 증가된 출력 용량(64K 토큰), 더 높은 지능 및 향상된 속도에 대한 자세한 내용은 모델 개요를 참조하세요.
이러한 주요 변경 사항은 Claude 3.x Haiku 모델에서 마이그레이션할 때 적용됩니다.
샘플링 매개변수
이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.
temperature 또는 top_p 중 하나만 사용하세요. 둘 다 사용하지 마세요.
도구 버전
이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.
최신 도구 버전(text_editor_20250728, code_execution_20250825)으로 업데이트하세요. undo_edit 명령을 사용하는 코드를 제거하세요.
refusal 중지 사유 처리
애플리케이션을 업데이트하여 refusal 중지 사유를 처리하세요.
동작 변경에 맞게 프롬프트 업데이트
Claude 4 모델은 더 간결하고 직접적인 커뮤니케이션 스타일을 가집니다. 최적화 가이드는 프롬프팅 모범 사례를 검토하세요.
claude-haiku-4-5-20251001로 업데이트text_editor_20250728, code_execution_20250825) — 레거시 버전 미지원undo_edit 명령을 사용하는 코드 제거 (해당하는 경우)temperature 또는 top_p 중 하나만 사용하도록 업데이트refusal 중지 사유 처리Was this page helpful?