두 개의 환경 변수로 DeepSeek, GLM 및 Qwen에서 Claude Code 실행하기

Claude Code는 백엔드와 Anthropic Messages 형식으로 통신합니다. 이 형식을 수용하는 모든 엔드포인트가 Anthropic의 API를 대신할 수 있다는 의미이며, 이는 프록시나 변환기 없이 DeepSeek, GLM, Qwen 또는 Kimi에서 동일한 에이전트 루프를 실행할 수 있음을 의미합니다.

저는 Claude Code 2.1.284로 테스트하여 각 모델로 실제 파일을 생성하고 작성하도록 요청했으며, 오늘 DeepSeek 케이스를 2.1.296으로 재실행했습니다. 설정과 제가 발견한 내용은 다음과 같습니다.

공개: 아래에서 사용된 게이트웨이 XHuoAPI를 실행합니다. 동일한 두 변수는 모든 Anthropic 호환 엔드포인트와 작동합니다.

설정 (Setup)

Claude Code 설치 (Node.js 18+):

pm install -g @anthropic-ai/claude-code

게이트웨어를 가리키도록 설정합니다. 기본 URL에서 /v1을 제외하세요. Claude Code가 자체적으로 /v1/messages를 추가하기 때문입니다:

export ANTHROPIC_BASE_URL=https://api.xhuoapi.ai
export ANTHROPIC_AUTH_TOKEN=YOUR_KEY
export ANTHROPIC_MODEL=deepseek-v3.2
...

또는 셸 설정을 건드리고 싶지 않다면 ~/.claude/settings.json의 env 블록에 동일한 값을 넣을 수 있습니다.

일회성 작업으로 연결 확인:

claude -p "Reply with the single word: ok"

모델 전환 (Switching models)

ANTHROPIC_MODEL과 ANTHROPIC_DEFAULT_HAIKU_MODEL을 함께 변경해야 합니다. 두 번째 변수가 중요합니다. Claude Code는 일부 백그라운드 작업을

• 프롬프트 캐싱(Prompt caching)이 여기서 많은 역할을 합니다. Claude Code는 요청마다 긴 시스템 프롬프트를 전송합니다. 첫 번째 요청은 캐시에 약 36K 토큰을 기록했고, 이후 요청들은 이 캐시에서 약 64K를 읽어옵니다. 대부분의 모델에서 캐시 읽기는 일반 입력보다 훨씬 저렴하게 청구되므로, 긴 세션 비용이 실제 토큰 수로 추정되는 것보다 적게 들 수 있습니다.
• unrecognized_model 메시지는 예상됩니다. 2.1.290 버전부터 Claude Code는 알지 못하는 모델 ID(예: deepseek-v3.2)에 대해 가정된 컨텍스트 창 내에서 세션을 자동 압축하고 [claude-code:unrecognized_model]을 출력합니다. 작업은 여전히 실행됩니다. 이전 동작 방식을 원한다면 CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1로 설정하세요.
• ANTHROPIC_AUTH_TOKEN 대 ANTHROPIC_API_KEY. 전자는 Authorization: Bearer로, 후자는 x-api-key로 전송됩니다. Claude Code가 처음으로 API_KEY를 볼 때 표시하는 상호 작용 확인 프롬프트를 피하려면 AUTH_TOKEN을 사용하세요.

설정 파일 버전과 모델별 참고 사항이 포함된 전체 가이드는 여기에 있습니다: [https://xhuoapi.ai/en/guides/claude-code.html?utm_source=devto&utm_medium=article&utm_campaign=claude-code]