클로드 코드(Claude Code)를 쓰다가 사용량 한도에 생각보다 빨리 닿는다면, 터미널에서 /usage를 열고 경고 줄을 먼저 보면 돼요. 2026년 10월 20일 나온 v2.1.305부터 경고마다 원인이 적힌 한 줄 해결책이 붙고, f 키를 누르면 그 해결책이 바로 적용되거든요. 이 글은 클로드 코드 공식 릴리스 노트(GitHub 저장소, 프로그램 파일을 모아 둔 공개 폴더)를 기준으로 썼어요.
이런 분께
- 클로드 프로(Pro)나 맥스(Max) 요금제로 클로드 코드를 쓰는데, 5시간 사용 한도에 자주 걸리는 분
- 어제 하던 대화를 이어서 열었더니 사용량이 훅 줄어든 것 같은 분
끝나면 이렇게 됩니다
/usage 화면에서 경고를 읽고 f 한 번으로 고친 뒤, 오래된 대화는 새 대화로 이어 가는 습관이 생겨요. 같은 일을 해도 한도를 덜 쓰게 돼요.
준비물
- 클로드 코드 v2.1.305 이상(2026년 10월 20일 이후 버전)
- 클로드 프로 또는 맥스 요금제 계정
- 터미널(컴퓨터에 글자로 명령하는 창). 윈도우는 시작 메뉴에서 '터미널' 검색, 맥은 Spotlight에서 '터미널' 검색
따라 하기
- 터미널을 열고 아래 명령으로 클로드 코드를 최신으로 올려요.
claude update
- 작업 폴더에서
claude를 입력해 클로드 코드를 열어요. - 입력창에
/usage를 치고 엔터를 눌러요. 지금 쓴 양과 경고가 나와요. - 경고 줄을 읽어요. 줄마다 무엇 때문에 사용량이 늘었는지(원인)와 고치는 방법이 한 줄로 적혀 있어요.
- 해결책을 적용하려면 f 키를 눌러요. 같은 해결책은 VS Code와
/doctor화면에도 나와요. - 오래 쉬었던 대화를 다시 열 때 경고가 뜨면, 그대로 이어 갈지 새 대화를 시작할지 골라요. 새 대화를 골라도 이전 대화를 언급하면 클로드가 찾아볼 수 있어요.
- 긴 대화를 오래 두는 편이면
/config에서 「Idle compaction」 줄을 확인해요. 켜져 있으면 오래 쉰 긴 대화를 미리 압축해 둬요.
복사해서 쓰는 프롬프트
새 대화로 이어 갈 때 첫 줄에 붙여요.
어제 [작업 이름] 대화에서 하던 일을 이어서 하려고 해. 이전 대화에서 결정한 것과 남은 일만 먼저 정리해 줘. 정리가 맞으면 [다음 할 일]부터 시작하자.
[작업 이름] 예시: 고객 문의 엑셀 정리 스크립트 / [다음 할 일] 예시: 중복 행 지우는 부분
AI에게 통째로 맡기기
/usage 경고를 하나씩 읽고 무슨 뜻인지 쉬운 말로 설명해 줘.
자주 막히는 곳
- /usage에 경고 해결책이나 f 키 안내가 안 보일 때: 버전이 낮은 거예요.
claude --version으로 확인하고 v2.1.305보다 낮으면claude update를 다시 해요. - 화면이 좁아 /usage 줄이 잘릴 때: 같은 버전에서 고쳐졌어요. 그래도 잘리면 터미널 창을 넓혀요.
- f를 눌러 설정이 바뀐 게 걱정될 때 주의: 해결책은 적용 전에 한 줄로 보여 주니 먼저 읽고 눌러요. 무엇이 바뀌었는지 모르겠으면
/doctor에서 같은 내용을 다시 볼 수 있어요. - 이전 대화 이어 가기 경고가 계속 뜰 때: 프로·맥스 요금제에서 오래 쉰 대화를 다시 열면 5시간 한도의 눈에 띄는 몫을 쓸 수 있을 때 뜨는 경고예요. 새 대화로 시작하고 위 프롬프트로 이어 가요.
확인
/usage를 다시 열었을 때 고친 경고 줄이 사라졌으면 된 거예요. 다음 날 같은 작업을 할 때 새 대화로 시작해서 한도 경고가 덜 뜨는지 봐요.
