Claude Opus 5 출시! Claude Code 기본 모델 교체 - /model·/effort 활용법 총정리 🚀

안녕하세요! Mojangcam입니다 😎

지난 7월 11일에 Claude Sonnet 5 출시 소식을 정리해 드렸는데요. 그로부터 딱 2주 만에 더 큰 소식이 나왔어요. 2026년 7월 24일, Anthropic이 Claude Opus 5를 출시했습니다!

이번 모델은 그냥 "조금 더 똑똑해졌어요" 수준이 아니에요. 공식 문서에서 아예 "step-change improvement(계단식 도약)"라고 표현할 정도고, Claude Code의 기본 모델까지 바뀌었습니다. 게다가 가격은 그대로예요.

오늘 글에서는 Opus 5가 뭐가 달라졌는지, 그리고 Claude Code에서 /model·/effort 명령어로 어떻게 써먹는지까지 한 번에 정리해 볼게요!

🧠 Claude Opus 5, 왜 화제인가요?

한 줄로 요약하면 이래요. "최상위 모델(Fable 5)에 가까운 성능을, 절반 가격에."

현재 Claude 모델 라인업을 표로 보면 위치가 확 와닿습니다.

포인트는 가격이 이전 세대인 Opus 4.8과 똑같다는 거예요. 성능은 크게 올랐는데 요금은 동결이라, 사실상 같은 돈으로 더 좋은 모델을 쓰게 된 셈이죠 👀

공식 문서가 꼽은 개선 포인트는 이렇습니다.

• 에이전틱 코딩 : 여러 파일에 걸친 기능 구현·대규모 리팩터링을 중간에 stub이나 placeholder 남기지 않고 끝까지 마무리
• 깊은 추론 : 긴 문제 사슬을 여러 단계에 걸쳐 유지
• 코드 리뷰·버그 탐지 : 한 번 훑을 때 실제 버그를 많이 찾아내고 오탐(false positive)은 적음
• 롱 컨텍스트 : 1M 토큰 창 전체에서 지시 이행·툴 호출 품질 유지
• 낮은 effort에서의 효율 : low·medium으로도 꽤 좋은 품질

특히 세 번째, 코드 리뷰가 강해졌다는 게 우리 같은 1인 개발자한테는 제일 반가운 부분이에요. 리뷰해 줄 동료가 없잖아요 😅

🧩 달라진 점 1 - 생각(thinking)이 기본 ON

Opus 4.8까지는 thinking: {"type": "adaptive"}를 직접 켜야 모델이 생각을 했어요. Opus 5부터는 아무것도 안 적어도 기본으로 켜집니다.

# Claude API / anthropic SDK 기준
# Opus 4.8 → 이렇게 해야 thinking이 켜졌어요
response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=8000,
    thinking={"type": "adaptive"},   # ← 명시 필요
    messages=[{"role": "user", "content": "..."}],
)

# Opus 5 → thinking 필드 없어도 기본 ON
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=8000,
    messages=[{"role": "user", "content": "..."}],
)

하나씩 뜯어볼게요 💡

• thinking : 모델이 답변 전에 스스로 생각을 정리하는 과정이에요. 켜져 있으면 정확도가 올라가지만 토큰을 더 씁니다.
• adaptive : 얼마나 생각할지를 모델이 알아서 정하는 모드예요. Opus 5에선 이게 기본값이라 값을 안 넘겨도 동일하게 동작합니다.
• max_tokens : ⚠️ 여기가 함정! max_tokens는 생각 + 답변을 합친 총 출력 상한이에요. thinking이 켜지면서 토큰을 더 먹으니, Opus 4.8 때 쓰던 값을 그대로 두면 답변이 중간에 잘릴 수 있어요. 넉넉히 올려주세요.

🧩 달라진 점 2 - effort(노력 수준)가 훨씬 중요해졌어요

Opus 5는 effort를 올린 만큼 결과가 좋아지는 정도가 이전 Opus보다 확실해졌어요. 그래서 이제 effort를 아무거나 두면 손해입니다.

사용 가능한 단계는 5개예요.

API에서 max까지 올리는 예제는 이렇게 씁니다.

# anthropic SDK / Python 3.8+
import anthropic

client = anthropic.Anthropic()

with client.messages.stream(
    model="claude-opus-5",
    max_tokens=64000,
    output_config={"effort": "max"},   # low / medium / high / xhigh / max
    messages=[
        {"role": "user", "content": "짝수 두 개를 더하면 왜 항상 짝수인지 설명해줘."}
    ],
) as stream:
    response = stream.get_final_message()

print(response)

output_config : effort를 넘기는 자리예요. Opus 5는 thinking이 기본 ON이라 thinking 필드는 아예 안 넣어도 됩니다.

⚠️ 그리고 깨지기 쉬운 변경(breaking change) 하나! Opus 5에서 thinking: {"type": "disabled"}는 effort가 high 이하일 때만 허용돼요. xhigh나 max에서 생각을 끄려고 하면 400 에러가 납니다. Opus 4.8에선 서로 무관했던 부분이라, 기존 코드를 옮길 때 꼭 확인하세요.

🛠️ Claude Code에서 Opus 5 쓰기 (제일 중요!)

자, 여기가 오늘의 핵심이에요. Claude Code의 기본 모델이 Opus 5로 교체됐습니다.

준비물

• Claude Code v2.1.219 이상 ← ⚠️ 필수! 이 버전 미만에서는 opus가 여전히 Opus 4.8로 해석돼요
• Claude 구독(Pro·Max 등) 또는 Anthropic API 키

먼저 업데이트부터 하고 가죠.

claude update
claude --version

내 플랜의 기본 모델은?

계정 종류에 따라 default가 가리키는 모델이 달라요.

즉 Max 쓰시는 분은 그냥 켜면 Opus 5, Pro 쓰시는 분은 기본이 Sonnet 5라 직접 바꿔줘야 해요.

📌 1단계 - /model로 모델 바꾸기

세션 도중에 바로 바꿀 수 있어요.

/model opus

인자 없이 /model만 치면 피커(선택 화면)가 열립니다. 여기서

• Enter : 모델을 바꾸고 앞으로의 기본값으로도 저장
• s : 이번 세션에서만 변경

자주 쓰는 별칭(alias)도 정리해 둘게요.

• default : 내 계정에 맞는 권장 모델로 되돌리기 (모델 오버라이드 해제)
• opus : 최신 Opus 모델 → 지금은 Opus 5
• sonnet : 최신 Sonnet 모델
• haiku : 가볍고 빠른 작업용
• best : 조직에 Fable 5 접근 권한이 있으면 Fable 5, 없으면 최신 Opus
• opusplan : 플랜 모드에선 opus, 실행 단계에선 sonnet으로 자동 전환하는 하이브리드 모드

마지막 opusplan이 은근 알짜예요. 설계는 똑똑한 모델로, 코드 찍어내기는 빠른 모델로 나눠 쓰니까 비용이 확 절약되거든요 💡

시작할 때부터 지정하고 싶으면 플래그로 넘기면 됩니다.

claude --model opus

📌 2단계 - /effort로 사고 깊이 조절하기

/effort

인자 없이 치면 슬라이더가 뜨고, 바로 지정할 수도 있어요.

/effort xhigh
/effort auto

• /effort <레벨> : 레벨 직접 지정
• /effort auto : 모델 기본값으로 리셋
• --effort <레벨> : 실행할 때 한 세션만 지정
• CLAUDE_CODE_EFFORT_LEVEL : 환경변수로 지정 (다른 모든 방식보다 우선순위 높음)
• settings 파일의 effortLevel : low·medium·high·xhigh만 가능 (max는 세션 전용)

low~xhigh는 세션이 끝나도 유지되고, max는 현재 세션에서만 적용돼요.

그리고 Opus 5만의 특징이 하나 있어요. Fable 5·Opus 4.8·Opus 4.7은 처음 실행할 때 "모델 기본 effort"를 강제로 물리는데, Opus 5는 그 홀드가 없어서 이전에 설정해 둔 레벨이 그대로 넘어옵니다. 예전에 low로 맞춰뒀다면 Opus 5도 low로 돌고 있을 수 있으니 한 번 확인해 보세요!

📌 3단계 - settings 파일에 고정하기

매번 치기 귀찮으면 설정 파일에 박아두면 됩니다.

{
  "model": "opus",
  "effortLevel": "high"
}

한 가지 더, ultrathink라는 키워드도 있어요. 프롬프트 아무 곳에나 이 단어를 넣으면 그 턴만 더 깊게 생각하게 만들 수 있습니다. 반대로 "think hard", "think more" 같은 말은 그냥 평범한 문장으로 처리되니 참고하세요 😉

💡 알아두면 좋은 추가 변경점

• 프롬프트 캐시 최소 길이 인하 : Opus 4.8은 1,024토큰 이상이어야 캐시가 됐는데, Opus 5는 512토큰부터 캐시돼요. 코드 수정 없이 캐시 적중률이 올라갑니다.
• 대화 중간 툴 변경(베타) : 세션 도중 툴을 추가·제거하면서 프롬프트 캐시를 유지할 수 있어요. mid-conversation-tool-changes-2026-07-01 베타 헤더 필요.
• Fast mode(리서치 프리뷰) : Claude API에서만 제공되며, $10/$50의 프리미엄 요금으로 출력 속도를 끌어올립니다.
• 응답이 길어졌어요 : 기본 답변과 산출물이 이전보다 길어지고, 에이전트 세션에선 진행 상황을 더 자주 설명해 줍니다.
• 스스로 검증합니다 : 시키지 않아도 자기 작업을 검증해요. 그래서 예전 모델용으로 써둔 "마지막에 검증 단계를 넣어라" 같은 프롬프트는 오히려 과잉 검증을 유발하니 지우는 게 좋습니다.

📌 자주 나는 에러

1. /model opus를 했는데 Opus 4.8이 뜬다

• 원인 : Claude Code 버전이 v2.1.219 미만이라 opus 별칭이 아직 Opus 4.8을 가리킴
• 해결 : claude update 실행 후 claude --version으로 버전 확인

2. 400 error — thinking을 껐는데 요청이 거부됨

• 원인 : Opus 5에서 thinking: {"type": "disabled"}는 effort가 high 이하일 때만 허용. xhigh·max와 함께 쓰면 400
• 해결 : effort를 high 이하로 내리거나, thinking 필드를 아예 제거

3. 답변이 중간에 뚝 끊긴다

• 원인 : thinking이 기본 ON이 되면서 max_tokens(생각+답변 합계)를 초과
• 해결 : max_tokens를 넉넉히 상향. xhigh·max effort라면 특히 크게 잡아주세요

4. Pro 플랜인데 Opus 5가 안 잡힌다

• 원인 : Pro·Team Standard·Enterprise 구독 시트의 기본값은 Sonnet 5
• 해결 : /model opus로 직접 선택. 기본으로 굳히려면 피커에서 Enter로 저장

5. effort를 안 건드렸는데 답이 성의 없다

• 원인 : 예전 모델에서 low·medium으로 설정해 둔 값이 Opus 5로 그대로 승계됨 (Opus 5는 기본값 홀드가 없음)
• 해결 : /effort auto로 모델 기본값(high)으로 리셋

💬 그래서, 지금 바꿔야 하나요?

제 결론은 "Max 쓰시면 이미 바뀌어 있으니 effort만 확인, Pro 쓰시면 복잡한 작업에서만 /model opus"예요.

왜냐면 Opus 5는 응답이 길어지고 thinking이 기본으로 켜지는 만큼 토큰을 더 먹거든요. 간단한 오타 수정이나 짧은 함수 작성까지 Opus 5 + high로 돌릴 필요는 없어요. 그럴 땐 sonnet이나 opusplan이 훨씬 경제적입니다.

반대로 여러 파일을 건드리는 리팩터링, 버그 원인 추적, 코드 리뷰 같은 작업이라면 Opus 5의 값어치를 확실히 합니다. 저도 실제로 리팩터링 작업에서 체감 차이가 컸어요!

🙌 마무리

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

• Claude Opus 5가 2026년 7월 24일 출시 — Fable 5급 성능을 절반 가격($5/$25)에
• thinking이 기본 ON, max_tokens는 생각+답변 합계이니 상향 필요
• effort 5단계(low~max), 기본은 high. xhigh·max에선 thinking 비활성화 불가
• Claude Code는 v2.1.219 이상 필수. /model opus, /effort, opusplan 조합이 핵심
• Max는 기본 Opus 5, Pro는 기본 Sonnet 5

다음 편에서는 디스코드 봇 데이터 저장 - JSON vs SQLite 어느 걸 써야 할까?를 준비하고 있어요. 그리고 이번 달 마지막 날에는 무료 AI 코딩 도구 비교 2026(Claude Code·Cursor·Copilot)으로 월말 결산도 예정돼 있으니 기대해주세요 🙌

혹시 Opus 5로 바꾸고 나서 체감이 어떠셨는지, 댓글로 알려주시면 다음 글에 반영할게요!

📚 함께 보면 좋은 글

• Claude Sonnet 5 출시 - Claude Code 기본 모델 교체, 달라진 점과 활용법
• Claude Code 입문 - 설치부터 첫 실행까지 터미널 AI 코딩 에이전트 완벽 가이드
• Cursor 사용법 입문 - AI 코드 에디터 설치부터 Tab·Ctrl+K·에이전트까지