클로드 크레딧이 나도 모르게 나갈 때: 원인 두 가지와 막는 설정 (2026년 8월 기준)

8월 11일, 클로드 설정을 열었다가 뜻밖의 숫자를 봤습니다. 사용 크레딧 16.29달러 사용. 저는 크레딧을 켠 기억도 산 기억도 없었습니다. 놀라서 토글부터 껐습니다.

첫 반응은 '주간 한도도 다 안 썼는데?'였습니다. 그런데 사용량 화면에는 한도가 두 개였습니다. 전체 한도는 59%인데 프리미엄 모델(Fable) 한도는 100%. 그쪽이 진작 바닥나 있었고 어느새 켜져 있던 사용 크레딧 토글이 작동해 크레딧이 대신 나가고 있던 겁니다. 다행히 소진된 건 프로모션으로 받은 무료 크레딧이라 카드는 긁히지 않았습니다. 하지만 자동 충전까지 켜져 있었다면 그다음부터는 진짜 제 돈이었습니다.

조사해보니 나도 모르게 나가는 크레딧은 저만의 일이 아니었고 경우가 두 가지였습니다. 하나는 저처럼 한도가 실제로 바닥나서 크레딧이 대신 나가는 경우. 다른 하나는 더 황당한 쪽입니다. 한도가 멀쩡히 남았는데도 클로드 코드가 작업을 멈추고 크레딧을 결제하라고 요구하는 버그입니다. 크레딧을 사서 넣었는데도 에러가 계속 떴고 산 크레딧만 타버렸다는 실제 보고까지 있습니다. 이 글에서는 기초 용어부터 차근차근 짚은 다음, 두 경우를 구분하는 법과 각각에서 내 돈을 지키는 설정, 그리고 이 버그의 정체까지 정리합니다. 2026년 8월 기준입니다.

용어 정리: 토큰, 컨텍스트 창, 오토컴팩트, 크레딧

익숙한 것부터 차근차근 짚겠습니다.

토큰(token)은 AI가 글의 양을 세는 단위입니다. 한글 한 글자가 대략 1~2토큰입니다.

컨텍스트 창(context window)은 한 대화에서 클로드가 한 번에 기억할 수 있는 토큰 총량입니다. 작업대라고 생각하면 쉽습니다. 기본 작업대가 20만 토큰, 확장 작업대가 100만(1M) 토큰입니다.

컴팩트(compact)는 가득 찬 작업대에서 오래된 대화를 요약해 자리를 비우는 정리 기능입니다. /compact로 직접 실행할 수도 있고 한도에 가까워지면 클로드 코드가 알아서 실행하는데 이 자동 실행이 오토컴팩트(auto-compact)입니다. 뒤에서 문제의 한복판에 등장합니다.

사용 크레딧(usage credits)은 구독 한도와 별개로 쓰는 두 번째 지갑입니다. 설정 화면 표기가 그대로 "사용 크레딧"이고 이 글에서는 줄여서 크레딧이라고 부르겠습니다. 토글을 켜두면 한도가 바닥났을 때 여기서 먼저 돈이 나갑니다.

크레딧이 나도 모르게 나가는 두 가지 상황

• 케이스 1. 한도 소진: 구독 한도가 실제로 바닥나 켜져 있던 사용 크레딧이 결제를 대신 이어받는 경우입니다. 작업이 멈추지 않기 때문에 나중에 사용액을 보고서야 알게 됩니다. 제가 겪은 게 이쪽입니다.
• 케이스 2. 버그: 한도가 멀쩡히 남았는데도 클로드 코드가 작업을 멈추고 크레딧을 켜라고 요구하는 경우입니다. 사용자 잘못이 아니라 버그로 보고가 쌓여 있는 경우입니다.

아래에서 케이스별로 확인할 것과 설정을 정리합니다.

케이스 1. 한도 소진: 나도 모르게 크레딧이 대신 나갈 때

케이스 1은 제가 겪은 그대로입니다. 출발점은 모델별 한도입니다. 클로드의 최상위 프리미엄 모델인 페이블(Fable)은 주간 한도를 따로 셉니다. 그래서 전체 한도가 남았어도 페이블 한도는 먼저 바닥나 있을 수 있습니다. 여기에 사용 크레딧 토글이 켜져 있으면 바닥난 한도를 크레딧이 대신 이어받습니다. 한 가지 더 있습니다. Anthropic은 가끔 구독자에게 프로모션 크레딧을 지급하는데 지급 안내 메일에는 "별도 조치 없이 자동 적용된다"고 적혀 있고 실제로 제 계정에서는 토글까지 켜져 있었습니다. 그래서 켠 기억이 없어도 크레딧이 나가고 있을 수 있습니다.

해결책: 사용량 화면에서 확인할 3가지 설정

이 사고를 막으려면 설정의 사용량 화면에서 아래 세 가지를 확인하고 정리하면 됩니다. 전부 한 화면에 모여 있어 간단합니다.

1. 사용 크레딧 토글: 의도한 게 아니면 끕니다. 꺼도 구독 사용에는 지장이 없고 한도가 바닥나면 리셋 시각까지 기다리게 될 뿐입니다.
2. 자동 충전: 크레딧 잔액이 떨어지면 카드로 자동 구매하는 기능입니다. 나도 모르게 나간 크레딧이 진짜 결제로 이어지는 마지막 관문이니 꺼져 있는지 확인하세요.
3. 한도 체크: 전체 한도와 모델별 한도를 각각 확인합니다. 프리미엄 모델을 주로 쓴다면 그쪽 한도가 먼저 찹니다.

케이스 2. 버그: 한도가 남았는데 "Usage credits required" 에러가 뜰 때

GitHub에는 이런 보고가 이어지고 있습니다. 한도가 한참 남았는데 클로드 코드가 갑자기 멈추며 크레딧을 요구했다는 보고가 있습니다. 크레딧을 사서 넣었더니 산 크레딧만 타버리고 에러는 그대로였다는 보고도 있습니다. 위 설정을 다 확인했고 한도도 남았는데 이런 에러와 함께 멈춰 섰다면 같은 케이스입니다.

API Error: Usage credits required for 1M context

당황하실 것 없습니다. 뭔가를 잘못 눌러서 생긴 문제가 아니고 결제한다고 풀리는 문제도 아닙니다. 공식 문서는 소네트 5의 1M 창에 크레딧이 필요 없다고 명시하는데 실제로는 이 메시지가 뜨는 보고가 이어지고 있습니다. Anthropic의 공식 인정은 아직 없지만 한도가 남았는데도 뜬다면 버그일 가능성이 큽니다. 결제 버튼부터 누르지는 마세요.

버그의 자세한 내용은 글 하단에서 알아보고 해결책부터 살펴보겠습니다.

해결책1: 모델 이름, 버전, 남은 한도 확인

1. 지금 모델이 무엇인지 확인하기. /model을 입력해 화면에 뜨는 이름을 봅니다. "Sonnet 5"라면 이 글이 다루는 기본 모델 버그, "Fable 5"라면 업데이트(v2.1.233 이상)와 재로그인으로 해결되는 별도의 프리미엄 모델 이슈입니다.
2. 버전 확인하기. claude --version으로 확인하고 오래됐다면 claude update로 올립니다. 소네트 5는 v2.1.197 이상에서만 정상 지원됩니다(공식 문서). 공식 에러 문서는 대화 도중 오토컴팩트로 뜨는 이 에러를 구버전부터 자동으로 처리해 "조치가 필요 없다"고 안내하지만 v2.1.197 이상에서도 같은 에러가 재보고되고 있어 버전이 최신이라고 안심할 수는 없습니다.
3. 진짜 한도를 다 썼는지 확인하기. /usage를 입력하면 실제 남은 사용량이 나옵니다. 한도가 멀쩡히 남았는데도 이 에러가 뜬다면 그건 한도 문제가 아니라 위에서 말한 버그입니다.

해결책2: 1M 끄기, 오토컴팩트 앞당기기, 모델 재선택

공식 문서가 권장하는 방법은 크게 세 가지입니다. 다만 이 문서 자체가 "아래는 [1m] 모델을 직접 선택한 경우에 적용되는 절차"라고 못박고 있어 정확히는 오토컴팩트가 제멋대로 크레딧을 요구하는 경우를 위한 공식 대응이라기보다 일반적인 1M 모델 사용 안내에 가깝습니다. 그래도 실제로 오토컴팩트 중 막힌 사용자들이 이 세 가지로 우회했다는 보고가 많아 아래에 정리합니다.

• 1M 창을 아예 끄기: CLAUDE_CODE_DISABLE_1M_CONTEXT=1 환경 변수를 설정하면 모델 선택창에서 1M 창 옵션이 사라지고 항상 20만 토큰으로 동작합니다. 다만 셸에서 export로 설정하는 방식은 클로드 코드를 다시 시작해야 적용됩니다(공식 문서). 이미 막힌 세션에서 터미널에 export만 하고 재시작을 안 하면 그대로 막혀 있습니다. 설정 후에는 반드시 claude를 다시 실행하세요. 반면 ~/.claude/settings.json의 env 항목에 넣어두면 공식 문서상 파일을 저장하는 즉시 실행 중인 세션에도 반영됩니다. (시작 시점에만 값을 읽는 일부 기능은 예외인데 이 변수는 해당되지 않습니다.) 그래도 확실히 하려면 저장 후 세션을 한 번 새로 시작하는 편을 권합니다.
• 오토컴팩트 시점 앞당기기: /autocompact 500k처럼 값을 지정하면 그 지점에 닿기 전에 미리 요약합니다. 소네트 5의 기본값은 약 96만 7천 토큰입니다. 낮춰두면 100만 토큰 근처까지 안 가고 끝나 문제가 될 여지가 줄어듭니다. 다만 그만큼 요약이 더 자주 걸린다는 뜻입니다. 오래된 대화 맥락이 자주 압축되고 압축 자체도 별도 호출이라 토큰을 씁니다. 무조건 낮게 잡기보다 본인 세션 길이에 맞게 조정하세요.
• /model sonnet으로 다시 선택하기: [1m] 접미사 없는 표준 버전으로 다시 선택하라는 것이 공식 안내입니다. 다만 실제로는 이 방법으로 안 풀렸다는 보고도 적지 않습니다. 모델을 명시해서 실행해도 에러가 그대로였다는 보고가 있고 VS Code 확장에서는 /model 명령 자체가 먹히지 않았다는 보고도 있습니다. 공식 에러 문서도 /model로 바꾼 뒤에도 에러가 계속되면 설정 파일 같은 다른 위치에 1M 모델 ID가 남아 있지 않은지 확인하라고 안내합니다. 한 번 시도해서 안 풀리면 바로 아래 우회법으로 넘어가세요.

커뮤니티에서 자주 언급되는 우회법도 하나 있습니다. 압축이 막혔을 때 잠깐 /model haiku로 바꿔 오토컴팩트를 통과시킨 뒤 다시 /model sonnet으로 돌아오는 방식입니다. Anthropic 공식 안내는 아니고 이슈 댓글에서 여러 사용자가 효과를 봤다고 보고한 방식이니 급할 때 임시방편으로만 써보시길 권합니다.

평소 습관도 함께 챙기면 좋습니다. 관련 없는 작업으로 넘어갈 땐 /clear로 새로 시작하는 것이 공식 비용 안내가 권하는 습관입니다. 오푸스나 페이블 같은 상위 모델도 복잡한 판단이 필요할 때만 쓰세요. 특히 페이블은 주간 한도를 따로 쓰기 때문에 제가 겪은 케이스 1로 이어지기 쉽습니다.

케이스 2의 정체: 소네트 4.6 시절부터 반복된 오토컴팩트 문제

그럼 이 버그는 어쩌다 생겼을까요? 원래 1M 창은 유료 옵션이었습니다. 소네트 4.6까지는 Max를 포함한 어떤 플랜에서도 크레딧을 내야 썼는데(공식 문서의 확장 컨텍스트 표) 2026년 6월 말 클로드 코드의 기본 모델이 소네트 5로 바뀌면서(Pro, 팀 스탠다드, 기업 플랜 기준) 1M 창이 처음으로 무료 기본이 됐습니다(업데이트 공지). 그런데 오토컴팩트가 이 전환을 따라오지 못했습니다. 자동 요약이 걸리는 순간 사용자가 고른 모델과 무관하게 1M 모델을 불러 옛날 규칙대로 크레딧을 요구하고 세션은 /clear 전까지 먹통이 됩니다(초기 버그 보고).

짚고 갈 점이 하나 있습니다. 이건 소네트 5가 만든 새 버그가 아닙니다. 첫 보고들은 전환 한 달가량 전 소네트 4.6에서 이미 등록됐습니다. 당시엔 1M이 유료였으니 크레딧 요구 자체는 규정대로였고 진짜 문제는 요청한 적 없는 1M 창으로 멋대로 넘어간다는 것이었습니다. 그 패턴이 1M이 무료가 된 소네트 5에서도 그대로 반복되고 있는 겁니다.

별개의 사례도 하나 정리해 둡니다. 페이블 5의 크레딧 요구는 로그인 토큰이 만료되면 구독 등급을 확인하지 못하던 다른 버그였고 8월 17일 Anthropic이 원인 설명과 함께 종결했습니다. 해결법은 위 확인 1번 그대로입니다. 반면 소네트 쪽 핵심 보고 세 건은 8월 20일 기준 여전히 열려 있습니다. 8월 19일 한 건이 추적용 대표 보고로 통합됐지만 수정이 아니라 정리이고 원인이나 일정을 설명하는 공식 답변은 아직 없습니다. 그때까지는 위의 확인과 설정이 최선입니다.