Opus 5.5로 Claude Code 작업 비용 줄이는 설정
Claude Code에서 Opus 5.5로 작업 한 건을 맡기면 얼마가 들고, 무엇을 바꾸면 줄어드는지 정리했습니다. 토큰 단가는 Opus 5보다 20~60% 내렸지만 실제 비용은 요청 횟수와 캐시 재사용에 따라 달라집니다. effort 단계, 모델 나눠 쓰기, 캐시 지키는 법, /usage 확인법까지 순서대로 정리했습니다.
정정 (2026년 10월 3일): 원래 업데이트 명령을 "claude --update"로 썼으나 "claude update"로 고쳤습니다. 재시도 비용 계산과 하위 에이전트의 기본 모델 조건도 블로그 원문에 맞게 고쳤습니다.
Claude Code에서 Opus 5.5를 쓰면 작업 한 건에 얼마가 들까요? 앤트로픽은 9월 25일 Claude 개발자 블로그에 이 질문에 숫자로 답한 글을 올렸습니다. 결론은 단가보다 모델이 몇 번 오가며 일했는지와 캐시를 얼마나 다시 썼는지가 비용에 더 큰 영향을 준다는 것입니다. 같은 단가라도 코드를 한 번 읽고 끝내는 모델과, 읽고 고치고 다시 읽는 모델은 비용이 크게 다릅니다. 이 가이드는 블로그 원문을 직접 확인해, 그 글의 계산과 설명을 기준으로 비용을 줄이는 설정을 순서대로 정리했습니다. 금액은 모두 API 정가 기준입니다.
시작하기 전에 필요한 것
Opus 5.5는 Claude Code v2.1.280 이상에서 쓸 수 있습니다. 버전이 낮으면 터미널에서 claude update로 먼저 업데이트합니다. 모델은 /model로 바꾸고, 지금 쓰는 모델과 비용은 /usage로 봅니다(/cost도 같은 화면입니다).
1. 비용이 어디서 나오는지 알아 두기
Claude Code는 같은 과정을 되풀이하며 일합니다. 모델이 대화를 읽고, 도구를 쓰고, 결과를 읽고, 다시 대화를 읽습니다. 이 과정 한 번이 요청 한 번이고, 요청할 때마다 지금까지의 대화 전체를 다시 보냅니다. 블로그 예시로 보면, 대화가 2만 에서 12만 토큰까지 커지는 작업을 40번 요청으로 끝내면 입력 비용이 약 1.62달러, 25번으로 끝내면 약 1.02달러입니다. 요청 한 번의 비용은 그때 새로 붙은 내용만큼이 아니라, 앞의 대화 전체를 다시 보내는 만큼 듭니다.
다시 보내는 내용의 대부분은 캐시에서 읽힙니다. 는 입력 단가의 20분의 1입니다. 같은 280만 토큰도 캐시를 하나도 못 쓰면 11.20달러, 90%를 캐시에서 읽으면 1.62달러입니다. 블로그는 입력 비용에 이만큼 영향을 주는 설정은 따로 없다고 적었습니다.
출력은 가장 비싼 토큰입니다. Opus 5.5의 출력 단가는 캐시 읽기의 100배이고, 모델이 답하기 전에 생각하는 토큰도 출력으로 계산됩니다. 화면에 요약만 보여도 생각한 만큼은 모두 청구됩니다.
Opus 5.5의 API 정가는 100만 토큰당 입력 4달러, 출력 20달러, 캐시 읽기 0.2달러입니다. Opus 5보다 입력·출력은 20%, 캐시 읽기는 60% 내렸습니다. 블로그가 같은 토큰량(캐시 읽기 200만, 새 입력 20만, 출력 6만)으로 계산한 작업은 Opus 5에서 3.50달러, Opus 5.5에서 약 31% 적게 나옵니다. Pro·Max·Team 구독이라면 같은 한도로 Opus 5보다 약 25% 더 쓸 수 있다고 앤트로픽은 설명했습니다.
2. effort는 medium에서 시작하고, 막히면 high로 올리기
effort는 모델이 한 번 요청할 때 생각하고, 글을 쓰고, 도구를 호출하는 데 을 얼마나 쓸지 정하는 설정입니다. Opus 5.5에는 low, medium, high, xhigh 네 단계가 있고, 한 세션에만 적용되는 max가 따로 있습니다.
low— 이름 바꾸기, 정해진 패턴을 여러 파일에 적용하기 같은 기계적인 일medium— 범위가 분명한 일상 작업. Opus 5.5의 기본값입니다.high—medium으로 풀리지 않을 때xhigh— 어려운 문제max— 한 세션에서만 쓰는 최고 단계
Claude Code에서 /effort만 입력하면 단계를 고르는 화면이 뜹니다. 좌우 방향키로 고르고 Enter로 정하며, s를 누르면 지금 세션에만 적용됩니다. 화면 오른쪽 끝의 ultracode는 xhigh에 워크플로를 더한 단계로 표시됩니다.
Claude 데스크톱 앱에서는 입력창 아래 모델 이름 옆의 단계 표시(기본값 중간)를 누르면 노력 슬라이더가 열립니다. 왼쪽이 더 빠르게, 오른쪽이 더 스마트하게입니다.
터미널에서는 /effort high처럼 단계를 붙여 실행해도 되고, 바꾼 단계는 다음 요청부터 적용됩니다. /effort status로 지금 단계를 확인할 수 있습니다.
주의할 점이 하나 있습니다. Opus 5의 기본값은 high였지만 Opus 5.5는 medium입니다. 같은 단계라도 Opus 5.5가 한 번에 더 많이 생각하고, xhigh와 max에서 차이가 가장 큽니다. 그래서 Opus 5에서 쓰던 단계를 그대로 가져오지 말고 medium부터 시작하라고 블로그는 권합니다.
high로 올려서 이득인 경우는 재시도를 한 번이라도 줄여 줄 때입니다. 블로그 계산으로는 high가 작업 전체에서 생각 토큰을 2만 개 더 쓰면 0.40달러인데, 캐시에 10만 토큰이 쌓인 대화에서 열 턴짜리 재시도 루프에서 출력 1만 토큰을 합쳐 쓰는 비용도 이와 비슷합니다. medium으로 한 번에 끝났을 작업이라면 그 0.40달러는 쓰지 않아도 됐을 돈입니다.
올리기 전에 확인할 것도 있습니다. 모델이 스스로 결과를 점검할 수단이 있는지입니다. 블로그 예시에서는 API의 필드 이름을 바꾸는 작업을 medium으로 맡기자 서버 코드만 고치고 그 필드를 쓰는 클라이언트 코드는 그대로 뒀습니다. high에서는 호출하는 곳을 더 읽어 두 곳을 한 번에 고쳤습니다. 그런데 클라이언트까지 거치는 테스트가 있으면 medium에서도 바로 드러납니다. 테스트는 한 번 실행하는 비용만 들지만, 를 올리면 모든 요청에 생각 토큰이 붙습니다.
API 키나 Claude 구독으로 쓸 때는 작업 도중에 effort를 바꿔도 캐시가 유지됩니다. 어려운 단계에서만 올렸다가 다시 내려도 됩니다. 반면 아마존 베드록, 구글 클라우드, Claude 앱 게이트웨이에서는 effort를 바꾸면 캐시가 비워져 다음 요청에서 대화 전체를 다시 캐시에 씁니다. 이 경우에는 작업이 일단락됐을 때 바꿉니다.
3. 모델을 용도별로 나눠 쓰기
모델은 모든 의 단가를 정하기 때문에 보다 비용에 더 크게 영향을 줍니다. 블로그는 모델을 용도별로 나눠 쓰라고 권합니다.
- Opus 5.5 — 평소 작업. 여러 파일에 걸친 기능 작업, 디버깅, 코드 리뷰 뒤 수정처럼 사람이 지켜보며 하는 일에 씁니다.
- Fable 5.1 — 결과가 토큰값보다 중요할 때. 지켜보지 않고 오래 실행하는 작업, 코드베이스에 비슷한 예가 없는 문제, 하위 () 여러 개를 함께 쓰는 큰 변경에 씁니다. Opus 5.5를
xhigh로 실행해도 같은 문제에서 두 번 막히면 바꾸고, 풀리면 다시 돌아옵니다. Fable 5.1은 입력 10달러, 출력 50달러로 Opus 5.5의 2.5배지만, 는 0.25달러로 1.25배라서 캐시를 많이 쓰는 긴 작업에서는 차이가 작습니다. - Sonnet·Haiku — 찾기와 읽기. 파일 찾기와 요약, 로그·테스트 결과 읽기, "이게 어디 정의돼 있지" 같은 질문을 맡는 하위 에이전트에 씁니다. 코드 수정은 맡기지 않습니다. 여러 파일에 같은 수정을 하는 기계적인 작업은 Opus 5.5에 두고 effort만
low로 내립니다.
하위 에이전트를 작은 모델로 실행하려면 그 에이전트 정의에 model: haiku나 model: sonnet을 적습니다. 모든 하위 에이전트를 한 모델로 실행하려면 CLAUDE_CODE_SUBAGENT_MODEL 환경변수를 씁니다. 에이전트 정의에 적은 모델이 환경변수보다 우선합니다. 에이전트 정의에도 환경변수에도 모델을 적지 않은 하위 에이전트는 메인 모델로 실행되고, 요금도 메인 모델 기준으로 나갑니다.
모델을 바꿀 때는 작업이 일단락됐을 때 바꿉니다. 캐시는 모델마다 따로라서 새 모델의 첫 요청은 대화 전체를 캐시에 새로 씁니다. 바꾸기 전에 /compact로 대화를 줄이거나, 짧은 계획만 적어 새 세션을 여는 편이 쌉니다. /model로 고른 모델은 이후 새 세션의 기본값으로도 저장되니, 어려운 부분이 끝나면 다시 돌려놓습니다.
실험 기능인 에이전트 팀(agent teams)은 따로 주의해야 합니다. 팀원마다 별도의 Claude Code가 실행되고, 블로그가 인용한 공식 비용 문서에 따르면 팀원이 계획 모드(plan mode)로 실행될 때 일반 세션의 약 7배 토큰을 씁니다. 팀은 작게 꾸리고, 맡은 일이 끝난 팀원은 바로 종료합니다.
4. 캐시가 깨지는 경우 피하기
캐시는 요청의 앞부분이 이전 요청과 똑같을 때만 다시 쓰입니다. 대화 끝에 새 내용만 붙여 가는 세션은 캐시가 계속 살아 있고, 앞부분을 바꾸는 일은 캐시를 깹니다. 는 5분짜리가 입력 단가의 1.25배, 1시간짜리가 2배라서 읽기보다 훨씬 비쌉니다. 12만 대화라면 Opus 5.5에서 5분 캐시 쓰기가 약 0.60달러, 읽기가 약 0.02달러입니다.
캐시가 유지되는 시간은 쓰는 방식에 따라 다릅니다. Claude 구독은 1시간, API 키나 클라우드는 기본 5분이고, 구독도 사용량 크레딧을 쓰기 시작하면 5분으로 줄어듭니다. 캐시를 한 번 읽으면 유지 시간이 그때부터 다시 늘어납니다. API 키로 쓴다면 6분 쉬고 돌아온 다음 요청은 0.02달러짜리 읽기가 아니라 0.60달러짜리 쓰기가 됩니다.
블로그가 꼽은, 캐시를 새로 쓰게 되는 경우는 다음과 같습니다.
- 캐시 유지 시간보다 오래 쉬었을 때
- 베드록·구글 클라우드·게이트웨이에서 를 바꿨을 때
- 대화 중간에 처음으로 고속 모드(fast mode)를 켰을 때
- 서버를 연결하거나 끊었을 때
- 모델을 바꿨을 때
- 대화가 압축됐을 때
이런 설정은 세션을 시작할 때 정해 두고, 작업하는 동안은 건드리지 않습니다. 고속 모드는 Opus 5.5를 최대 2.5배 빠르게 실행하는 대신 단가가 두 배(입력 8달러, 출력 40달러)이고, 켠 직후 첫 요청은 대화 전체를 캐시 없이 고속 모드 단가로 보냅니다. 켤 거라면 세션 처음에 켭니다.
세션을 시작할 때 자동으로 불러오는 내용도 줄입니다. CLAUDE.md 파일은 모든 요청에 함께 보내지므로, 블로그가 인용한 공식 비용 문서는 200줄 아래로 두라고 권합니다. /mcp로 연결된 서버를 보고 쓰지 않는 것은 끕니다.
5. /clear와 /compact를 쓰는 때 구분하기
대화가 길어질수록 요청 한 번의 비용도 커집니다. 캐시가 살아 있어도 Opus 5.5에서 2만 대화의 는 한 번에 약 0.004달러, 15만 토큰이면 약 0.03달러입니다. 15만 토큰에서 30번 요청하면 읽기에만 0.90달러, 2만 토큰이면 약 0.12달러입니다. 한 시간 전의 오류 기록, 이미 끝낸 파일, 고친 뒤의 옛 테스트 결과도 모든 요청에 계속 함께 보내집니다.
/clear— 대화를 비웁니다. 비용이 들지 않으니, 관련 없는 다른 작업으로 넘어갈 때 씁니다./compact— 지금까지의 대화를 요약해 이어 갑니다. 요청 한 번만큼 비용이 들고, 남길 것을 적어 줄 수 있습니다. 예:/compact 실패한 테스트 이름과 스키마 변경은 남겨 줘
블로그 계산으로 15만 토큰에서 /compact는 약 0.25달러이고, 이후 요청마다 약 0.025달러씩 아껴 열 번쯤 요청하면 압축 비용을 회수합니다. 작업을 끝내기 직전의 압축은 아끼는 것보다 쓰는 게 많습니다. 압축은 쉬기 전에 합니다. 캐시가 살아 있을 때는 요약 요청이 캐시에서 대화를 읽지만, 캐시가 사라진 뒤에는 15만 토큰을 다시 읽고 다시 써서 5분 캐시 기준으로 입력만 약 0.75달러가 듭니다. 작업 방향이 틀려 되돌리고 싶다면 압축 대신 /rewind로 앞선 지점에 돌아가는 편이 쌉니다.
요약하면서 세부 내용이 빠질 수 있다는 점도 기억해 둡니다. 디버깅 도중에 압축하면 중요한 로그 한 줄이 사라질 수 있으니, 다음 단계에 꼭 필요한 것은 /compact 뒤에 적어 줍니다.
6. 예전 모델에 맞춰 쓴 지시문 점검하기
옛 모델에 맞춰 쓴 지시문은 Opus 5.5가 글을 더 길게 쓰고 같은 도구를 되풀이해 호출하게 만들 수 있습니다. Claude Code에서 /claude-api prompt-audit를 실행하면 이나 CLAUDE.md 같은 설정에 그런 지시가 있는지 점검해 줍니다.
앤트로픽은 고객 지원 티켓 44건으로 된 내부 평가로 이를 시험했습니다. Opus 4.8에서 Opus 5.5(low)로 옮기자 비용이 약 18% 줄었고, -audit으로 지시문을 고치자 약 9%가 더 줄어 처음보다 약 25% 낮아졌습니다. 이때 걷어 낸 것은 여섯 단계를 반드시 거치라는 절차, 중간 메모를 남기라는 규칙, 두 번 확인하라는 규칙, 서로 부딪히는 지시였습니다. 블로그도 평가 하나에서 나온 결과라 예시로만 보라고 적었습니다.
7. /usage로 결과 확인하기
작업이 끝나면 /usage를 실행합니다. Session 항목에 사용한 과 정가 기준 예상 비용이 나오고, 입력 중 캐시에서 읽은 비율도 따로 나옵니다. Pro·Max·Team·Enterprise 구독이라면 같은 화면에 요금제 사용량 막대도 보입니다. 이 금액은 내 컴퓨터에서 정가로 계산한 것이라, 구독자에게는 청구서가 아니라 작업량을 가늠하는 숫자입니다.
블로그는 이 화면에서 세 가지를 보라고 합니다.
- 캐시 비율. 긴 세션이라면 높아야 합니다. 낮다면 오래 쉬었는지, 모델을 바꿨는지, 도중에 서버를 연결했는지 봅니다. 캐시 항목에 마지막으로 캐시를 못 쓴 원인이 적혀 있는 경우가 많습니다.
- 입력 대비 출력. 작은 수정에 출력이 많다면 가 작업에 비해 높거나 모델이 재시도하고 있다는 뜻입니다.
- 대화 크기 대비 전체 입력. 전체 입력이 대화 크기의 몇 배라면 요청을 여러 번 한 것입니다. 대화를 읽어 어디서 같은 일을 되풀이했는지 찾아볼 만합니다.
Opus 5와 비교해 보려면 실제 작업 하나를 골라 /model로 두 모델에 한 번씩 맡기고, 요청 횟수와 출력 토큰, 비용을 적어 둡니다. 블로그는 결론을 내기 전에 서너 건은 해 보라고 권합니다. 팀 단위라면 Claude Code Analytics API로 사용자별 예상 비용을, Usage and Cost API로 모델별·캐시 여부별 지출을 볼 수 있습니다.
기준으로 삼을 숫자도 있습니다. 블로그가 인용한 공식 비용 문서에 따르면 기업 환경에서 개발자 한 명이 하루 쓰는 비용은 평균 약 13달러이고, 사용자의 90%가 하루 30달러 아래입니다. 여기까지 설정했다면 /usage의 캐시 비율과 출력량이 평소보다 어떻게 달라졌는지로 효과를 확인할 수 있습니다.
