작성자 노트: Claude Code에 Deepseek API를 연결한 뒤 Auto Mode에서 나타나는 ‘과금 메커니즘 호환성 경고’를 해석하고, 그 의미와 임시 해결 방법, 그리고 API 중계 서비스 플랫폼의 호환성 요구 사항을 설명해요.
최근 많은 개발자가 Claude Code에 Deepseek API를 연결한 뒤 Auto Mode(자동 권한 모드)를 켜면 분류기 과금 메커니즘에 관한 호환성 경고가 나타나는 것을 확인했어요. Anthropic은 이미 공식 문서에서 이 메커니즘 조정을 별도로 설명해 두었기 때문에, 이 안내는 우연히 발생한 장애도 아니고 떠도는 소문도 아니에요.
이건 Deepseek API 오류도 아니고, 여러분의 계정에 문제가 생긴 것도 아니에요. 원인은 Claude Code 새 버전이 Auto Mode의 보안 검토 방식을 조정했는데, api.deepseek.com 같은 서드파티 업스트림이 아직 새 메커니즘과 호환되지 않기 때문이에요. 이 글에서는 이 경고의 의미, 지금 바로 대처하는 방법, 그리고 이것이 API 중계 서비스 플랫폼에 무엇을 뜻하는지 정리해요.
핵심 가치: 3분이면 Claude Code Auto Mode 과금 호환성 경고의 전말을 파악하고, 바로 복사해 쓸 수 있는 설정 방법과 게이트웨이 호환성 체크리스트도 얻을 수 있어요.

Claude Code Auto Mode 과금 경고 핵심 정보 한눈에 보기
먼저 표 하나로 이번 변화의 핵심을 정리해볼게요. 내가 영향을 받는지 빠르게 판단하는 데 도움이 될 거예요.
| 정보 항목 | 상세 |
|---|---|
| 배포 주체 | Anthropic (Claude Code 공식) |
| 관련 기능 | Claude Code Auto Mode의 안전 분류기(Classifier) |
| 핵심 변화 | 안전 심사가 “클라이언트가 별도로 분류 요청을 보내는 방식”에서 “서버가 메인 요청 안에서 처리하는 방식”으로 변경 |
| 과금 변화 | 새 메커니즘에서는 분류기 요청에 별도 과금이 없음 |
| 영향받는 사용자 | Deepseek 등 서드파티 Anthropic 호환 인터페이스를 통해 Claude Code를 사용하는 개발자 |
| 현재 상태 | 여전히 구 메커니즘으로 되돌려 작업 가능하나, 분류기 요청은 구 방식대로 Tokens를 소모 |
| 향후 계획 | 공식 측은 향후 버전에서 구 방식 롤백을 제거할 예정이라고 밝힘 |
Claude Code Auto Mode 분류기란?
Auto Mode의 설계 목표는 수동 클릭 확인을 줄이는 것이에요. Claude Code는 Shell 명령 실행, 네트워크 접근 등 위험 가능성이 있는 작업을 하기 전에 먼저 분류기를 통해 이 작업이 안전한지 판단해요. 판단을 통과하면 자동 실행되고, 통과하지 못하면 사용자 확인을 받거나 곧바로 거부돼요.
구 메커니즘에서는 이 분류기 판단을 Claude Code가 별도로 한 번의 요청으로 보내 처리했고, 이 요청 자체가 Tokens를 소모했어요. 즉, Claude Code가 명령 하나를 자동으로 실행할 때마다 메인 대화 요청 외에 분류 요청 비용이 한 번 더 발생할 수 있었던 셈이에요.
Claude Code Auto Mode 신구 과금 메커니즘 차이
Anthropic은 이제 안전 심사를 서버 쪽으로 옮겼어요. 메인 요청에 안전 심사 관련 필드가 포함되고, 서버가 메인 요청을 처리할 때 심사 결과까지 함께 돌려주기 때문에 분류기 요청에는 더 이상 별도 과금이 없어요. 공식 API 사용자에게는 실질적인 비용 절감이에요.
문제는 새 메커니즘이 업스트림 서버에서 이 안전 심사 프로토콜을 구현해야 한다는 점이에요. Deepseek의 Anthropic 호환 인터페이스는 아직 이를 구현하지 않았기 때문에, Claude Code가 업스트림이 지원하지 않는 것을 감지하면 호환성 경고를 띄우고 구 방식으로 되돌려 계속 작동해요.
| 비교 항목 | 구 메커니즘 | 신 메커니즘 |
|---|---|---|
| 안전 심사 위치 | Claude Code가 별도 분류 요청 발송 | 서버가 메인 요청 안에서 처리 |
| 분류기 Tokens | 별도 소모 | 더 이상 별도 과금 없음 |
| 공식 호환 서비스 | 지원 | 지원 |
| 현재 Deepseek 인터페이스 | 지원, 구 방식으로 과금 | 아직 미호환 |
| 향후 버전 | 롤백 수단으로 유지 | 구 방식 롤백 제거 예정 |

특히 “향후 롤백 제거”라는 점을 주의해야 해요. 롤백 방식이 취소되고 업스트림이 안전 심사 결과를 반환하지 못하게 되면, Claude Code는 관련 작업마다 매번 사용자 허락을 구하거나 실행을 그냥 거부할 수밖에 없어요. 그때가 되면 Auto Mode의 “자동” 경험은 크게 떨어질 거예요.
Claude Code에 Deepseek를 연결한 뒤 Auto Mode 경고는 어떻게 처리할까요
Deepseek로 Claude Code를 계속 구동하는 것만이 목표라면, 가장 간단한 방법은 서버 측 분류기 모드를 직접 꺼 버리는 거예요. 그러면 Claude Code가 예전 메커니즘을 그대로 사용하게 되어, 반복적인 감지와 경고가 사라져요.
방법 1: 터미널 환경 변수
macOS나 Linux 터미널에서 다음을 실행하세요:
export CLAUDE_CODE_AUTO_MODE_SERVER=0
claude
이 방식은 현재 터미널 세션에만 적용되어 임시 검증에 적합해요. 장기적으로 적용하고 싶다면 export 줄을 ~/.zshrc나 ~/.bashrc에 추가하면 돼요.
방법 2: settings.json에 작성하기
더 추천하는 방식은 Claude Code의 설정 파일인 ~/.claude/settings.json에 작성하는 거예요:
{
"env": {
"CLAUDE_CODE_AUTO_MODE_SERVER": "0"
}
}
설정 파일에 이미 다른 내용(예를 들어 업스트림 주소, 모델 이름, 권한 규칙 등)이 들어 있다면, CLAUDE_CODE_AUTO_MODE_SERVER 필드만 기존 env 객체에 병합하면 돼요. 절대 파일 전체를 덮어쓰지 마세요. 그러면 기존 설정이 사라질 수 있어요.
서버 모드를 끈 후의 실제 효과
끄고 나면 어떤 변화가 생기는지는 아래 표로 정리할 수 있어요:
| 항목 | 끄기 전(기본값) | 끈 후 (=0) |
|---|---|---|
| 호환성 경고 | 업스트림 비호환을 감지할 때마다 매번 표시 | 더 이상 팝업되지 않음 |
| 분류기 메커니즘 | 서버 측 검사를 시도하고 실패하면 폴백 | 기존 분류기를 바로 사용 |
| 분류기 Tokens | 폴백 후에도 평소처럼 소모 | 평소처럼 소모 |
| 무료 분류기 | 업스트림 비호환 시 이용 불가 | 이용 불가 |
| 장기 가용성 | 폴백 방식이 제거될 예정 | 공식적으로 임시 방편으로 자리매김, 향후 제거될 수 있음 |
다시 말해, 이 환경 변수는 그저 “소음기”일 뿐이고, Deepseek에 새로운 무료 분류기 능력을 주는 건 아니에요. 해결하는 건 프롬프트 방해 요소이지, 과금 문제 그 자체가 아니에요.
/status로 실제 상태 확인하기
설정을 마친 후 Claude Code에서 공식 제공 점검 명령을 실행하세요:
/status
출력에서 Auto mode server 항목을 중점적으로 보면 돼요. Enabled로 표시되면 현재 서버 측 검사를 사용 중이고, Disabled로 표시되면 이미 폴백되어 서버 측 검사를 사용하지 않는다는 뜻이에요. 방금 CLAUDE_CODE_AUTO_MODE_SERVER=0을 설정했다면 여기서 Disabled로 표시되어야 해요.
먼저 업스트림 모델 사용 가능 여부 확인하기
Auto Mode 문제를 해결하기 전에, 업스트림 모델 자체 호출이 정상인지 먼저 확인하는 게 좋아요. 네트워크나 인증 문제를 과금 호환 문제로 오판하지 않기 위해서예요. 아래는 OpenAI 호환 인터페이스로 진행하는 최소 연결 테스트예요:
import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # APIYI 통합 인터페이스, 여러 모델 전환 가능
)
resp = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "OK라고만 답해 주세요"}]
)
print(resp.choices[0].message.content)
전체 멀티 모델 연결성 점검 스크립트 보기
import time
import openai
from typing import List
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1"
)
def check_models(models: List[str]) -> None:
"""여러 모델을 순서대로 호출해 정상 동작 여부를 확인하고, 소요 시간을 출력합니다"""
for model in models:
start = time.time()
try:
resp = client.chat.completions.create(
model=model,
messages=[{"role": "user", "content": "OK라고만 답해 주세요"}],
max_tokens=10
)
cost = time.time() - start
text = resp.choices[0].message.content.strip()
print(f"[성공] {model}: {text}({cost:.2f}s)")
except Exception as e:
print(f"[실패] {model}: {e}")
if __name__ == "__main__":
# 모델 이름은 플랫폼에서 실제로 제공하는 목록을 기준으로 합니다
check_models(["deepseek-chat", "claude-sonnet-4-5", "gpt-4o-mini"])
🚀 빠른 시작 팁: Claude Code 호환 문제를 해결할 때는 하나의 Key로 Deepseek, Claude 등 업스트림을 모두 미리 테스트해 보면 시간을 크게 절약할 수 있어요. APIYI apiyi.com은 OpenAI 호환 통합 인터페이스를 제공하며, 신규 사용자에게는 무료 테스트 크레딧이 있어 여러 모델의 연결성을 빠르게 비교하기에 적합해요.
Claude Code Auto Mode 신규 메커니즘이 API 중계 서비스 플랫폼에 미치는 영향
일반 사용자에게는 환경 변수 하나만 설정하면 문제가 해결돼요. 하지만 API 중계 서비스 플랫폼과 자체 구축 게이트웨이 운영자에게는 이번 조정이 더 주목할 만해요. 같은 유형의 호환성 문제가 언젠가는 당신의 사용자에게도 나타날 수 있기 때문이죠.
게이트웨이가 그대로 전달해야 하는 Auto Mode 안전 검토 필드
Anthropic 공식 문서에 따르면, 서버 측 안전 검토를 지원하는 게이트웨이는 다음 필드를 올바르게 처리해야 해요:
| 위치 | 필드 | 요구 사항 |
|---|---|---|
| Request Header | anthropic-beta |
그대로 전달 |
| Request Body | safeguards |
그대로 전달 |
| Response Body | safeguard_results |
보존하고 올바르게 반환 |
| Streaming | 안전 검토 결과 관련 필드 | 손실되지 않아야 함 |
| Tool Use | Tool Use ID | 임의로 수정하지 않아야 함 |
그중에서 가장 문제가 되기 쉬운 것은 두 가지 유형의 게이트웨이 구현이에요. 하나는 ‘필드 화이트리스트’ 필터링을 적용한 게이트웨이로, 인식하지 못하는 safeguards, safeguard_results를 그냥 버려버려요. 다른 하나는 스트리밍 응답을 다시 재조립하는 게이트웨이로, SSE 이벤트 변환 과정에서 검토 결과 관련 이벤트를 삼켜버리죠. 일부 게이트웨이는 내부 추적을 위해 Tool Use ID를 재작성하는데, 이것 역시 프로토콜을 깨뜨려요.
아래는 게이트웨이 패스스루 로직의 예시 조각이에요. 핵심 아이디어는 ‘인식하지 못하는 필드도 삭제하지 말자’예요:
def forward_request(incoming_headers: dict, incoming_body: dict) -> tuple:
"""예시: Anthropic 안전 검토 관련 필드를 그대로 전달하고, 화이트리스트 필터링을 하지 않음"""
headers = {k: v for k, v in incoming_headers.items()
if k.lower() not in ("host", "content-length")}
# anthropic-beta는 그대로 유지하고, 병합하거나 재작성하지 않음
body = dict(incoming_body) # safeguards 등 모든 필드 보존
return headers, body
def forward_response(upstream_body: dict) -> dict:
"""예시: 응답 본문을 그대로 반환하고, safeguard_results와 tool_use id 보존"""
return upstream_body
패스스루 필드가 업스트림 지원을 의미하지는 않아요
여기에는 아주 중요한 전제가 하나 있어요. 게이트웨이가 이런 필드를 패스스루한다고 해서 Deepseek 모델이 Anthropic의 서버 측 안전 검사를 지원한다는 뜻은 아니에요. 업스트림 자체가 이 프로토콜을 구현하지 않았다면, 중계 서비스를 아무리 완벽하게 다듬어도 safeguard_results를 받을 수 없고, 당연히 무료 분류기의 혜택도 누릴 수 없어요.
따라서 중계 플랫폼은 업스트림 유형에 따라 따로 평가해야 해요:
- Anthropic 공식 API를 업스트림으로 쓰는 경우: 패스스루 경로가 완전한지 먼저 확인하세요. 필드가 유실되지 않기만 하면 사용자가 새 메커니즘을 바로 활용할 기회가 있어요.
- Deepseek 등 서드파티 모델을 업스트림으로 쓰는 경우: Anthropic Messages API 형식과 호환된다고 해서 이 전용 안전 검사 프로토콜을 지원한다는 뜻은 아니에요. 업스트림 제공사가 직접 구현할 때까지 기다려야 해요.

업스트림별 Claude Code Auto Mode 대응 전략
위 분석을 구체적인 상황에 적용해 보면, 다음과 같은 의사결정 표로 정리할 수 있어요:
| 업스트림 유형 | 서버 측 안전 검사 | 권장 방법 | 사용 가능한 플랫폼 |
|---|---|---|---|
| Anthropic 공식 Claude 모델 | 지원 (경로 전체 패스스루 필요) | 기본값 유지, /status가 Enabled인지 확인 |
공식 API, APIYI apiyi.com 등 집계 플랫폼 (실측 패스스루 기준) |
| Deepseek Anthropic 호환 인터페이스 | 아직 미지원 | CLAUDE_CODE_AUTO_MODE_SERVER=0 설정 |
Deepseek 공식 인터페이스 등 |
| 기타 서드파티 호환 모델 | 대개 미지원 | 위와 동일, 이후 버전 변화 주시 | 각 제조사 호환 인터페이스 |
| 자체 구축 게이트웨이로 공식 API 전달 | 게이트웨이 구현에 따라 다름 | 필드 목록대로 항목별 패스스루 점검 | 자체 구축 게이트웨이 |
개발자에게 미치는 장기적 영향
- 비용 측면: 계속 Deepseek로 Auto Mode를 실행하면 분류기 토큰 비용은 여전히 지불해야 해요. 새 메커니즘을 지원하는 업스트림을 사용하면 이 비용을 아낄 수 있어요.
- 경험 측면: 구방식 폴백이 제거된 뒤에는 호환되지 않는 업스트림 때문에 Auto Mode가 권한 승인을 자주 요청하거나 실행을 거부할 수 있어 자동화 수준이 떨어질 수 있어요.
- 선택 측면: Claude Code의 모델 업스트림을 고를 때 “서버 측 안전 검토 지원 여부”가 가격, 속도와 함께 주요 고려 사항이 될 거예요.
💡 선택 제안: Auto Mode로 명령을 자동 실행하는 비중이 크다면 Claude 네이티브 모델과 Deepseek를 같은 워크플로에 두고 비교 테스트해 보세요. APIYI apiyi.com에서 동일한 키로 서로 다른 업스트림을 전환하면 실제 작업에서 토큰 소모와 권한 팝업 빈도의 차이를 관찰하기 쉬워요.
Claude Code Auto Mode 과금 경고 자주 묻는 질문 FAQ
Q1: Claude Code에 Deepseek를 연결한 뒤 나타나는 과금 경고는 무슨 뜻인가요?
Claude Code가 Auto Mode 분류기 과금 메커니즘에 대해 보여 주는 호환성 안내예요. 현재 업스트림(예: `api.deepseek.com`)이 새로운 서버 측 안전 검토를 지원하지 않아 Claude Code가 구메커니즘으로 폴백했고, 분류기 요청이 계속 토큰을 별도로 소모한다는 뜻이에요. Deepseek 오류가 아니며 계정 상태와도 무관해요.
Q2: `CLAUDE_CODE_AUTO_MODE_SERVER=0`을 설정하면 어떤 부작용이 있나요?
주요 효과는 경고가 더 이상 뜨지 않고 구분류기를 바로 사용한다는 점이에요. 부작용은 서버 측 검토를 명시적으로 포기하게 되고, 분류기 토큰은 평소처럼 과금된다는 점이에요. 또 공식에서는 이 환경 변수를 임시 방안으로 규정하고 있어 향후 버전에서 제거될 수 있으므로, 그때는 업스트림 선택을 다시 평가해야 해요.
Q3: 구분류기 폴백 방식은 언제 제거되나요?
공식 자료에서는 현재 “향후 버전에서 구방식 폴백을 제거할 예정”이라고만 밝히고 있고, 구체적인 버전 번호나 날짜는 제시하지 않았어요. Claude Code를 업그레이드할 때 업데이트 안내를 확인하고, 업그레이드 후 `/status`로 `Auto mode server` 상태를 점검하는 걸 권장해요.
Q4: 무료 서버 측 분류기를 실제로 사용하려면 어떻게 해야 하나요?
전제는 업스트림이 Anthropic의 서버 측 안전 검토 프로토콜을 지원해야 한다는 점이에요. 현재는 주로 Anthropic 공식 Claude 모델이 해당되며, 중간 경로가 `anthropic-beta`, `safeguards`, `safeguard_results`를 완전히 그대로 전달해야 해요. 빠르게 검증하려면 APIYI apiyi.com에서 테스트 할당량을 받아 Claude 네이티브 모델로 Auto Mode를 한 번 실행한 뒤 `/status`에서 `Enabled`인지 확인해 보세요.
Q5: 제 중계 게이트웨이는 이미 필드를 그대로 전달하는데, 왜 Deepseek는 여전히 호환되지 않나요?
필드를 그대로 전달하는 것은 “필드가 유실되지 않게” 하는 문제만 해결해요. `safeguard_results`를 반환할 수 있는지는 업스트림 모델 서비스 자체에 달려 있어요. Deepseek 인터페이스는 Anthropic Messages API 형식과 호환되지만, 그것이 이 안전 검토 프로토콜을 구현했다는 뜻은 아니에요. 이 경우 게이트웨이 쪽은 이미 제 역할을 한 것이므로 업스트림 지원을 기다리는 수밖에 없어요.
Q6: 특정 통합 플랫폼이 Claude Code와 얼마나 호환되는지 어떻게 판단하나요?
이 글의 필드 목록을 항목별로 테스트해 보면 돼요. 요청 헤더에 `anthropic-beta`가 유지되는지, 요청 본문에 `safeguards`가 유지되는지, 응답과 스트리밍 이벤트에서 검토 결과가 함께 돌아오는지, Tool Use ID가 변경되는지 확인하면 돼요. APIYI apiyi.com 같은 멀티모델 플랫폼에서도 이런 검사들을 Claude Code 네이티브 API 패스스루 호환성 체크리스트의 일부로 검증하는 걸 권장해요.
Claude Code Auto Mode 과금 호환성 핵심 요약
- 경고의 본질: Auto Mode 분류기 과금 메커니즘 조정이며, Deepseek 계정이나 인터페이스 장애와는 무관합니다.
- 새 메커니즘 변화: 보안 검토가 서버 측 메인 요청 안에서 이루어지도록 바뀌어, 분류기가 더 이상 별도로 과금되지 않습니다.
- 현재 상태: Deepseek는 여전히 Auto Mode를 사용할 수 있지만, 분류기 요청은 기존 방식대로 토큰을 소모합니다.
- 임시 해결법:
CLAUDE_CODE_AUTO_MODE_SERVER=0을 설정하면 경고가 사라지지만, 무료 분류기는 받을 수 없습니다. - 상태 확인:
/status를 실행해Auto mode server가Enabled인지Disabled인지 확인하세요. - 게이트웨이 요점:
safeguards와safeguard_results를 완전히 전달해야 하지만, 업스트림이 지원하지 않으면 전달이 무효가 됩니다. - 시작 방법: APIYI apiyi.com의 하나의 Key로 Claude 네이티브와 Deepseek 두 경로를 비교할 수 있습니다.
Claude Code Auto Mode 과금 경고 정리
Claude Code에 Deepseek API를 연동한 뒤 나타나는 Auto Mode 경고는 본질적으로 과금 및 보안 검토 아키텍처의 업그레이드 안내입니다:
- 고장이 아닙니다: Deepseek는 현재도 Auto Mode를 정상적으로 구동할 수 있으며, 다만 분류기가 계속 기존 방식으로 과금될 뿐입니다.
- 단기 해결책이 있습니다: 환경 변수나
settings.json으로 서버 측 모드를 끄면 경고로 인한 방해를 없앨 수 있습니다. - 장기적으로는 선택이 필요합니다: 기존 폴백 방식은 제거될 예정이므로, Auto Mode에 크게 의존하는 팀은 업스트림이 서버 측 보안 검토를 지원하는지 미리 평가해야 합니다.
- 게이트웨이가 따라와야 합니다: 중계 플랫폼은
anthropic-beta,safeguards,safeguard_results, Tool Use ID를 전달 점검 목록에 포함해야 합니다.
일상적으로 주로 Deepseek를 사용하는 개발자라면, 먼저 CLAUDE_CODE_AUTO_MODE_SERVER=0만 설정하면 됩니다. 무료 분류기를 누리고 싶다면 Claude 네이티브 모델로 한 번 대조 테스트를 해보길 권장합니다. APIYI apiyi.com을 통해 서로 다른 업스트림이 Claude Code에서 실제로 어떻게 동작하는지 빠르게 검증해볼 수 있으며, 플랫폼은 무료 테스트 크레딧과 다중 모델 통합 인터페이스를 제공합니다.
📚 참고 자료
-
Anthropic 공식 문서 – Auto Mode 분류기 과금 설명: Claude Code Auto Mode의 기존·신규 과금 메커니즘과 게이트웨이 호환 요구사항
- 링크:
code.claude.com/docs/en/auto-mode-classifier-billing - 설명:
CLAUDE_CODE_AUTO_MODE_SERVER환경 변수,/status확인 방법, 필드 전달(pass-through) 요구사항을 담은 공식 설명
- 링크:
-
Deepseek API 공식 인터페이스: Anthropic 호환 인터페이스의 업스트림 주소
- 링크:
api.deepseek.com - 설명: 이 글에서 다루는 서드파티 업스트림인데, 현재 서버 측 보안 검토와는 아직 호환되지 않아요
- 링크:
작성자: APIYI 기술 팀
기술 문의: Claude Code 연동과 업스트림 호환 문제에 관해서는 docs.apiyi.com 문서 센터에서 더 많은 설정 자료를 확인하실 수 있어요
