Opus 4.5 마이그레이션 가이드

Sonnet 4.0, Sonnet 4.5 또는 Opus 4.1에서 Opus 4.5로의 원샷 마이그레이션.

마이그레이션 워크플로우

코드베이스에서 모델 문자열 및 API 호출 검색
모델 문자열을 Opus 4.5로 업데이트 (아래 플랫폼별 문자열 참조)
지원되지 않는 beta 헤더 제거
effort 파라미터를 "high"로 추가 (references/effort.md 참조)
모든 변경 사항 요약
사용자에게 알림: "Opus 4.5 사용 중 문제가 발생하면 알려주세요. 프롬프트 조정을 도와드리겠습니다."

모델 문자열 업데이트

코드베이스에서 사용하는 플랫폼을 확인한 후 그에 맞게 모델 문자열을 교체하세요.

지원되지 않는 Beta 헤더

context-1m-2025-08-07 beta 헤더가 있으면 제거하세요. Opus 4.5에서는 아직 지원되지 않습니다. 다음과 같이 주석을 남겨두세요:

# 참고: 1M 컨텍스트 beta (context-1m-2025-08-07)는 Opus 4.5에서 아직 지원되지 않음

대상 모델 문자열 (Opus 4.5)

플랫폼	Opus 4.5 모델 문자열
Anthropic API (1P)	`claude-opus-4-5-20251101`
AWS Bedrock	`anthropic.claude-opus-4-5-20251101-v1:0`
Google Vertex AI	`claude-opus-4-5@20251101`
Azure AI Foundry	`claude-opus-4-5-20251101`

교체할 소스 모델 문자열

소스 모델	Anthropic API (1P)	AWS Bedrock	Google Vertex AI
Sonnet 4.0	`claude-sonnet-4-20250514`	`anthropic.claude-sonnet-4-20250514-v1:0`	`claude-sonnet-4@20250514`
Sonnet 4.5	`claude-sonnet-4-5-20250929`	`anthropic.claude-sonnet-4-5-20250929-v1:0`	`claude-sonnet-4-5@20250929`
Opus 4.1	`claude-opus-4-1-20250422`	`anthropic.claude-opus-4-1-20250422-v1:0`	`claude-opus-4-1@20250422`

마이그레이션 금지: Haiku 모델 (예: claude-haiku-4-5-20251001).

프롬프트 조정

Opus 4.5는 이전 모델과 알려진 동작 차이가 있습니다. 사용자가 명시적으로 요청하거나 특정 문제를 보고하는 경우에만 이 수정 사항을 적용하세요. 기본적으로는 모델 문자열만 업데이트합니다.

통합 지침: 스니펫을 추가할 때 프롬프트에 단순히 붙여넣지 말고 신중하게 통합하세요:

XML 태그 (예: <code_guidelines>, <tool_usage>)를 사용하여 추가 내용을 구성
기존 프롬프트의 스타일과 구조에 맞춤
논리적 위치에 스니펫 배치 (예: 코딩 지침은 다른 코딩 명령어 근처에)
프롬프트에 이미 XML 태그가 있다면, 기존 태그 내에 새 콘텐츠를 추가하거나 일관된 새 태그를 생성

1. 도구 과다 트리거링

Opus 4.5는 시스템 프롬프트에 더 민감하게 반응합니다. 이전 모델에서 과소 트리거링을 방지하기 위해 사용된 강한 표현이 이제 과다 트리거링을 유발할 수 있습니다.

적용 조건: 사용자가 도구가 너무 자주 또는 불필요하게 호출된다고 보고하는 경우.

찾아서 완화할 표현:

CRITICAL: → 제거 또는 완화
You MUST... → You should...
ALWAYS do X → Do X
NEVER skip... → Don't skip...
REQUIRED → 제거 또는 완화

도구 트리거링 관련 명령어에만 적용하세요. 다른 강조 표현은 그대로 두세요.

2. 오버 엔지니어링 방지

Opus 4.5는 추가 파일 생성, 불필요한 추상화 추가, 요청되지 않은 유연성 구축 경향이 있습니다.

적용 조건: 사용자가 원치 않는 파일, 과도한 추상화 또는 요청되지 않은 기능을 보고하는 경우. references/prompt-snippets.md의 스니펫을 추가하세요.

3. 코드 탐색

Opus 4.5는 코드 탐색에 지나치게 보수적일 수 있어 파일을 읽지 않고 해결책을 제안하는 경향이 있습니다.

적용 조건: 사용자가 모델이 관련 코드를 검사하지 않고 수정 사항을 제안한다고 보고하는 경우. references/prompt-snippets.md의 스니펫을 추가하세요.

4. 프론트엔드 디자인

적용 조건: 사용자가 프론트엔드 디자인 품질 향상을 요청하거나 일반적인 결과물을 보고하는 경우.

references/prompt-snippets.md의 프론트엔드 미적 감각 스니펫을 추가하세요.

5. Thinking 민감도

확장 사고(extended thinking)가 활성화되지 않은 경우(기본값), Opus 4.5는 "think"라는 단어와 그 변형에 특히 민감합니다. 확장 사고는 API 요청에 thinking 파라미터가 포함된 경우에만 활성화됩니다.

적용 조건: 확장 사고가 활성화되지 않은 상태(요청에 thinking 파라미터 없음)에서 "thinking" 관련 문제를 사용자가 보고하는 경우.

"think"를 "consider", "believe", "evaluate" 등의 대안으로 교체하세요.

참고

추가할 각 스니펫의 전체 텍스트는 references/prompt-snippets.md를 참조하세요.

effort 파라미터 구성은 references/effort.md를 참조하세요 (사용자가 요청하는 경우에만).

claude-opus-4-5-migration