클로드 코드 플랜과 사용량 한도 이해하기
클로드 코드는 유료 구독에 포함된 사용량으로 쓰거나 API 토큰 요금으로 씁니다. 구독 사용량은 5시간 세션 한도와 주간 한도에서 차감되고, 클로드 채팅과 같은 한도를 씁니다.
같은 말:클로드 코드 프로클로드 코드 플랜클로드 코드 구독클로드 코드 요금세션 한도주간 한도클로드 캐시클로드 코드 캐시세션 압축opusplan
클로드 코드로 한창 작업하다가 "한도에 도달했습니다"라는 메시지를 처음 만나면 두 가지가 궁금해집니다. 돈을 더 내야 하는지, 언제 다시 쓸 수 있는지입니다. 답은 어떤 방식으로 결제했는지와 어느 한도에 걸렸는지에 따라 달라집니다.
클로드 코드는 앤트로픽(Anthropic)이 만든 AI 코딩 도구입니다. 터미널이나 데스크톱 앱에서 내 컴퓨터의 파일을 읽고 고치는 일을 맡깁니다. 지금부터 클로드 코드의 결제 방식, 한도가 차감되는 구조, 한도 메시지를 읽는 법을 차례로 살펴봅니다.
클로드 코드 입문
한도 계기판으로 보는
클로드 코드의 월요일 하루
Pro 플랜을 쓰는 김 대리의 월요일입니다.
시각 버튼을 누르면 세션 막대와 주간 막대가 그 시각의 모습으로 바뀝니다.
09:00
이번 주 새로 시작
김 대리가 결제 페이지 전체를 새 디자인에 맞게 고쳐 달라고 맡깁니다.
월요일 시각 고르기
가상 예시입니다. 실제 퍼센트는 작업 크기, 모델, 생각 수준(effort)에 따라 달라집니다.
클로드 코드 구독에는 5시간 세션 한도와 주간 한도가 함께 있습니다.
한도 메시지가 나오면 어느 쪽이 찼는지, 언제 다시 열리는지부터 봅니다.
한도 메시지는 경고등처럼
종류마다 할 일이 다릅니다
경고등을 누르면 화면에 나오는 원문 메시지와 그 뜻, 할 일이 나옵니다.
경고등을 누르면 이 설명 칸에 그 경고등 메시지의 뜻과 할 일이 나옵니다.
빨간 등은 지금 막힌 상태를, 호박색 등은 아직 쓸 수 있다는 경고를, 파란 등은 사용량과 관계없는 안내를 뜻합니다. 실제 화면에는 다시 열리는 시각이 같은 줄에 함께 나옵니다.
세션 한도가 찼을 때
무엇이 통할까요?
12시 10분, 김 대리의 세션 막대가 100%입니다.
흔히 시도하는 방법의 버튼을 하나씩 누르면 막대가 어떻게 바뀌는지 볼 수 있습니다.
사용 크레딧 꺼짐
세션 한도 도달
You've hit your session limit 메시지가 떠 있습니다.
시도해 볼 방법
가상 예시입니다. Team과 Enterprise에서 결제 권한이 없는 구성원은 사용 크레딧을 직접 켤 수 없고, 확인 창을 거쳐 관리자에게 요청이 전달됩니다.
/usage 화면은
줄마다 뜻이 다릅니다
클로드 코드 입력창에 /usage를 입력하면 열리는 화면입니다. 궁금한 줄을 누르면 그 줄의 설명이 나옵니다.
> /usage
터미널의 줄을 누르면 이 설명 칸에 그 줄의 뜻이 나옵니다.
실제 화면 구성을 옮긴 목업입니다. 사용량 막대는 구독으로 로그인했을 때만 보이고, /cost나 /stats를 입력해도 같은 화면이 열립니다.
도구마다 사용량을 보는 방법이
따로 있습니다
클로드 코드, Codex CLI, Gemini CLI 가운데 하나를 고르면
그 도구의 내장 명령과 따로 설치하는 오픈소스 도구의 명령이 나옵니다.
/usage내장
> /usage세션 한도와 주간 한도 막대, 초기화 시각, 세션 비용 추정치, 사용 내역 분석을 한 화면에 보여 줍니다.
/cost,/stats를 입력해도 같은 화면이 열립니다.플랜 막대는 Pro, Max, Team, Enterprise 구독에서 보입니다.
상태 표시줄내장 설정
> /statusline 5시간 한도와 주간 한도 퍼센트를 보여 줘입력창 아래 한 줄에 사용량을 계속 띄워 둡니다. 원하는 표시를 말로 적으면 클로드 코드가 표시 스크립트를 만들어 설정에 넣습니다.
한도 퍼센트는 Pro, Max 구독에서 첫 응답이 끝난 뒤부터 들어옵니다.
ccusage오픈소스
$ npx ccusage@latest daily $ npx ccusage@latest monthly $ npx ccusage@latest blocks내 컴퓨터에 남은 대화 기록을 읽어 날짜별, 월별 토큰과 API 정가 기준 비용, 5시간 단위 묶음을 표로 보여 줍니다.
설치 없이 npx로 실행하며 Node.js가 필요합니다. 로컬 기록으로 계산한 추정치라
/usage의 퍼센트와 다를 수 있습니다.Claude Code Usage Monitor오픈소스
$ uv tool install claude-monitor $ claude-monitor터미널에 실시간 진행 막대와 사용 속도, 앞으로의 소진 예측을 띄웁니다.
pip install claude-monitor로도 설치합니다.Python 3.9 이상이 필요합니다. 로컬 기록으로 계산한 추정치입니다.
2026년 10월 22일 각 공식 문서와 저장소 기준입니다. ccusage와 Claude Code Usage Monitor는 앤트로픽이나 오픈AI가 아닌 커뮤니티가 만든 오픈소스입니다.
한도 메시지를 만나면 이 순서로 확인합니다
- 1
/status로 구독 로그인인지 API 로그인인지 먼저 확인합니다. - 2
메시지를 읽고 세션, 주간, 모델, 지출 한도 가운데 어느 한도에 걸렸는지 구분합니다.
- 3
/usage에서 다시 열리는 시각을 보고 기다릴지 정합니다. - 4
급하면 월 지출 한도를 정한 뒤 사용 크레딧을 켜고, 매주 막히면 플랜을 올립니다.
클로드 코드 요금은 구독과 API 두 가지 방식입니다
클로드 코드를 쓰려면 둘 중 하나로 로그인합니다. 하나는 클로드 구독 계정이고, 다른 하나는 API 계정(Claude Console)입니다. API는 프로그램이 모델을 직접 호출하는 방식이고, 토큰은 모델이 글을 읽고 쓰는 단위입니다.
| 방식 | 내는 돈 | 한도 | 어울리는 사람 |
|---|---|---|---|
| 구독 플랜(Pro, Max, Team, Enterprise) | 매달 정해진 구독료 | 5시간 세션 한도와 주간 한도 | 개인 작업, 매일 쓰는 실무자 |
| API 종량제(Claude Console) | 쓴 토큰만큼 청구 | 직접 정한 지출 한도 | 자동화, 회사 계정, 비용을 토큰 단위로 관리하는 팀 |
구독으로 로그인하면 구독료 안에서 쓰고, 한도에 걸리면 기다리거나 사용 크레딧을 켭니다. API로 로그인하면 구독 한도는 없지만 쓴 만큼 요금이 계속 붙습니다. 같은 사람이 두 방식을 모두 갖고 있을 수도 있습니다. 컴퓨터에 ANTHROPIC_API_KEY 환경 변수가 설정되어 있으면 구독 대신 API 키로 청구되므로, 지금 어느 쪽으로 로그인했는지 먼저 확인합니다. 클로드 코드 입력창에 /status를 입력하면 현재 계정과 모델이 나옵니다.
무료 플랜으로는 클로드 코드를 쓸 수 없습니다. 개인 플랜에서 클로드 코드가 들어 있는 플랜은 Pro, Max 5x, Max 20x 세 가지입니다.
| 항목 | Free | Pro | Max 5x | Max 20x |
|---|---|---|---|---|
| 월 요금 | 0달러 | 20달러 | 100달러 | 200달러 |
| 클로드 코드 | 없음 | 있음 | 있음 | 있음 |
| 5시간 세션당 사용량 | 없음 | 기준 | Pro의 5배 | Pro의 20배 |
| 기본 모델 | 없음 | Opus 5.5 | Opus 5.5 | Opus 5.5 |
| Fable 5.1 | 없음 | 사용 크레딧으로만 | 주간 한도의 50%까지 | 주간 한도의 50%까지 |
| 사용 크레딧 켜기 | 없음 | 됨 | 됨 | 됨 |
표의 가격은 2026년 10월 21일 한국에서 연 claude.com 가격표 기준이고 세금은 별도입니다. Max는 월 결제만 되고, Pro는 연 결제 200달러도 됩니다. 하루 1~2시간 작은 수정 위주라면 Pro에서 시작합니다. 하루 종일 큰 작업을 맡긴다면 Max 5x가, 서브에이전트나 여러 창을 함께 돌린다면 Max 20x가 맞는 편입니다.
표에서 눈여겨볼 곳은 Fable 5.1 줄입니다. Fable 5.1은 앤트로픽의 가장 높은 등급 모델입니다. Pro에서는 플랜 한도에 들어가지 않고 처음부터 사용 크레딧으로만 쓰고, Max에서는 주간 한도의 절반까지 추가 비용 없이 씁니다. 클로드 코드의 기본 모델은 모든 구독에서 Opus 5.5라서, 따로 바꾸지 않으면 Fable 요금은 생기지 않습니다. 회사에서 쓰는 Team과 Enterprise 플랜은 좌석 단위로 계약하고, 좌석 종류에 따라 한도 크기가 다릅니다.
구독 사용량은 5시간 세션 한도와 주간 한도에서 차감됩니다
구독 사용량에는 시간 단위가 두 개 있습니다. 5시간 세션 한도는 5시간 단위로 다시 채워지는 사용량입니다. 이 한도는 짧은 시간에 사용량을 몰아서 쓰는 것을 막습니다. 주간 한도는 한 주 동안 쓸 수 있는 전체 양이고, 계정마다 정해진 요일과 시각에 초기화됩니다. 세션 한도가 남아 있어도 주간 한도를 다 쓰면 초기화 시각까지 쓸 수 없습니다.
| 한도 | 다시 채워지는 주기 | 알아 둘 점 |
|---|---|---|
| 5시간 세션 한도 | 5시간 | 무료 플랜을 포함한 모든 플랜에 있습니다 |
| 주간 한도 | 7일 | 계정마다 정해진 요일과 시각에 초기화됩니다 |
두 한도는 클로드 채팅과 클로드 코드가 함께 씁니다. 웹, 데스크톱, 모바일의 클로드 대화도 같은 양에서 차감됩니다.
한도에는 "메시지 몇 개" 같은 고정 숫자가 없습니다. 대화 길이, 작업의 복잡도, 고른 모델과 생각 수준(effort)에 따라 한 번에 차감되는 양이 달라집니다. 그래서 화면에는 남은 양이 퍼센트로만 보입니다.
두 한도가 함께 움직이는 모습을 하나의 예로 보겠습니다. Pro 플랜을 쓰는 마케터 김 대리가 월요일 오전 9시에 클로드 코드를 켜고 회사 홈페이지의 결제 페이지를 새 디자인에 맞게 고쳐 달라고 맡겼습니다. 여러 파일을 읽고 고치는 큰 작업이라, 11시 반쯤 세션 한도가 거의 찼습니다. 이 주에 쓴 양은 주간 한도의 3분의 1 정도입니다.
가상 예시로, 11시 30분에 /usage를 열면 세션 막대는 92%, 이번 주 막대는 34%입니다. 세션 한도는 오후 2시에 다시 채워지고, 주간 한도는 여유가 있어 그 뒤에 다시 작업할 수 있습니다.
김 대리는 오후 2시까지 기다리면 다시 작업할 수 있습니다. 반대로 주간 한도가 92%였다면 세션 한도가 다시 채워져도 곧 막힙니다. 그래서 한도 메시지가 나오면 어느 한도가 찼는지부터 봐야 합니다.
클로드 코드 한도 메시지는 종류마다 할 일이 다릅니다
작업 중에 보이는 안내는 비슷해 보여도 뜻이 다릅니다. 김 대리의 터미널에는 한도가 85%에 닿았을 때 미리 경고가 나오고, 다 차면 한도 메시지가 나왔습니다.
| 메시지 | 뜻 | 할 일 |
|---|---|---|
You've used 85% of your session limit | 세션 한도에 가까워짐 | 지금 작업을 마무리할 지점을 정합니다 |
You've hit your session limit 또는 weekly limit | 플랜 전체 사용량이 찼음 | 표시된 시각까지 기다리거나 사용 크레딧을 켭니다 |
You've hit your Opus limit 또는 Sonnet limit | 그 모델 계열만 막혔음 | /model로 다른 계열 모델을 골라 이어 갑니다 |
You've hit your monthly spend limit | 사용 크레딧의 월 지출 한도에 닿았음 | 결제 설정에서 지출 한도를 올리거나 다음 달을 기다립니다 |
| 컨텍스트 경고, 자동 요약 안내 | 대화 하나가 너무 길어졌음 | 요약을 기다리거나 /compact, /clear로 정리합니다 |
마지막 줄은 사용량 한도와 관계가 없습니다. 컨텍스트 윈도우는 모델이 한 번에 참고할 수 있는 대화의 길이입니다. 대화를 정리하면 컨텍스트 경고는 사라지지만, 이미 차감된 세션 한도는 돌아오지 않습니다.
| 흔한 오해 | 실제 |
|---|---|
| 모델을 Sonnet이나 Haiku로 바꾸면 세션 한도가 다시 열린다 | 세션 한도와 주간 한도는 모든 모델이 함께 씁니다. 모델을 바꾸면 이후 차감 속도는 달라지지만, 찬 한도는 그대로입니다 |
/clear로 대화를 지우면 쓴 양이 돌아온다 | /clear는 다음 요청부터 보낼 대화를 줄입니다. 이미 차감된 양은 초기화 시각까지 그대로입니다 |
| 클로드 채팅과 클로드 코드는 한도가 따로다 | 같은 구독 계정이면 웹, 데스크톱, 모바일 대화와 클로드 코드가 같은 한도에서 차감됩니다 |
/usage로 남은 양과 초기화 시각을 확인합니다
한도가 걱정될 때는 클로드 코드 입력창에 /usage를 입력합니다. /cost나 /stats를 입력해도 같은 화면이 열립니다. 구독으로 로그인했다면 세션 한도와 주간 한도가 막대로 보이고, 각각 언제 다시 채워지는지 시각이 함께 나옵니다.
> /usage
Session ██████████░ 92%
resets 2pm
Week ███░░░░░░░░ 34%
resets Mon 9am
Session cost $4.12위 화면은 실제 화면 구성을 옮긴 목업입니다. 사용량 막대는 구독으로 로그인했을 때만 보입니다.
/usage 화면에서 잘못 읽기 쉬운 곳은 달러 금액입니다. 이 금액은 같은 작업을 API 정가로 했다면 얼마였을지 이 컴퓨터에서 계산한 값이고, 구독 계정에 청구되는 돈이 아닙니다. 실제 API 청구액은 Claude Console의 사용량 화면에서 확인합니다.
같은 화면 아래쪽에는 어떤 작업이 사용량을 많이 썼는지도 나옵니다. 스킬, 서브에이전트, 플러그인, MCP 서버가 각각 몇 퍼센트를 차지했는지 보여 주고, 최근 사용량의 10% 이상을 차지한 원인에는 개선 제안을 붙입니다. d를 누르면 최근 24시간, w를 누르면 최근 7일 기준으로 바뀝니다.
한도가 걱정될 때는 다음 순서로 확인합니다.
/status: 구독 로그인인지 API 로그인인지 확인합니다./usage: 세션 한도와 주간 한도의 남은 양과 초기화 시각을 봅니다./context: 지금 대화가 얼마나 길어졌는지 봅니다./clear또는/compact: 다른 일로 넘어가면/clear로 대화를 비우고, 같은 일을 이어 가면/compact로 요약합니다.
CLI 도구별로 사용량을 모니터링하는 방법
/usage를 매번 입력하기 번거롭다면 사용량을 늘 띄워 두거나 표로 모아 보는 도구를 씁니다. 도구마다 내장 명령이 있고, 따로 설치하는 오픈소스 도구도 있습니다. 오픈소스 도구는 앤트로픽이나 오픈AI가 아닌 커뮤니티가 만든 것이고, 내 컴퓨터에 남은 대화 기록을 읽어 계산합니다. 그래서 서버가 계산하는 /usage 퍼센트와 숫자가 다를 수 있습니다.
| 도구 | 내장 명령 | 설치형 오픈소스 |
|---|---|---|
| 클로드 코드 | /usage, /statusline | ccusage, Claude Code Usage Monitor |
| Codex CLI | /status, /usage | ccusage의 codex 명령 |
| Gemini CLI | /stats, /stats model | 없음 |
클로드 코드: 상태 표시줄에 한도 띄우기
가장 손쉬운 방법은 상태 표시줄입니다. 클로드 코드 입력창에 원하는 표시를 말로 적으면, 클로드 코드가 표시 스크립트를 만들고 설정 파일에 넣어 줍니다.
/statusline 5시간 한도와 주간 한도 퍼센트를 보여 줘상태 표시줄에 넘어오는 값에는 5시간 한도와 7일 한도의 사용 퍼센트, 초기화 시각이 들어 있습니다. 이 한도 값은 Pro, Max 구독에서 첫 응답이 끝난 뒤부터 들어옵니다.
클로드 코드: ccusage와 Claude Code Usage Monitor
ccusage는 설치 없이 npx로 실행합니다. Node.js가 설치되어 있어야 합니다.
npx ccusage@latest daily # 날짜별 토큰과 비용
npx ccusage@latest monthly # 월별 합계
npx ccusage@latest blocks # 5시간 단위 묶음여기 나오는 비용은 같은 사용량을 API 정가로 계산한 값입니다. 구독 계정에 청구되는 돈이 아닙니다. 예전 글에 나오는 ccusage blocks --live는 v18.0.0에서 빠졌으므로 쓰지 않습니다.
Claude Code Usage Monitor는 터미널 창 하나에 실시간 진행 막대와 소진 예측을 띄워 두는 도구입니다. Python 3.9 이상이 필요합니다.
uv tool install claude-monitor # 또는 pip install claude-monitor
claude-monitorCodex CLI와 Gemini CLI
Codex CLI는 입력창에 /status를 입력하면 컨텍스트 사용량과 사용량 한도가 나오고, /usage는 사용량과 결제 설정 화면을 엽니다. 로컬 기록을 표로 모아 보려면 ccusage의 codex 명령을 씁니다. ccusage 문서에는 실험 기능으로 표시되어 있습니다.
npx ccusage@latest codex daily예전에 쓰던 @ccusage/codex 패키지는 폐기되었습니다. Gemini CLI는 /stats로 세션 통계를, /stats model로 모델별 토큰 수와 할당량 정보를 봅니다. 구글은 2026년 6월 18일부터 Google AI Pro, Ultra 구독과 개인 사용자용 구글 코딩 도우미 요금제인 Gemini Code Assist for individuals로 로그인한 Gemini CLI 요청 처리를 중단했습니다.
비유로 보면 휴대폰 데이터 요금제와 닮았습니다
휴대폰 요금제는 단계마다 기본 데이터가 다르고, 동영상처럼 데이터를 많이 쓰는 앱이 있고, 다 쓰면 기다리거나 데이터를 추가로 삽니다. 클로드 코드의 사용량 한도도 같은 순서로 움직입니다.
| 클로드 코드 구독 | 휴대폰 데이터 요금제 |
|---|---|
| Pro, Max 5x, Max 20x | 기본 데이터가 다른 요금제 단계 |
| 5시간 세션 한도 | 하루 데이터 사용 제한 |
| 주간 한도 | 한 달 기본 데이터 총량 |
| 긴 대화, 여러 작업 동시 실행 | 동영상 스트리밍처럼 데이터를 많이 쓰는 앱 |
| 사용 크레딧(usage credits) | 데이터 쿠폰 추가 구매 |
비유가 맞지 않는 곳도 있습니다. 데이터는 몇 GB 남았는지 숫자로 보이지만, 클로드 사용량은 퍼센트로만 보입니다. 같은 요청도 대화 길이와 모델에 따라 차감량이 달라집니다.
비유에서 한 가지를 가져가면 충분합니다. 데이터를 많이 쓰는 앱을 알아야 데이터를 아낄 수 있듯이, 사용량을 많이 쓰는 작업을 알아야 한도를 아낄 수 있습니다. 클로드 코드에서 사용량을 많이 쓰는 작업은 네 가지입니다.
- 길어진 대화: 클로드 코드는 새 질문만 보내지 않고 지금까지의 대화와 읽은 파일 내용을 함께 보냅니다. 대화가 길수록 한 번에 차감되는 양이 커집니다.
- 오래 쉬었다 이어 가기: 같은 내용을 짧은 시간 안에 다시 보내면 캐시가 적용되어 덜 차감됩니다. 캐시는 이미 처리한 내용을 재사용하는 기능입니다. 오래 쉬면 캐시가 사라져 다음 요청이 무거워집니다. 유지 시간은 아래 캐시 절에서 다룹니다.
- 여러 작업 동시 실행: 서브에이전트나 여러 창을 함께 돌리면 각자 대화를 따로 가져 사용량이 그만큼 늘어납니다.
- 큰 모델과 높은 생각 수준: 성능이 높은 모델을 고르거나 effort를 높이면 같은 작업에서도 사용량이 더 많이 차감됩니다.
같은 작업을 이어 가는데 대화가 길어져 응답이 느려졌다면 /compact가 맞습니다. 목표, 바꾼 파일, 남은 일을 요약해 두고 대화 길이만 줄입니다. /clear는 다른 일로 넘어갈 때 씁니다. 모델을 바꾸는 것만으로는 대화 길이가 줄지 않습니다.
캐시와 모델 선택으로 사용량 아끼기
클로드 코드는 요청을 보낼 때마다 시스템 지시, CLAUDE.md, 지금까지의 대화와 읽은 파일 내용을 통째로 다시 보냅니다. 프롬프트 캐시는 앞 요청과 똑같은 앞부분을 다시 처리하지 않고 재사용하는 기능이고, 캐시에서 읽은 부분은 일반 입력보다 낮은 단가로 계산됩니다. 앞부분이 일부라도 바뀌면 바뀐 곳부터 뒤는 모두 다시 처리합니다. 같은 작업이라도 캐시가 살아 있는지에 따라 차감되는 양이 달라지는 이유입니다.
캐시가 유지되는 시간
캐시는 마지막 요청 뒤 일정 시간 동안 다음 요청이 없으면 사라집니다. 요청이 캐시를 읽을 때마다 시간이 다시 시작되므로, 계속 작업하는 동안에는 캐시가 유지됩니다. 클로드 코드가 정하는 기본 유지 시간은 결제 방식과 요청 종류에 따라 다릅니다.
| 요청 종류 | 구독(플랜 포함 사용량 안) | 사용 크레딧, API 키, Amazon Bedrock 같은 클라우드 제공자 |
|---|---|---|
| 내가 직접 주고받는 메인 대화 | 1시간 | 5분 |
| 서브에이전트, 압축 같은 그 밖의 요청 | 5분 | 5분 |
구독 사용자가 플랜 한도를 넘겨 사용 크레딧으로 쓰기 시작하면 메인 대화도 5분으로 바뀝니다. 유지 시간을 직접 정하려면 v2.1.242 이상에서 promptCacheTtl 설정에 5m 또는 1h를 적습니다. 지금 세션에서 캐시가 얼마나 쓰였는지는 /usage 화면의 Prompt cache (main) 줄에서 캐시로 처리한 입력 비율과 캐시를 다시 만든 횟수로 볼 수 있습니다.
캐시를 다시 만드는 행동과 유지하는 행동
아래 행동을 하면 다음 요청 한 번은 캐시 없이 대화 전체를 다시 처리합니다. 그 뒤에는 새 캐시가 다시 쌓입니다.
| 행동 | 캐시 | 이유 |
|---|---|---|
/model로 모델 바꾸기 | 다시 만듦 | 모델마다 캐시가 따로 있습니다 |
opusplan에서 플랜 모드 들어가고 나오기 | 다시 만듦 | 플랜 모드에서는 Opus, 실행 단계에서는 Sonnet을 쓰므로 들어가고 나올 때마다 모델이 바뀝니다 |
| effort(생각 수준) 바꾸기 | 대부분 모델에서 다시 만듦 | Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.1을 구독이나 API 키로 쓸 때는 유지됩니다 |
| fast mode(더 빨리 답하는 대신 요금이 높은 모드) 켜기 | 대화마다 한 번 다시 만듦 | 켠 뒤 첫 요청에 붙는 정보가 바뀝니다 |
/compact로 대화 요약하기 | 대화 부분을 다시 만듦 | 대화 기록이 요약문으로 바뀝니다 |
| 클로드 코드 업데이트 뒤 첫 대화 | 처음부터 다시 만듦 | 새 버전은 시스템 지시나 도구 정의가 바뀝니다 |
반대로 작업 폴더의 파일 수정, 권한 모드 변경(opusplan의 플랜 모드는 제외), 스킬 실행, /rewind는 캐시를 유지합니다. 작업 중에 CLAUDE.md를 고쳐도 캐시는 유지되지만, 고친 내용은 /clear나 /compact를 하거나 클로드 코드를 다시 시작해야 반영됩니다. 그래서 공식 문서는 모델과 effort를 세션을 시작할 때 정하고, /compact는 작업과 작업 사이에 쓰라고 권합니다.
/clear, /compact, /rewind의 비용 차이
세 명령은 모두 대화를 줄이지만 드는 사용량이 다릅니다.
| 명령 | 하는 일 | 드는 사용량 |
|---|---|---|
/clear | 빈 대화로 새로 시작합니다 | 명령 자체는 사용량을 쓰지 않습니다 |
/compact | 지금까지의 대화를 요약하고 요약문으로 이어 갑니다 | 요약을 만드는 요청을 따로 보냅니다. 캐시가 살아 있으면 캐시 없이 대화 전체를 처리할 때보다 훨씬 적게 들지만, 오래 쉬었다가 실행하면 대화 전체를 캐시 없이 다시 읽어 가장 많이 듭니다 |
/rewind | 대화를 이전 지점으로 되돌립니다 | 되돌린 지점까지는 이미 만든 캐시를 그대로 읽습니다 |
방향을 잘못 잡아 최근 대화를 버리고 싶다면 /compact보다 /rewind로 그 앞 지점으로 돌아가는 편이 사용량이 적습니다. 오래 쉬었다가 긴 세션을 다시 열었다면 바로 /compact를 하기보다, 이어 갈 내용을 적어 두고 /clear로 새로 시작하는 편이 사용량이 적습니다.
한도에 걸렸을 때 고를 수 있는 선택지
한도 메시지에는 다시 열리는 시각이 나옵니다. 그 시각을 확인한 뒤 고를 수 있는 선택지는 세 가지입니다. 클로드 코드에서 /rate-limit-options를 입력하면 지금 계정에서 고를 수 있는 선택지가 한 화면에 나옵니다.
- 기다립니다. 세션 한도는 5시간 안에 다시 채워집니다. 급하지 않다면 돈이 들지 않는 방법입니다.
/rate-limit-options에서 초기화된 뒤 작업을 자동으로 이어 가도록 고를 수도 있습니다. - 사용 크레딧을 켭니다. 유료 플랜은 한도를 다 쓴 뒤에도 표준 API 요금으로 계속 쓰게 하는 사용 크레딧(usage credits)을 켤 수 있습니다. 클로드 코드에서
/usage-credits를 입력하면 claude.ai의 설정 > 사용량 화면이 열립니다. 미리 금액을 충전해 두는 방식이고, 월 지출 한도를 함께 정해 두면 예상보다 많이 나가는 일을 막을 수 있습니다. 켜진 뒤에는 화면에 "Now using credits"가 보입니다. - 플랜을 올립니다. 매주 한도에 걸린다면 사용 크레딧을 계속 쓰는 것보다 Max로 올리는 편이 나을 수 있습니다. 클로드 플랜 비교에서 플랜별 차이를 볼 수 있습니다.
사용 크레딧은 구독료와 따로 청구되고, 세션 한도와 주간 한도의 초기화 시각은 바뀌지 않습니다. Team과 Enterprise 플랜에서 결제 권한이 없는 구성원은 사용 크레딧을 직접 켤 수 없고, 확인 창을 거쳐 관리자에게 요청이 전달됩니다. 사용량을 줄이는 명령과 캐시는 앞의 캐시와 모델 선택으로 사용량 아끼기에서 다뤘습니다.
자주 묻는 질문
Pro 플랜으로도 클로드 코드를 쓸 수 있나요?
쓸 수 있습니다. Pro, Max, Team, Enterprise 구독에는 클로드 코드 사용량이 포함되어 있고, 같은 계정으로 로그인하면 바로 씁니다. 무료 플랜에서는 클로드 코드를 쓸 수 없습니다.
모델을 Haiku로 바꾸면 한도가 다시 열리나요?
세션 한도나 주간 한도라면 다시 열리지 않습니다. 두 한도는 모든 모델이 함께 쓰기 때문입니다. "You've hit your Opus limit"처럼 특정 모델 계열을 가리키는 메시지일 때만 다른 계열 모델로 바꿔 이어 갈 수 있습니다.
클로드 채팅을 많이 쓰면 클로드 코드를 덜 쓰게 되나요?
그렇습니다. 같은 구독 계정이라면 웹, 데스크톱, 모바일의 클로드 대화와 클로드 코드가 같은 사용량에서 차감됩니다. 채팅을 오래 한 날은 클로드 코드에 남은 양도 줄어듭니다.
/usage에 나오는 달러 금액을 내야 하나요?
구독으로 로그인했다면 내지 않습니다. 그 금액은 같은 작업을 API 정가로 했을 때의 추정치입니다. 사용 크레딧을 켰다면 한도를 넘긴 부분만 따로 청구되므로 claude.ai의 설정 > 사용량에서 확인합니다.
마무리: 한도 메시지를 만났을 때 볼 것
- 결제 방식:
/status로 구독 로그인인지 API 로그인인지 먼저 확인합니다. - 어느 한도인지: 세션 한도, 주간 한도, 특정 모델 한도, 컨텍스트 경고 중 무엇인지 메시지를 읽습니다.
- 다시 열리는 시각:
/usage에서 초기화 시각을 보고 기다릴지 정합니다. - 돈을 더 쓸지: 사용 크레딧은 월 지출 한도를 정한 뒤 켜고, 매주 막히면 플랜을 올립니다.
결제를 바꾸지 않고 지금 해 볼 수 있는 일은 세 가지입니다.
- 클로드 코드 입력창에
/status를 입력해 로그인 방식을 확인합니다. /usage에서 세션 한도와 주간 한도의 퍼센트와 초기화 시각을 메모합니다.- 지금 하는 일이 같은 작업이면
/compact, 다른 일이면/clear를 고르는 기준을 정합니다.
참고 자료
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
작업 중에 "세션 한도에 도달했습니다"라는 메시지가 나왔습니다. 맞는 설명은 무엇일까요?
예제나 확인 질문을 직접 시도한 뒤 완료 표시해요. 더 연습할 내용이 남으면 표시하지 않고 다음 글을 읽어도 됩니다. 완료 버튼은 이해도를 채점하지 않으며 잘못 표시하면 취소할 수 있어요.
