클로드 Opus 5.5 출시! Claude Code 기본 모델 교체·가격 20% 인하 총정리 - Opus 5와 달라진 점과 지금 바꿔야 할 설정 🚀

안녕하세요! Mojangcam입니다 😎

엊그제(9월 22일) Anthropic이 Claude Opus 5.5를 정식 출시했어요. 새 "5.5 패밀리"의 첫 주자인데, 같은 날 Claude Code v2.1.280이 나오면서 기본 모델이 Opus 5에서 Opus 5.5로 싹 바뀌었습니다. 모델 변경·effort 설정을 정리한 지 딱 하루 만에 라인업이 바뀐 셈이라, 오늘은 그 후속편으로 뭐가 달라졌고 내 설정에서 뭘 손봐야 하는지만 딱 정리해 드릴게요.

이번 글에서 다룰 내용은 이렇습니다.

• Opus 5.5 핵심 변화 — 성능·속도·가격 (Opus 5와 표로 비교)
• Claude Code v2.1.280에서 기본 모델이 어떻게 바뀌었는지 + 내 세션에서 확인하는 법
• Opus 5 → 5.5로 넘어갈 때 settings.json·effort에서 재점검할 것
• API로 직접 쓰는 분을 위한 호환성 깨지는 변경 4가지
• GitHub Copilot에서 쓰는 법, 그리고 Sonnet 5.5·Haiku 5.5 나올 때까지의 선택 기준

결론부터 말씀드리면 "더 똑똑한데 더 싸졌다"예요. Fable 5.1 수준의 성능을 내면서 Opus 5보다 토큰 단가는 20%, 실제 작업 비용은 40% 정도 낮아졌다는 게 공식 설명이고요. 구독 플랜을 쓰시는 분도 한도가 올라가서 체감이 될 거예요 🙌

📌 준비물

• Claude Code v2.1.280 이상 (2026-09-25 기준 npm 최신은 v2.1.281) — Opus 5.5는 v2.1.280부터 인식돼요
• Claude 구독(Pro·Max·Team·Enterprise) 또는 Anthropic API 키
• API 예제를 따라 하실 분: Python 3.10+, pip install anthropic python-dotenv (anthropic 1.8.0 / python-dotenv 1.2.3 기준)

버전부터 올리고 시작할게요.

claude update
claude --version

💬 v2.1.280 미만이면 /model 목록에 Opus 5.5가 아예 안 뜨거나 claude-opus-5-5를 쳐도 "does not support this model"이 나와요. 업데이트가 먼저입니다.

🧩 Opus 5.5, 뭐가 달라졌나요?

공식 발표문과 모델 문서 기준으로 Opus 5와 나란히 놓으면 이래요.

하나씩 뜯어볼게요 💡

• 성능 : Anthropic 자체 벤치마크에서 에이전틱 코딩·컴퓨터 사용·지식 업무 전부 1위예요. Terminal-Bench 4.0이 66.4%(Opus 5는 52.3%, Fable 5.1은 55.8%), FrontierCode 54.4%(Opus 5는 48.0%), OSWorld 2.0이 81.8%(Opus 5는 74.0%). 다만 공식 문서 스스로도 "이 수준에선 벤치마크 차이가 실제 체감 차이를 잘 못 보여준다"고 적어놨으니, 숫자보다 "Fable 5.1 급을 Opus 값에" 정도로 기억하시면 됩니다.
• 비용 40% ↓ : 토큰 단가가 20% 내려간 데다, 같은 작업을 더 적은 토큰·더 적은 스텝으로 끝내서 작업당 비용이 40% 정도 내려간다는 뜻이에요. 20만 줄짜리 코드베이스 감사에서 Opus 5가 20시간 넘게 걸리고 토큰을 2.5배 쓴 걸 Opus 5.5는 3시간 안에 끝냈다는 게 공식 사례고요.
• 캐시 읽기 $0.20 : 이게 은근 큰데요. Claude Code처럼 대화가 길어지는 에이전틱 작업은 비용 대부분이 캐시 읽기예요. 그게 60% 싸졌으니 긴 세션일수록 이득이 커집니다.
• 글쓰기가 달라짐 : Opus 5의 대표적인 불만이 "말이 너무 길고 장황하다"였는데, 5.5는 핵심을 앞에 두고 짧게 써요. 커밋 메시지·PR 설명·코드 주석이 눈에 띄게 간결해졌다는 초기 테스터 평이 많습니다.
• 패스트 모드 : Claude API에서 최대 2.5배 속도의 fast mode(리서치 프리뷰)도 열렸어요. 단, $8 / $40으로 단가가 2배라 "급할 때만" 켜는 옵션이에요.
• 구독 한도 상향 : Pro·Max·Team·(시트형) Enterprise의 5시간 사용량 한도가 올라갔고, 한도 리셋을 한 번 저장해뒀다가 원할 때 쓰는 기능도 생겼어요.
• 안전장치 : 사이버보안·생물학 능력이 Fable 5.1급이라 안전 분류기도 같은 급으로 붙었어요. 사이버보안으로 판정된 요청은 Opus 4.8, 생물학은 Opus 5로 넘어가서 실행됩니다. 일반 개발엔 영향 거의 없지만 CTF·보안 리서치 쪽 코드베이스에선 모델이 바뀌는 안내를 볼 수 있어요.

그리고 Sonnet 5.5·Haiku 5.5는 "수 주 내" 출시 예고 상태예요. 아직은 Opus만 5.5입니다.

📌 1단계 - Claude Code에서 뭐가 바뀌었는지 확인하기

v2.1.280 체인지로그에서 우리한테 중요한 건 딱 세 줄이에요.

1. opus 별칭이 Opus 5.5를 가리킴 — /model opus를 치면 이제 5.5가 켜져요
2. Pro·Team Standard의 기본 모델이 Sonnet → Opus로 변경 — 이제 모든 플랜(Pro·Max·Team·Enterprise·API)의 default가 Opus 5.5예요
3. /effort가 모델별로 저장되기 전에 저장해 둔 레벨은 Opus 5.5에 적용되지 않음 — 새 모델은 자기 기본값(medium)부터 시작해요

세션을 켜고 이렇게 확인해 보세요.

/status

헤더나 /status 화면에 Opus 5.5가 찍혀 있으면 끝. 별칭 상태를 정확히 보고 싶으면 /model을 쳐서 피커를 열어보면 됩니다.

💡 Pro 플랜 분들 주목. 어제까지 Sonnet 5로 돌던 세션이 오늘부터 Opus 5.5로 돌아요. 더 똑똑해진 대신 Sonnet보다 한도 소모가 빠릅니다. 한도가 아까우면 /model sonnet으로 내리거나, 설계만 Opus·구현은 Sonnet인 opusplan을 쓰세요. 반대로 "오늘 답이 좀 다르네?" 싶으면 모델이 바뀐 게 원인일 확률이 높아요.

📌 2단계 - Opus 5 → 5.5 전환 시 settings.json 재점검

기존 설정 파일을 그대로 두면 세 군데에서 어긋날 수 있어요. 사용자 설정(~/.claude/settings.json, 윈도우는 C:\Users\<계정>\.claude\settings.json)을 열어서 같이 봐요.

복붙 OK 👇 (Opus 5.5 기준으로 손본 버전)

{
  "model": "opus",
  "effortLevel": "high",
  "modelSettings": {
    "claude-opus-5-5": { "effortLevel": "medium" },
    "claude-opus-5": { "effortLevel": "medium" }
  },
  "fallbackModel": ["claude-opus-5", "claude-sonnet-5"]
}

하나씩 뜯어볼게요 💡

• model : opus 별칭 그대로 두면 자동으로 5.5를 타요. 반대로 당분간 Opus 5에 머물고 싶다면 정식 ID claude-opus-5로 박아두세요. 별칭은 새 버전이 나올 때마다 따라가니까요
• modelSettings : 저장된 effort는 정식 ID별로 기록되기 때문에, claude-opus-5에 넣어둔 medium은 5.5에 안 먹혀요. 5.5용으로 claude-opus-5-5 항목을 따로 넣어야 합니다. 위 예제는 둘 다 medium으로 맞춘 거예요
• effortLevel : 따로 저장된 레벨이 없는 모델에 적용되는 기본값이에요. 그런데 사용자 설정 파일의 최상위 effortLevel은 Opus 5.5에 적용되지 않습니다. 이 키는 /effort가 모델별 저장을 하기 전에 쓰던 옛날 형식이라, Opus 5·Fable 5.1 같은 기존 모델에만 계속 먹어요. (프로젝트·로컬·관리 설정이나 --settings로 넘긴 최상위 effortLevel은 모든 모델에 적용됩니다.) 헷갈리면 modelSettings에 명시하는 게 제일 확실해요
• fallbackModel : 주 모델이 과부하일 때 대신 시도할 모델 목록(최대 3개). Opus 5.5가 막 출시돼서 트래픽이 몰릴 수 있으니, 1순위를 claude-opus-5로 두면 품질 차이가 가장 적어요

그리고 effort 얘기를 하나 더 해야 하는데요. Opus 5.5는 기본 effort가 medium인데, 같은 레벨에서 Opus 5보다 더 깊게 생각하는 경향이 있어요(공식 문서 표현). 즉 Opus 5에서 high로 쓰던 감각으로 5.5에서 high를 걸면 토큰이 더 나갈 수 있습니다. 공식 권장은 "예전 설정을 그대로 가져오지 말고 medium부터 다시 써보고 필요할 때만 올려라"예요. 전 medium으로 며칠 써보고 판단할 생각이에요.

/effort medium

💡 /model 피커에서 Enter는 저장(다음 세션에도 유지), s는 이번 세션만 — 이 규칙은 그대로예요.

환경변수로 별칭을 고정하는 방법도 있어요. 팀에서 "검증 전까지 Opus 5 유지" 같은 정책이 필요할 때 씁니다.

# Windows PowerShell — 이 터미널 창에서만 유효
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5"
claude

# macOS / Linux
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
claude

• ANTHROPIC_DEFAULT_OPUS_MODEL : opus 별칭이 가리킬 정확한 버전을 고정(pin). 이걸 걸어두면 /model opus·opusplan·default가 전부 여기 적힌 모델을 타요

📌 3단계 - API로 직접 쓰는 분: 호환성 깨지는 변경 4가지

Claude Code만 쓰신다면 이 단계는 건너뛰셔도 돼요. 파이썬으로 API를 직접 호출하시는 분은 모델 ID만 바꾸면 400 에러가 날 수 있는 지점이 넷 있어요.

1. thinking을 끌 수 없음 — thinking: {"type": "disabled"}나 budget_tokens를 직접 주는 enabled는 400. thinking 필드를 아예 빼거나 {"type": "adaptive"}로 두고, 깊이는 effort로 조절
2. 강제 도구 호출 불가 — tool_choice의 any·tool 타입은 400. auto(기본) + strict: true로 바꾸고, 도구를 꼭 쓰게 하고 싶으면 프롬프트에 명시
3. thinking 블록이 모델·대화에 묶임 — Opus 5 → 5.5로 대화를 옮기는 건 추론이 유지되지만, 5.5 → Sonnet 5처럼 내려가면 이전 추론이 버려져요(요청은 성공). 2026-08-31 이후 만든 계정은 thinking 블록 앞의 시스템 프롬프트·도구를 바꿔서 재전송하면 400
4. 구형 컴퓨터 사용 도구 computer_20251124 미지원 (Claude API·Google Cloud) — computer_toolset_20260801로 이전

그리고 에러는 아니지만 도구 호출 사이의 짧은 텍스트가 text가 아니라 thinking 블록으로 와요. 진행 상황을 화면에 흘려주던 앱이라면 갑자기 조용해지니 thinking.display 설정을 확인하세요.

최소 이전 예제입니다. 키·모델명은 .env에서 읽어요. 복붙 OK 👇

# anthropic 1.8.0 / python-dotenv 1.2.3 / Python 3.10+
from dotenv import load_dotenv
import os
from anthropic import Anthropic

load_dotenv()
api_key = os.getenv("ANTHROPIC_API_KEY")
model = os.getenv("CLAUDE_MODEL", "claude-opus-5-5")  # .env: CLAUDE_MODEL=claude-opus-5-5

client = Anthropic(api_key=api_key)

response = client.messages.create(
    model=model,
    max_tokens=4096,
    # thinking 필드는 생략 (Opus 5.5는 adaptive가 항상 켜짐)
    # tool_choice는 생략 = auto
    messages=[{"role": "user", "content": "파이썬으로 폴더 안 .txt 파일 개수를 세는 함수 짜줘"}],
)

# 응답 블록은 위치가 아니라 type으로 골라야 해요 (앞에 thinking 블록이 올 수 있음)
for block in response.content:
    if block.type == "text":
        print(block.text)

.env 파일은 이렇게요. .gitignore에 .env 꼭 넣으세요!

ANTHROPIC_API_KEY=여기에_키
CLAUDE_MODEL=claude-opus-5-5

하나씩 뜯어볼게요 💡

• load_dotenv() : 같은 폴더의 .env를 읽어 환경변수로 올려줘요. 키·모델명을 코드에 박지 않는 습관, 이 블로그의 기본이에요
• CLAUDE_MODEL : 모델명도 환경변수로 빼두면 Opus 5 ↔ 5.5 전환을 코드 수정 없이 .env 한 줄로 해요
• block.type 검사 : Opus 5.5는 응답 맨 앞에 thinking 블록(기본 설정에선 내용이 비어 있음)이 붙을 수 있어서 content[0].text처럼 위치로 꺼내면 깨집니다. type으로 거르세요
• effort : 필요하면 output_config={"effort": "high"}처럼 올려요. 기본은 medium

💬 이 블로그의 LLM 연동 시리즈(디스코드 봇 #9, 업무 자동화 #5)는 로컬 LLM(LM Studio) 기준이라 위 변경과 무관해요. 유료 API를 쓰는 분만 해당됩니다.

🛠️ GitHub Copilot·클라우드에서 쓰기

Claude Code 밖에서도 같은 날 열렸어요.

• GitHub Copilot : 9월 22일부터 Copilot Pro+·Max·Business·Enterprise에서 모델 선택기에 Opus 5.5가 추가됐어요. 사용량 기반 과금에서는 프로바이더 정가로 청구됩니다. GitHub 측 초기 테스트에서는 Opus 5보다 절반 이하의 스텝으로 터미널 작업을 더 많이 풀었다고 해요
• AWS·Google Cloud·Microsoft Foundry : 출시 당일 동시 제공. 모델 ID는 Bedrock만 anthropic.claude-opus-5-5, 나머지는 claude-opus-5-5
• Claude Code 별칭 주의 : Bedrock·Google Cloud에서도 opus는 5.5를 가리키지만, Microsoft Foundry는 아직 opus = Opus 4.6이에요. Foundry에선 정식 ID로 직접 지정해야 합니다

💡 지금 뭘 골라야 할까? (Sonnet 5.5 나오기 전까지)

작업 유형별로 정리하면 이래요.

Opus 5 vs 5.5는 고민할 게 없어요. 같은 값이면 5.5가 더 좋고, 심지어 더 싸요. 굳이 Opus 5에 남을 이유는 "팀 검증이 안 끝났다" 정도뿐입니다. 진짜 고민은 Fable 5.1을 계속 쓸 것인가인데, 공식 발표문이 "대부분의 작업에서 Fable 5.1 수준"이라고 못 박은 만큼, Fable은 Opus 5.5의 xhigh로도 안 풀리는 문제에만 남겨두는 게 지갑에 좋아요.

📌 자주 나는 에러·실수

1. /model 목록에 Opus 5.5가 없다 / claude-opus-5-5를 치니 "does not support this model"

• 원인 : Claude Code가 v2.1.280 미만
• 해결 : claude update 후 재시작. 사내 게이트웨이를 쓰는 경우엔 게이트웨이가 claude-opus-5-5를 서빙하도록 설정돼야 해요

2. 업데이트했더니 Pro 플랜인데 한도가 금방 닳는다

• 원인 : v2.1.280부터 Pro의 기본 모델이 Sonnet 5 → Opus 5.5로 바뀜
• 해결 : 가벼운 작업은 /model sonnet으로 내리기, 또는 opusplan. 아예 Sonnet을 기본으로 두려면 settings.json에 "model": "sonnet"

3. 분명히 /effort medium을 저장했는데 5.5에선 다른 레벨로 뜬다

• 원인 : effort 저장은 정식 ID별. claude-opus-5에 저장한 값은 5.5에 안 넘어옴
• 해결 : Opus 5.5가 켜진 상태에서 /effort medium을 다시 저장하거나, modelSettings에 claude-opus-5-5 항목 추가

4. API에서 "thinking.type.disabled" is not supported for this model (400)

• 원인 : Opus 5.5는 thinking을 끌 수 없음
• 해결 : thinking 파라미터 삭제 → output_config.effort를 low로 낮추는 걸로 대체

5. API에서 tool_choice: type "tool" and "any" are not supported for this model (400)

• 원인 : 강제 도구 호출 미지원
• 해결 : tool_choice를 auto로, 스키마 강제는 strict: true 또는 structured outputs로

6. 응답에서 response.content[0].text가 AttributeError

• 원인 : 맨 앞 블록이 thinking(내용 빈 값)일 수 있음
• 해결 : for block in response.content: if block.type == "text"처럼 type으로 필터

7. 보안 리서치 코드베이스에서 세션이 갑자기 Opus 4.8로 바뀐다

• 원인 : Opus 5.5의 안전 분류기가 사이버보안으로 판정 → Opus 4.8로 폴백(생물학은 Opus 5로)
• 해결 : 정상 동작이에요. 매번 확인받고 싶으면 /config에서 Switch models when a message is flagged를 끄기

🙌 마무리

오늘 내용을 정리하면 이래요.

• Opus 5.5 = Fable 5.1급 성능을 $4 / $20에. Opus 5보다 단가 20% ↓, 캐시 읽기 60% ↓, 실제 작업 비용 40% ↓, 출력 30% ↑
• Claude Code v2.1.280부터 opus·default가 전부 Opus 5.5. Pro도 이제 기본이 Opus라서 한도 감각을 다시 잡으세요
• settings.json의 modelSettings에 claude-opus-5-5 항목을 새로 넣어야 effort가 먹음. 기본 effort는 medium, 예전 high 감각을 그대로 가져오지 말 것
• API 직접 호출은 thinking 끄기·강제 tool_choice·구형 computer 도구 세 가지가 400 에러. 응답 블록은 type으로 고르기
• Sonnet 5.5·Haiku 5.5는 수 주 내 예고. 나오면 후속 글로 다시 정리할게요

다음 편은 디스코드 봇 만들기 시리즈 #32로 돌아오고, 10월 1일 파이썬 3.15 정식 출시에 맞춘 신기능 총정리도 준비 중이에요. 기대해주세요 🙌

혹시 이미 Opus 5.5로 갈아타신 분, 체감이 어떠세요? 특히 medium effort로 쓸 만한지 댓글로 알려주시면 다음 글에 반영할게요!

📚 함께 보면 좋은 글

• 클로드 코드(Claude Code) 모델 변경·effort 설정 완전 정리 - Opus 5 / Sonnet 5 / Fable 5.1 골라 쓰는 법
• Claude Opus 5 출시! Claude Code 기본 모델 교체 - /model·/effort 활용법 총정리
• Claude Sonnet 5 출시 - Claude Code 기본 모델 교체, 달라진 점과 활용법
• Claude Code 입문 - 설치부터 첫 실행까지! 터미널 AI 코딩 에이전트 완벽 가이드
• AI 코딩 프롬프트 잘 쓰는 법 - 바이브코딩 실전 가이드
• 무료 AI 코딩 도구 비교 2026 - Claude Code vs Cursor vs 코파일럿