Claude Opus 5 업데이트 방법과 사용법 정리
Opus 5와 현재 opus 별칭을 구분하고 클로드 코드에서 실제 모델을 확인합니다. 작은 메모 실습, 설치 방식별 업데이트, 추론 노력과 Fast 별도 결제 조건을 안내합니다.
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
2026년 7월에 공개된 Opus 5
앤트로픽이 2026년 7월 24일 Claude Opus 5를 공개했습니다. API 모델 이름은 claude-opus-5이고, 클로드 앱, 클로드 코드, Claude Cowork, Claude API에서 같은 날부터 쓸 수 있습니다.
이 글은 Opus 5를 실제로 쓰기까지 필요한 절차를 정리한 것입니다. 클로드 코드 업데이트 명령어, 모델 선택 방법, 모델 목록에 Opus 5가 보이지 않을 때 확인할 항목, effort 레벨 조절, 요금 조건 순으로 다룹니다. 출시 사례는 7월 자료이고, 모델 선택과 요금 안내는 2026년 10월 4일 공식 문서 기준입니다. 모델은 답변을 만드는 AI이고 클로드 코드는 모델과 연결해 작업하는 앱이므로, 앱 업데이트와 모델 선택은 다른 단계입니다.
후속 버전의 내용은 클로드 Opus 5.5 출시에 정리했습니다. Opus 5.5는 2026년 9월 22일 공개됐고, 달라진 점과 요금, 함께 지급된 한도 초기화권을 그 글에 정리했습니다.
아래는 7월 공식 발표의 벤치마크, 즉 같은 시험 과제로 비교한 성능 표입니다. 현재 전체 모델의 순위표는 아닙니다.
에이전틱은 모델이 도구를 사용하며 여러 단계를 진행한다는 뜻입니다. 공식 발표 기준으로 Opus 5는 에이전틱 터미널 코딩(Frontier-Bench v0.1)에서 43.3%를 기록해 Opus 4.8의 21.1%보다 높은 점수를 받았습니다. 컴퓨터 사용(OSWorld 2.0)과 업무 자동화(AutomationBench) 항목에서도 이전 Opus 모델보다 높은 값이 표시되어 있습니다. 내 작업의 성공률을 예측하는 수치는 아니며, 행마다 평가 방식이 달라 숫자를 그대로 합치지 않습니다.
사용할 수 있는 모델과 기본 모델 구분하기
모델을 쓸 수 있다는 것과 새 대화에서 자동으로 선택된다는 것은 다릅니다. Pro와 Max, 팀과 기업 플랜에서도 지원 여부와 조직의 허용 설정을 확인해야 합니다. API는 프로그램에서 AI를 호출하는 방식이며 구독과 별도 사용량 요금이 적용됩니다.
현재 Claude Code 문서에서는 v2.1.280 이후 일반적인 직접 연결 환경의 기본 모델을 Opus 5.5로 안내합니다. opus 별칭도 이 환경에서는 5.5를 가리킵니다. Microsoft Foundry 등 연결 제공자나 조직 설정에 따라 결과가 달라질 수 있으므로 실제 표시된 모델 이름을 기준으로 봅니다. 현재 모델 설정
Opus 5를 명시하려면 직접 연결 환경에서 claude-opus-5를 사용합니다. 조직이 허용하지 않은 모델은 전체 이름을 적어도 사용할 수 없습니다. 이 글을 따라 하기 위해 플랜을 바꾸거나 API 키를 새로 만들 필요는 없습니다.
클로드 코드에서 Opus 5로 모델을 변경하는 방법
클로드 코드라는 도구 이름이 생소하실 수 있습니다. 터미널에서 자연어로 파일 읽기와 코딩 작업을 시키는 앤트로픽 공식 도구입니다. 터미널은 명령어를 입력하는 프로그램입니다. 앱을 실행하기 전의 명령과 앱 대화 안의 명령을 나눠 설명하겠습니다. 설치 전이라면 설치 안내를 먼저 봅니다.
Step 1. 현재 버전 확인
터미널을 열고 아래 명령어를 실행합니다.
claude --version버전 번호가 출력됩니다. Opus 5 도입 당시 최소 버전은 v2.1.219였습니다. 그보다 낮으면 설치 방식에 맞게 업데이트합니다. 명령을 찾지 못한다면 모델 문제로 보지 말고 설치와 실행 경로부터 확인합니다.
Step 2. 업데이트 실행
자체 설치 프로그램으로 설치한 경우의 명령입니다. Homebrew나 WinGet 설치는 바로 아래의 해당 명령을 사용합니다.
claude update네이티브 설치 방식으로 설치했다면 백그라운드에서 자동 업데이트가 진행되지만, 즉시 최신 버전으로 올리고 싶을 때는 이 명령어를 직접 실행하면 됩니다. Homebrew로 설치한 경우에는 brew upgrade claude-code를 씁니다. WinGet 설치는 winget upgrade Anthropic.ClaudeCode를 사용합니다. 설치 방식이 기억나지 않으면 claude doctor의 진단과 기존 설치 기록을 먼저 확인합니다.
업데이트가 끝나면 claude --version을 다시 실행해 v2.1.219 이상인지 확인합니다.
Step 3. 모델 전환
일반 터미널에서 작업 폴더를 연 뒤 claude를 실행합니다. 클로드 코드의 대화 입력란에 다음 명령을 입력하면 모델 선택 화면이 열립니다.
/model현재 모델을 메모하고, 사용할 모델과 요금 안내를 봅니다. 목록에서 원하는 모델을 고른 뒤 s를 누르면 이번 세션에만 적용하고 Enter는 기본값으로 저장합니다. 처음 비교할 때에는 세션 한정으로 선택할 수 있습니다.
목록 선택 대신 한 세션을 따로 시작하는 방법도 있습니다. 직접 연결 환경에서 Opus 5를 명시하려면 새 일반 터미널 창에서 같은 작업 폴더를 열고 다음 명령을 사용합니다. 실행 중인 AI 대화 입력란에 넣는 명령은 아닙니다.
claude --model claude-opus-5실행 뒤 대화 입력란에 /status를 입력해 실제 모델을 확인합니다. /model claude-opus-5처럼 대화 안에서 바로 지정할 수도 있지만 이 선택은 기본값에도 저장될 수 있습니다. /model opus는 현재 Opus 5.5 등 다른 버전을 선택할 수 있으므로 이 글의 5 버전 고정 명령으로 사용하지 않습니다.
첫 요청: 작은 일정 메모로 확인하기
현재 계정의 포함 모델로도 할 수 있는 연습입니다. 클로드 코드 대화 입력란에 다음 블록을 붙여 넣습니다. AI가 폴더를 수정할 필요가 없는 가상 메모입니다.
아래 메모만 한 문장 안내문으로 정리해 주세요.
파일을 읽거나 수정하지 말고, 설치나 외부 발송 없이 채팅에만 답해 주세요.
없는 정보는 만들지 마세요.
독서 모임: 10월 12일 오후 2시, 도서관 2층
준비물: 책 한 권답변에 날짜, 시간, 장소와 준비물이 모두 들어갔는지 확인합니다. 요청하지 않은 도구를 실행하려 한다면 Esc로 멈추고 실행 내용을 확인합니다. 예약이나 발송을 했다고 말하기만 한 경우에도 실제 완료로 믿지 말고, 안내문 텍스트만 다시 요청합니다.
이어서 날짜만 10월 19일로 바꾸고 나머지는 유지해 주세요라고 입력합니다. 10월 19일 외에 시간이나 장소가 바뀌었다면 원래 값인 오후 2시와 도서관 2층을 알려주고 해당 부분을 고칩니다. 답변 문장을 직접 확인한 뒤 끝냅니다.
혼자 반복할 때는 새 대화에 위 지시문을 다시 붙이고 메모만 산책 모임: 10월 20일 오전 10시, 공원 입구 / 준비물: 물 한 병으로 교체합니다. 이전 독서 모임의 정보가 섞이지 않아야 합니다. 모델을 바꿔 비교하더라도 같은 자료와 확인 기준을 사용합니다. 비교를 마치면 /model에서 메모해 둔 원래 모델로 돌아가고 /status로 확인합니다.
Opus 5가 모델 목록에 보이지 않을 때 확인해야 할 4가지
모델 선택 화면에 Opus 5 항목이 없다면 다음을 확인합니다.
- 버전:
claude --version으로 앱 버전을 확인하고 설치 방식에 맞게 업데이트합니다. - 플랜과 결제: 해당 모델의 이용 조건과 추가 결제 안내를 확인합니다.
- 조직 설정: 회사 계정은 관리자가 특정 모델을 제한했는지 확인합니다.
- 별칭과 제공자:
opus와 특정 모델 ID를 구분하고 연결 제공자가 지원하는 이름을 확인합니다.
업데이트만으로 계정 권한이나 조직 제한이 풀리는 것은 아닙니다. 해결되지 않으면 버전, 선택하려는 모델과 민감 정보를 지운 오류 문구를 함께 전달합니다.
클로드 앱과 데스크톱 앱에서 Opus 5 선택하기
웹 claude.ai와 데스크톱 앱에서는 새 대화의 모델 선택 메뉴를 확인합니다. Opus 5가 제공되면 선택하고 실제 표시 이름을 봅니다. 앱과 Code의 기본 모델을 같다고 가정하지 않습니다.
모델이 없다면 플랜과 조직 권한을 먼저 확인합니다. 데스크톱 앱의 업데이트나 재실행은 앱 표시 문제를 확인하는 방법이지, 모든 계정에 모델을 열어 주는 방법은 아닙니다.
effort: 추론에 들이는 노력 조절하기
effort는 모델이 답을 내기 전에 추론에 들일 노력을 조절하는 값입니다. 높이면 토큰 사용량과 대기 시간이 늘 수 있지만 모든 작업의 품질이 반드시 올라가지는 않습니다. 토큰은 글을 처리하는 단위이며 한글 글자 수와 같지 않습니다. 클로드 코드에서 실제로 지정하는 값을 아래 표에 정리했습니다.
Opus 5는 다섯 단계를 모두 지원합니다.
| 레벨 | 쓰는 상황 |
|---|---|
low | 범위가 좁고 빠른 응답이 중요한 작업 |
medium | 비용을 줄이면서 어느 정도 품질을 유지할 때 |
high | 기본값. 대부분의 작업에 적합 |
xhigh | 토큰을 더 쓰더라도 깊은 추론이 필요할 때 |
max | 더 깊은 추론을 시험할 때 사용하며 정확도 보장은 아님 |
클로드 코드 세션에서 다음과 같이 조절합니다.
/effort
Opus 5의 기본 effort는 high이지만 개인이나 조직 설정이 우선할 수 있습니다. 현재 값을 메모하고 바꿉니다. 선택 화면에서 s로 이번 세션에만 적용할 수 있으며, /effort medium처럼 직접 지정하면 이후 기본값으로 저장될 수 있습니다.
아래는 앤트로픽이 공개한 effort 레벨별 성능과 비용 관계 차트입니다.
가로축은 시도당 비용이며 로그 눈금이라 같은 화면 간격이 같은 달러 차이를 뜻하지 않습니다. 세로축은 평가 점수입니다. Opus 5의 마지막 점은 바로 앞 점보다 낮아, 비용을 더 썼다고 언제나 점수가 높아지지는 않음을 보여줍니다. 모든 작업에 max를 쓸 이유는 없고, high에서 시작한 뒤 결과가 아쉬울 때만 한 단계 올리는 편이 무난합니다.
Fast 모드와 요금 조건
Fast 모드는 지원하는 Opus 모델의 응답 속도를 높이는 별도 옵션입니다. 현재 Code에서는 Opus 5.5, 5와 4.8을 지원합니다. 이 글의 Opus 5 일반 API 단가는 입력 100만 토큰당 5달러, 출력 25달러이고 Fast 단가는 10달러와 50달러입니다. 다른 모델에도 같은 달러 값을 적용하지 않습니다. Fast 공식 안내
구독에서 Fast는 포함 한도가 아니라 사용량 크레딧으로 별도 결제합니다. 이번 메모 연습에는 필요하지 않습니다. 현재 상태를 확인하려면 /fast 메뉴의 켜짐과 꺼짐 안내를 확인하고, 원치 않으면 꺼진 상태로 둡니다. 선택은 다음 세션에도 유지될 수 있습니다.
가격을 감 잡으려면 계산기로만 비교할 수 있습니다. 캐시나 도구 비용이 없는 입력 1만 토큰과 출력 2천 토큰을 가정하면 일반은 0.05 + 0.05 = 0.10달러, Fast는 0.10 + 0.10 = 0.20달러입니다. 실제 토큰 수와 별도 비용에 따라 청구액은 달라집니다.
구독의 남은 사용량은 /usage나 계정 사용량 화면에서 확인합니다. 모델별 제한이 표시되더라도 전체 한도와 함께 적용될 수 있으므로, 두 한도를 독립적인 잔액처럼 더하지 않습니다.
API 연동을 만드는 개발자가 확인할 사항
이 부분은 API 연동을 직접 만드는 개발자용입니다. 앱만 사용하는 분은 설정할 필요 없이 넘어가도 됩니다. 아래 코드는 실행 실습이 아니라 오류 조합을 설명하는 예시입니다.
첫째, 추론(thinking)이 기본으로 사용 설정돼 있습니다. Opus 4.8과 Opus 4.7에서는 thinking 값을 넘기지 않으면 추론 없이 동작했지만, Opus 5는 값을 생략하면 적응형 추론이 적용됩니다. max_tokens는 추론과 응답을 합친 상한이므로, 기존에 응답 길이만 기준으로 max_tokens를 빠듯하게 잡아둔 코드는 응답이 중간에 잘릴 수 있습니다.
둘째, 추론을 해제하는 조건에 제한이 생겼습니다. thinking을 disabled로 지정하는 것은 effort가 high 이하일 때만 허용됩니다. xhigh나 max와 함께 쓰면 400 오류가 반환됩니다.
# Opus 5에서 400 오류가 나는 조합
client.messages.create(
model="claude-opus-5",
max_tokens=4096,
thinking={"type": "disabled"},
output_config={"effort": "xhigh"}, # high 이하여야 허용됨
messages=[...],
)프롬프트 캐싱을 쓴다면 캐시 최소 길이가 512토큰으로 낮아진 점도 참고할 만합니다. Opus 4.8에서는 1024토큰이었기 때문에, 짧아서 캐시가 되지 않던 프롬프트가 코드 수정 없이 캐시 대상이 되는 경우가 생깁니다.
자주 묻는 질문
Opus 5로 바꾸면 기존 대화나 프로젝트 설정이 사라지나요?
사라지지 않습니다. 모델 전환은 이후 응답을 어떤 모델이 처리할지 정하는 설정이라, 대화 기록이나 프로젝트 파일에는 영향이 없습니다. 다만 클로드 코드에서 대화 도중 모델을 바꾸면 다음 응답이 이전 대화 전체를 캐시 없이 다시 읽기 때문에, 캐시가 남아 있는지와 앱 버전 등에 따라 선택 화면에 확인 안내가 나올 수 있습니다.
Pro 플랜에서도 Opus 5를 쓸 수 있나요?
지원되는 계정에서는 선택할 수 있습니다. 다만 현재 가장 높은 모델이나 기본 모델은 고정되어 있지 않으므로 내 선택 화면과 요금 조건을 봅니다. 특정 5 버전이 필요하다면 별칭이 아닌 실제 모델 이름을 확인합니다.
claude update를 실행해도 버전이 그대로면 어떻게 하나요?
설치 방식에 따라 업데이트 경로가 다릅니다. Homebrew로 설치했다면 brew upgrade claude-code를 실행합니다. 설치 방식이 기억나지 않으면 claude doctor와 기존 설치 기록을 확인합니다. 계속 같다면 다른 경로의 설치본을 실행하는지 확인하며, 원인을 모른 채 설치본을 덮어쓰지 않습니다.
effort는 어떤 값으로 두는 것이 좋을까요?
기본값인 high로 두고 시작하면 됩니다. 응답이 필요 이상으로 오래 걸리거나 토큰 사용량을 줄이고 싶을 때 medium으로 내리고, 복잡한 리팩터링처럼 정확도가 중요한 작업에서만 xhigh나 max로 올리는 방식이 무난합니다. 모든 작업을 max로 돌릴 필요는 없습니다.
8컷 만화로 정리한 Opus 5가 보이지 않을 때
아래는 2026년 7월 안내를 바탕으로 만든 기존 만화입니다. 현재의 기본 모델과 별칭은 본문을 기준으로 확인합니다. 2컷의 ‘가장 흔한 원인’은 발생 빈도를 측정한 결과가 아니며, 6컷처럼 effort를 올려도 점수가 항상 오르지는 않습니다. 7컷의 두 배는 Opus 5 API 단가 비교이고 구독 포함을 뜻하지 않습니다. 8컷의 한도는 독립 잔액처럼 해석하지 말고 현재 사용량 화면에서 전체 및 모델별 제한을 함께 확인합니다.
그림은 DGX Spark에서 Qwen-Image-2.1로 그렸고, 대사는 글과 대조해 따로 얹었습니다. 주황 로봇은 클로드를 사람처럼 그린 것입니다.
만화 대사 전문
- (2026년 7월 24일, Opus 5 공개) 민준: 목록에 그 항목이 안 보여요. / 준이아빠: 네 가지를 차례로 확인하면 돼요.
- (가장 흔한 원인은 버전) 준이아빠: 버전이 낮으면 항목 자체가 안 나와요. / 민준: 먼저 업데이트하라는 거죠?
- (목록에 있어도 기본은 아니다) 민준: 저는 목록엔 있는데요. / 준이아빠: 플랜에 따라 기본이 달라서 직접 골라야 해요.
- (관리자가 꺼 둔 경우) 민준: 회사 계정에서는 아예 안 보이던데요. / 준이아빠: 관리자가 꺼 두면 목록에서 빠져요.
- (별칭이 이전 모델을 가리킬 때) 준이아빠: 어떤 환경에서는 opus라는 별칭이 이전 버전을 가리켜요. / 민준: 전체 이름을 적으면 되네요.
- (effort는 다섯 단계) 민준: 항상 맨 위로 두면 낫지 않나요? / 준이아빠: 올릴수록 비용은 커지고 점수가 오르는 폭은 줄어요.
- (Fast 모드는 요금이 두 배) 준이아빠: 속도가 올라가는 대신 요금이 두 배예요. / 민준: 기다리는 사람이 있을 때만 쓰겠어요.
- (한도는 따로 관리된다) 민준: 전에 쓰다 남은 한도가 넘어오나요? / 준이아빠: 따로 관리돼서 이어지지 않아요.
참고 자료
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
Opus 5를 선택하려는데 목록에 보이지 않습니다. 어떻게 확인하나요?
이 글이 도움이 되었나요?
모델 이름보다 먼저 알아야 할 환각, 컨텍스트, 프롬프트 기본을 다룹니다
- 1클로드(Claude) 이해하기: 입문자를 위한 앤트로픽 AI 어시스턴트 소개
- 2앤트로픽(Anthropic) 이해하기: 클로드를 만든 회사
- 3클로드 모델 패밀리: 내 작업에 맞는 모델 비교하기
새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.