Claude Code 비용, 자동 모드 분류기 과금이 사라지는 조건

Claude Code 비용 변화, 한 문장으로 정리하면

자동 모드를 사용하면 Claude Code는 위험한 작업을 할 때마다 승인을 요청하지 않고 계속 진행할 수 있습니다. 더 작은 규모의 판단 모델인 분류기는 실행 전에 셸 명령이나 네트워크 요청 같은 동작을 검사합니다.

2026년 9월 19일 릴리스 전까지는 API, Enterprise 및 지원되는 클라우드 제공자 세션에서 이런 검사를 위해 별도의 모델 요청이 발생할 수 있었습니다. 해당 요청은 토큰을 사용했고 비용도 청구됐습니다. 에이전트가 셸 작업과 네트워크 작업을 많이 실행하면, 사용자가 Claude에 맡긴 본 작업의 사용량에 안전 계층의 비용까지 별도 항목으로 더해졌습니다.

2.1.278에서는 다른 경로가 추가됐습니다. 이제 Claude Code는 동일한 안전 판단을 세션의 일반 모델 요청 안에서 내리도록 서버에 요청할 수 있습니다. 이 서버 경로가 활성화되면 Anthropic은 분류기 검사 비용을 청구하지 않습니다.

이는 Claude 토큰 할인이 아닙니다. API 단가가 낮아지는 것도 아닙니다. 적격 세션에서 별도 분류기 요청 때문에 발생하던 추가 비용만 없어집니다.

또한 모든 API 또는 Enterprise 사용자가 자동 모드로 전환되는 것도 아닙니다. 이미 자동 모드를 사용하는 세션에서 검사가 어디에서 실행되는지가 바뀌는 것입니다. 더 폭넓은 권한 모델은 Claude Code 자동 모드에서 다룹니다.

이제 과금 경로는 두 갈래입니다

이번 변경은 경로 선택에 따라 과금 결과가 달라지는 구조로 이해하면 가장 명확합니다.

비용 계산식도 간단합니다.

적격 세션 비용 = 일반 모델 사용량 + 별도 과금되는 툴 사용량.

폴백 세션 비용 = 일반 모델 사용량 + 별도 과금되는 툴 사용량 + 분류기 요청 토큰 사용량.

절감되는 것은 마지막 항목입니다. Claude Code 청구액 전체가 사라지는 것은 아닙니다.

Anthropic은 세션당 고정 절감액을 공개하지 않으며, 모든 환경에 통용되는 비율을 제시한다면 근거 없는 수치가 됩니다. 클라이언트 측 검사는 대화 기록 일부와 실행 대기 중인 동작을 함께 전송합니다. 일반적인 읽기 작업과 작업 디렉터리 내 편집은 대체로 분류기를 거치지 않지만, 셸 명령과 네트워크 작업에서는 추가 사용량이 주로 발생합니다. 따라서 툴 사용이 많은 무인 작업은 짧은 코드 읽기 세션보다 더 많이 절감할 수 있지만, 정확한 수치는 각자의 사용 기록에서 확인해야 합니다.

자격 여부는 계정이 아니라 세션에서 결정됩니다

Claude Code는 Enterprise 플랜, Claude API 계정, AWS의 Claude Platform, Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 및 게이트웨이 세션에서 기본적으로 서버 측 검사를 요청합니다. 대상 범위는 넓어 보이지만, 현재 이들 플랫폼의 모든 세션이 적격이라는 뜻은 아닙니다.

플랫폼 출시 상황, 리전, 자격 증명, 트래픽 경로가 모두 영향을 줍니다. Bedrock, Agent Platform, Foundry 및 로그인된 Claude 앱 게이트웨이에서 자동 모드를 사용하려면 Claude Sonnet 5, Claude Opus 4.7 이상 또는 Fable 모델도 필요합니다.

이 때문에 2.1.278은 /status에 Auto mode server 행을 추가했습니다.

• Enabled는 검사가 필요한 세션 동작을 서버가 판정하고 있다는 뜻입니다. 별도 분류기 비용은 사라집니다.
• Disabled는 세션이 Claude Code 자체 분류기 요청으로 폴백했다는 뜻입니다. 해당 요청에는 이전과 동일하게 비용이 청구됩니다.

이 행은 플랜 이름이나 출시 공지보다 더 유용합니다. 현재 세션이 실제로 어느 과금 경로에 도달했는지 보여주기 때문입니다.

가장 흔한 실패 지점은 게이트웨이입니다

서버 경로를 이용하려면 소량의 제어 데이터가 왕복 과정에서 온전히 전달돼야 합니다. 이미 알고 있는 필드만 전달하는 게이트웨이는 일반 Claude 요청을 정상 처리하면서도 이 데이터를 제거할 수 있습니다.

흔한 문제로는 요청 헤더 재작성, 알 수 없는 본문 필드 삭제, 응답 ID 변경, 스트리밍 이벤트의 키 누락 등이 있습니다. 이런 경우 서버가 검사 요청을 아예 받지 못하거나 Claude Code가 판정 결과를 받지 못합니다.

호환 조건은 명확합니다. 게이트웨이는 safeguards 필드를 포함한 요청 헤더와 본문 필드를 변경 없이 전달해야 합니다. 또한 응답과 스트리밍 이벤트에서 safeguard_results를 누락하거나 툴 사용 ID를 재작성해서는 안 됩니다. 게이트웨이 호환성 가이드는 이후 Claude Code 기능이 새로운 항목을 추가할 수 있으므로 필드와 헤더를 개방형 목록으로 취급하라고 안내합니다.

이 전달 과정에 문제가 생겨도 자동 모드 자체가 실패하지는 않습니다. Claude Code는 자체 분류기로 폴백하고 과금 알림을 표시합니다. 작업이 중단되지 않는다는 점은 장점이지만, 예산 측면에서는 놓치기 쉽습니다. 에이전트는 계속 작동하는 반면 추가 사용량 항목은 다시 생기기 때문입니다.

다음 네 팀은 운영 방식을 바꿔야 합니다

LLM 게이트웨이를 운영하는 플랫폼 팀

대표적인 Claude Code 세션 하나를 호환성 테스트에 사용합니다. /status에 Disabled가 표시되면 예측치를 바꾸기 전에 게이트웨이의 요청 및 스트리밍 응답 변환을 점검해야 합니다.

효과는 당장의 분류기 비용 절감에 그치지 않습니다. 알 수 없는 필드를 재작성하지 않고 그대로 통과시키면 다음 Claude Code 기능이 같은 경계에서 깨질 가능성도 줄어듭니다.

에이전트 업무 비용을 예측하는 FinOps 담당자

예상 비용을 일반 모델 지출과 분류기 추가 비용으로 나눕니다. 서버 경로가 활성화된 것으로 표시되는 세션에 한해서만 두 번째 항목을 제거합니다.

이렇게 하면 게이트웨이 때문에 실현되지 않는 절감액을 반영하거나, 서버가 처리를 넘겨받은 뒤에도 분류기 예산을 계속 잡아 두는 두 가지 잘못된 예측을 피할 수 있습니다. 더 폭넓은 모델 및 플랜별 수치는 Claude Code 요금 계산법에서 확인할 수 있습니다.

여러 리전에 배포하는 Enterprise 관리자

한 번 기능을 검증한 뒤 모든 사무실, 제공자 계정, 자격 증명에서 동일하게 작동한다고 가정해서는 안 됩니다. 개발자가 실제로 사용하는 각 경로에서 같은 검사를 실행해야 합니다.

그러면 플랫폼 로고가 아니라 실제 세션을 근거로 한 간단한 적격 여부 매트릭스를 만들 수 있습니다. 서버 측 검사가 아직 배포되지 않은 리전은 설정에 문제가 없어도 폴백 경로에 머물 수 있습니다.

무인 작업을 운영하는 Agent SDK 팀

대화형 터미널은 알림에서 멈출 수 있습니다. 비대화형 -p 실행은 알림을 stderr에 기록하고, stream-json은 Agent SDK 앱이 읽을 수 있는 system 경고를 내보냅니다.

이 신호를 로그나 텔레메트리에 수집해야 합니다. 그렇지 않으면 워크플로는 계속 성공하고, 지출이 발생한 뒤에야 과금 폴백을 발견하게 됩니다.

예산을 바꾸기 전에 실제 경로부터 점검하세요

반드시 알아야 할 한계

이번 릴리스는 변동 비용을 없애지만, 에이전트 예산에서 일괄 차감할 수 있는 고정 비율을 제공하지는 않습니다. 기본 모델은 여전히 컨텍스트를 읽고, 추론하고, 결과를 작성하며, 일반 요율로 툴을 사용합니다. 대개 이 비용이 세션에서 더 큰 비중을 차지합니다.

적격 여부는 통제할 수 없는 시스템 경계에서도 달라질 수 있습니다. 클라우드 플랫폼이 특정 리전이나 자격 증명에 대한 배포를 아직 완료하지 않았을 수 있고, 게이트웨이 제공자가 전달 방식을 업데이트해야 할 수도 있습니다. 두 경우 모두 안전 검사는 계속되고 폴백 요청 비용도 계속 청구됩니다.

게이트웨이가 서버 경로를 지원할 수 없다는 사실을 이미 아는 팀을 위한 옵트아웃도 있습니다.

export CLAUDE_CODE_AUTO_MODE_SERVER=0

이 설정을 사용하면 Claude Code가 서버 측 검사를 요청하지 않고 폴백 알림도 표시하지 않으며, 과금되는 클라이언트 측 분류기 경로를 의도적으로 유지합니다. 비용 절감 설정이 아니라 알림을 제어하는 설정입니다. Anthropic은 이 설정이 임시 조치라고도 명시하며, Anthropic API에 직접 연결할 때는 무시됩니다.

월요일에 바로 할 일

API, Enterprise, 제공자 기반 또는 게이트웨이 기반 Claude Code 배포를 담당한다면 이번 주에 조치해야 합니다. 실제 경로 하나를 2.1.278 이상으로 업데이트하고 자동 모드 세션을 실행한 뒤 /status를 확인합니다. 분류기 추가 비용을 예산에서 빼기 전에 게이트웨이의 요청 및 응답 처리도 검증해야 합니다.

/status에 Disabled가 표시되고 수정할 게이트웨이도 없다면 플랫폼, 리전 또는 자격 증명에 배포될 때까지 기다립니다. 기다리는 동안에는 예측치에 분류기 비용 항목을 유지해야 합니다.

Pro, Max 또는 Team을 사용한다면 이번 릴리스로 분류기 예산이 달라지지 않습니다. 해당 플랜에서는 분류기 추가 사용량이 이미 무료였습니다. 자동 모드를 사용하지 않는 팀에도 영향이 없습니다.

다음 플랫폼 변경도 실제 운영 판단으로 빠르게 연결하고 싶다면 뉴스레터에 가입하세요.