Claude Code에서 Claude Sonnet 5.5를 사용하려면 v2.1.284 이상으로 업데이트한 다음, claude --model claude-sonnet-5-5 명령어로 실행하거나 /model로 선택하세요. 유료 Claude 플랜(Pro, Max, Team 또는 Enterprise) 또는 Anthropic API 키가 필요합니다. 무료 플랜에는 Claude Code가 포함되지 않습니다. 모든 플랜에서 기본 모델은 Opus 5.5로 유지되므로 Sonnet 5.5는 직접 선택해야만 실행됩니다. API 요율로는 Opus 5.5($4/$20)에 비해 절반 가격인 백만 입력/출력 토큰당 $2/$10입니다.
아래: 설정, sonnet 별칭 함정, 노력 수준, 제어할 습관, 비용, 그리고 Opus 5.5가 여전히 우위를 점하는 경우에 대해 설명합니다. 모델 자체에 대한 자세한 내용은 Claude Sonnet 5.5는 무엇인가를 참조하세요. 코드에서 API를 호출하는 경우, Apidog는 Claude Code가 변경 사항에 대해 실행할 수 있는 테스트 시나리오를 제공합니다.
Claude Code의 Claude Sonnet 5.5 한눈에 보기
| 설정 | Sonnet 5.5 |
|---|---|
| 최소 버전 | v2.1.284 |
| 플랜 | Pro, Max, Team, Enterprise, API 키; 무료 플랜 불가 |
| 기본 모델 | Opus 5.5, Sonnet 5.5는 직접 선택 |
sonnet 별칭 |
Anthropic API에서만 Sonnet 5.5 |
| 컨텍스트 | 1M 네이티브 |
| 기본 노력 수준 | medium; 사고 기능은 끌 수 없음 |
| 빠른 모드 | 사용 불가 |
출처: Claude Code의 모델 구성 문서 및 Anthropic의 출시 게시물.
단계 1: Claude Code 업데이트 및 플랜 확인
Sonnet 5.5는 2026년 9월 28일 Claude Code v2.1.284에 도입되었으며, 이전 버전에서는 실행할 수 없습니다:
claude update
claude.com/pricing에 따르면, Pro는 연간 청구 시 월 $17 또는 월간 $20이며, Max는 $100부터 시작합니다. 무료 사용자는 Claude.ai에서 Sonnet 5.5와 채팅할 수 있지만, Claude Code에서는 할 수 없습니다. 무료 접속 가이드에서 작동하는 방법을 다룹니다.
단계 2: 모델을 Sonnet 5.5로 전환
claude --model claude-sonnet-5-5
세션 내에서, /model claude-sonnet-5-5를 입력하면 모델이 전환되고 기본값으로 저장됩니다. /model만 실행하여 선택기를 열 수 있으며, 여기에서 s는 현재 세션에서만 전환됩니다. 설정 파일의 ANTHROPIC_MODEL 또는 "model" 키도 작동하며, /status는 현재 활성 상태를 보여줍니다.
/model 전환은 주 모델을 상속하는 서브에이전트에게도 적용되며, 재개된 세션은 저장된 모델을 유지합니다. Sonnet 5 Claude Code 가이드를 위해 claude-sonnet-5를 고정했다면, 업데이트하세요. 별칭이 변경되어도 전체 ID는 이동하지 않습니다.
sonnet 별칭이 모든 곳에서 Sonnet 5.5를 의미하지는 않습니다
sonnet은 Anthropic API에서만 Sonnet 5.5를 가리킵니다:
| 제공업체 | sonnet이 해석되는 모델 |
|---|---|
| Anthropic API | Sonnet 5.5 |
| AWS의 Claude Platform | Sonnet 4.6 |
| Amazon Bedrock, Google Cloud의 Agent Platform | Sonnet 4.5 |
| Microsoft Foundry | Sonnet 4.5 |
클라우드 제공업체에서는 ANTHROPIC_DEFAULT_SONNET_MODEL을 해당 제공업체의 Sonnet 5.5 ID로 설정하세요: Google Cloud 및 AWS의 Claude Platform에서는 claude-sonnet-5-5, Foundry에서는 배포 이름, Bedrock에서는 추론 프로필입니다. 동일한 변수가 opusplan이 실행되는 모델을 설정합니다.
sonnet[1m]은 건너뛰세요. 문서에 따르면 sonnet이 Sonnet 5.5가 되면 효과가 없다고 합니다. Sonnet 5.5의 1M 컨텍스트는 기본 제공됩니다.
단계 3: 노력 수준 선택 (사고 기능 유지)
Claude Code에서 Sonnet 5.5는 medium 수준으로 시작하며, 이는 Claude Platform API의 기본값인 high보다 한 단계 아래입니다. 노력 수준은 low, medium, high, xhigh, max로 나뉩니다:
claude --model claude-sonnet-5-5 --effort high
세션에서 /effort high는 현재 모델에 대한 수준을 저장하고, /effort는 슬라이더를 열며, /effort auto는 설정을 지웁니다. CLAUDE_CODE_EFFORT_LEVEL은 환경에서 설정합니다. 대화 중간에 노력 수준을 변경하면 프롬프트 캐시가 무효화될 수 있으므로, Claude Code가 먼저 경고할 수 있습니다.
여기서는 사고 기능을 끌 수 없습니다. Option+T (Alt+T) 토글, alwaysThinkingEnabled 및 MAX_THINKING_TOKENS=0은 Sonnet 5.5에 영향을 미치지 않습니다. Anthropic의 프롬프트 가이드는 medium부터는 거의 모든 답변 전에 사고하며, "덜 생각하도록" 요청해도 안정적으로 작동하지 않는다고 덧붙입니다. 대신 노력 수준을 낮추거나, 한 번의 더 깊은 턴을 위해 하나의 프롬프트에 ultrathink를 추가하세요.
CursorBench에서 각 수준별 성능
Cursor는 자체 하네스에서 CursorBench 4.0 점수를 측정했으며, 작업별 비용은 Anthropic의 출시 차트에서 가져왔습니다.
| 노력 수준 | Sonnet 5.5 | Opus 5.5 |
|---|---|---|
low |
35.8% ($0.50) | 43.7% ($1.17) |
medium |
39.2% ($0.70) | 52.5% ($2.91) |
high |
47.8% ($1.67) | 56.0% ($3.97) |
xhigh |
53.1% ($3.88) | 56.0% ($6.98) |
max |
55.5% ($9.67) | 57.8% ($13.43) |
low에서 high까지, Sonnet 5.5는 동일 수준의 Opus 5.5 비용의 절반 미만입니다. 하지만 수준을 넘나들어 보면, Opus 5.5의 medium($2.91)은 Sonnet의 high보다 높은 점수를 기록하고, $3.88이 드는 Sonnet의 xhigh와 1점 차이 내에 들어옵니다. Sonnet 5.5를 xhigh 또는 max로 밀어붙이고 있다면, 먼저 Opus 5.5의 medium을 시도해 보세요.
코딩 세션에서 나타나는 습관 제어
Anthropic의 Sonnet 5.5 프롬프트 가이드는 Claude Code에서 중요한 행동들을 지적합니다:
- 오랜 에이전트 작업에서
low및medium수준에서는 일찍 확인합니다. - 모든 노력 수준에서 요청하지 않은 테스트, 문서 및 작은 파일을 추가합니다.
xhigh및max수준에서는 추가 검토 라운드 또는 검토자 서브에이전트를 시작합니다. Anthropic은 이를max(46.2%)에서xhigh(52.1%)보다 낮은 FrontierCode 점수와 연관시킵니다.low수준에서는 확인을 건너뛰고 테스트를 실행하지 않고도 코드가 완료되었다고 보고할 수 있습니다.
가이드에는 Anthropic이 제안하는 프롬프트 단락이 있습니다. Anthropic의 테스트에서 max 수준에서 세션 비용을 약 3분의 1 절감했습니다. CLAUDE.md에 맞게 조정할 수 있는 짧은 세트는 다음과 같습니다:
## 이 레포지토리에서 작업하는 방법
- 작업이 완료될 때까지 계속 작업하세요. 막히거나 데이터를 삭제하려 할 때만 질문하기 위해 멈추세요.
- 작업에 필요한 것만 변경하세요. 요청하지 않는 한 새로운 테스트, 문서 또는 파일을 추가하지 마세요.
- 작업이 완료되었다고 말하기 전에, 관련 테스트를 실행하고 명령 및 결과를 보여주세요.
- 검토를 요청하지 않는 한 검토자 서브에이전트를 시작하지 마세요.
빠른 모드, opusplan 및 모델 혼합
빠른 모드는 Opus 전용입니다: 빠른 모드 문서에 따르면 Opus 5.5, Opus 5 및 Opus 4.8입니다. Sonnet 5.5에서 /fast를 실행하면 세션이 Opus로 전환됩니다. Sonnet의 속도는 Anthropic이 Sonnet 5보다 "30% 이상 빠르다"고 말하는 모델 자체에서 비롯됩니다.
claude --model opusplan은 계획 모드에서 Opus를 사용하고 실행 모드에서 Sonnet을 사용합니다. 디자인이 어렵고 편집이 일상적인 작업에 적합합니다. Anthropic 출시 페이지에 인용된 Creator의 Kevin Ngo는 Opus 5.5가 설정한 게임 아키텍처를 Sonnet 5.5가 구축하도록 할 것이라고 말했습니다. 또한 Opus를 주 모델로 유지하고 서브에이전트에 CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-5를 설정할 수도 있습니다. Claude Code 워크플로우 가이드에 더 많은 패턴이 있습니다.
Opus 5.5를 유지해야 할 때
Anthropic은 Opus 5.5가 "복잡하고 개방형 작업에서 여전히 명확하게 더 강력하다"고 말하며, Sonnet 5.5는 잘 정의된 작업과 버그 수정에 가장 적합하다고 합니다. 시스템 카드(Anthropic 운영)도 이에 동의합니다: 최대 노력 수준에서 SWE-Bench Pro는 81.3 대 89.9, 긴 컨텍스트 테스트인 ProgramBench는 79.7 대 91.2입니다.
모호한 버그, 아키텍처 결정, 대규모 코드베이스 세션 및 빠른 모드에는 Opus 5.5를 유지하세요. 범위가 지정된 수정, 명세화된 기능, 테스트, 문서 및 서브에이전트 작업에는 Sonnet 5.5를 선택하세요. Sonnet은 Terminal-Bench 4.0에서 앞서지만(max에서 70.6% 대 xhigh에서 66.4%), Anthropic이 실행한 결과 Opus 시도의 10%가 폴백을 겪은 반면 Sonnet은 1.5%만 겪었습니다. 자세한 내용은: Sonnet 5.5 대 Opus 5.5.
세션 비용
API 키를 사용하면 Claude Code는 정가로 청구됩니다: Sonnet 5.5의 경우 백만 토큰당 $2/$10, Opus 5.5의 경우 $4/$20, 양쪽 모두 캐시 읽기 $0.20입니다. Anthropic은 또한 Sonnet 5보다 "작업당 최대 30% 더 저렴하다"고 주장합니다.
Pro, Max, Team 또는 Enterprise 플랜에서는 세션이 플랜의 사용량 제한을 따르며, /usage는 현재 사용량을 보여줍니다. 각 모델이 이러한 제한에 대해 어떤 가중치를 가지는지에 대한 공식적인 수치는 찾지 못했으므로, 자신의 작업으로 측정하세요.
max 수준에 주의하세요: Simon Willison은 Hacker News에서 그의 펠리컨 테스트가 max 수준에서 약 15분 만에 128,000개의 사고 토큰을 소모했으며 SVG를 생성하기 전에 고갈되었다고 보고했습니다. 더 자세한 계산: Sonnet 5.5 가격.
Claude Code 내에서 API 프로젝트 마이그레이션
앱이 API를 통해 Sonnet 5를 호출하는 경우, Claude Code가 마이그레이션할 수 있습니다:
/claude-api migrate this project to claude-sonnet-5-5
실제 호환성 문제가 발생할 수 있습니다: thinking: {"type": "disabled"}는 400 오류를 반환하며 between_tools로 변경됩니다. 강제 tool_choice는 auto 및 strict: true 도구로 대체되고, 기본값이 아닌 temperature, top_p 또는 top_k는 400 오류를 반환합니다. Sonnet 5.5 대 Sonnet 5에서 각 수정 사항을 다룹니다.
그런 다음 라이브 API에 대해 테스트하세요. 이전 요청과 새 요청을 Apidog에 쌍으로 저장하고, ANTHROPIC_API_KEY를 환경 변수에 유지하며, stop_reason 및 usage를 검증하여 거부되거나 출력 토큰이 급증하는 경우 실패한 테스트로 표시되도록 합니다.
Apidog CLI로 API 테스트 실행
low 수준의 Sonnet 5.5는 테스트를 건너뛸 수 있으므로, 실행할 테스트를 제공하세요. Apidog CLI는 터미널에서 저장된 Apidog 테스트 시나리오를 실행하므로, Claude Code는 실행을 시작하고, 결과를 읽고, 핸들러를 수정하고 다시 실행할 수 있습니다. CLAUDE.md에 다음 규칙을 추가하세요:
- API 엔드포인트를 변경한 후, Apidog CLI를 사용하여 해당 Apidog 테스트 시나리오를 실행하고 통과 및 실패 횟수를 보고하세요.
설정은 Claude Code의 Apidog CLI에 있으며, Copilot 버전은 GitHub Copilot의 Apidog CLI입니다. 시나리오를 구축하려면 Apidog를 다운로드하세요.
GitHub Copilot 및 Cursor의 Sonnet 5.5
GitHub Copilot. GitHub의 변경 로그에 따르면, Sonnet 5.5는 9월 28일 Copilot Pro, Pro+, Max, Business 및 Enterprise 플랜에 대해 일반 제공(GA)되었으며, 제공업체 정가로 청구됩니다. 점진적 출시로 VS Code, JetBrains, Copilot CLI, 코딩 에이전트 등에서 사용할 수 있습니다. Copilot Free 및 Student 플랜은 이를 사용할 수 없으며, 이러한 플랜은 Sonnet 5.5를 포함하지 않는 자동 모델 선택으로 제한됩니다.
Cursor. Cursor의 모델 페이지에는 claude-sonnet-5-5가 200k 기본 및 1M 최대 컨텍스트로 나열되어 있으며, Pro 이상 플랜의 기타 모델 풀에서 동일한 $2/$10 요율로 청구됩니다. 미국 전용 엔드포인트는 10% 더 비쌉니다. Cursor는 아직 이에 대한 변경 로그 항목을 게시하지 않았습니다.
자주 묻는 질문
Sonnet 5.5가 Claude Code의 기본 모델인가요? 아닙니다. Pro, Max, Team, Enterprise 및 Anthropic API에서 default는 Opus 5.5입니다. Sonnet 5.5는 --model 또는 /model로 선택하세요.
무료 플랜으로 Claude Code에서 사용할 수 있나요? 아니요, Claude Code는 유료 전용입니다. 무료 사용자는 Claude.ai에서 Sonnet 5.5와 채팅할 수 있습니다. Sonnet 5.5를 무료로 사용하는 방법을 참조하세요.
/model sonnet을 입력하면 왜 이전 모델이 나오나요? 클라우드 제공업체(Bedrock, Google Cloud, Foundry, AWS의 Claude Platform)를 사용 중이거나 v2.1.284 이전 버전을 사용 중일 수 있습니다. 전체 ID를 고정하세요.
Opus 5.5보다 얼마나 저렴한가요? API 정가 기준으로 절반입니다. 가격 분석을 참조하세요.
다음 단계
claude update를 실행하고, 다음 범위 지정 작업을 claude --model claude-sonnet-5-5로 시작한 다음, 며칠 동안 노력 수준을 medium으로 유지하세요. CLAUDE.md 규칙을 추가하고, 디자인 중심 작업은 opusplan을 통해 보내고, Opus 5.5를 한 번의 /model 전환으로 유지하세요. 작업이 API와 관련된다면, Apidog CLI를 연결하여 모든 "완료" 작업 뒤에 테스트 실행이 있도록 하세요. Apidog는 무료로 시작할 수 있습니다.