Claude Code에서 DeepSeek V4.1 Flash를 사용하는 설정 방법

Claude Code는 https://api.deepseek.com/anthropic을 통해 DeepSeek V4.1 Flash에 연결할 수 있습니다. 공식 설정은 주 모델·Opus·Sonnet에 deepseek-flash[1m], Haiku와 하위 에이전트에 deepseek-flash를 사용합니다. 이 구분은 공식 Claude Code 연동 가이드에 명시되어 있습니다.

2026년 9월 10일 공식 DeepSeek 직접 연결 문서와 대조했습니다. 유료 추론이나 Claude Code 작업 성공을 검증하지 않았습니다. 모델과 직접 API 접근은 출시 안내 및 API 연결 가이드에서 설명합니다.

설치된 Claude Code 설정하기

먼저 claude --version이 작동하는지 확인하세요. 설치되지 않았다면 최신 Claude Code 설치 안내를 따른 뒤 공급자 설정을 적용합니다. DeepSeek Platform에서 DeepSeek API 키를 발급받으세요.

macOS나 Linux에서는 Claude Code를 실행할 터미널에 아래 설정을 적용합니다. 토큰 자리의 예시 값을 로컬에서 교체하세요. 모델 이름을 따옴표로 감싸면 [1m]이 셸의 파일명 패턴으로 해석되는 것을 막을 수 있습니다.

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="REPLACE_WITH_DEEPSEEK_API_KEY"
export ANTHROPIC_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

추론 수준과 컨텍스트 압축 설정을 포함해 DeepSeek가 공개한 연동 값입니다. [1m] 형식은 클라이언트 연동 설정이며, 직접 API 모델 이름은 여전히 deepseek-flash입니다. 모든 API 요청에 해당 접미사를 붙이지 마세요.

Windows에서는 공식 가이드의 $env:NAME="value" 형식으로 같은 값을 설정할 수 있습니다. 인증 정보를 프로젝트 파일이나 공유할 터미널 기록에 남기지 마세요. 기존 공급자 설정으로 쉽게 돌아갈 수 있도록 처음에는 현재 셸 세션에만 적용하세요.

주 모델뿐 아니라 모든 모델 선택 확인하기

작업 흐름에서 주 모델 외에 다른 모델을 선택할 수 있으므로 Opus, Sonnet, Haiku와 하위 에이전트 변수도 중요합니다. 예전 기본값을 남겨 두면 일부 요청이 다른 경로로 갈 수 있습니다.

DeepSeek는 입력된 Claude 모델 이름의 자동 매핑도 설명합니다. claude-opus로 시작하는 이름은 V4 Pro에, claude-haiku와 claude-sonnet으로 시작하는 이름은 Flash에 연결됩니다. 가이드에 따르면 Opus 매핑에는 베이징 시간(UTC+8) 2026년 9월 14일 12:00까지 Pro 요금이 유지됩니다. 이후 Pro 요청도 Flash로 처리하고 Flash 요금을 적용합니다. 자세한 일정은 Pro 전환 가이드에서 확인하세요.

지금 V4.1 Flash를 평가하려면 위처럼 Flash를 명시하는 편이 적절합니다. 익숙한 Claude 이름만 보고 실제 처리한 DeepSeek 모델이나 요금을 판단할 수는 없습니다.

작은 작업 흐름과 비용 검증하기

설정한 터미널에서 테스트 프로젝트에 들어가 claude를 실행하세요. 범위를 좁힌 수정 요청 전에 파일 하나를 설명하도록 합니다. 변경 내역, 도구 동작과 테스트 결과를 확인하세요. 평소 하위 에이전트에 작업을 맡긴다면 그 경로도 검증해야 합니다.

해당 작업의 사용량과 과금은 공급자 기록에서 확인합니다. 이 예시는 설정 절차이며 실측 속도, 절감액이나 동등한 코딩 품질의 증거가 아닙니다. Flash 요금 가이드는 캐시 적중·미적중 입력, 출력과 피크·비피크 단가를 구분합니다.

인증이 실패하면 키와 엔드포인트를 함께 확인하세요. 요청 형식 문제는 응답의 오류 상세를 봐야 합니다. 모델 이름만 반복해서 바꿔도 잘못된 프로토콜은 고쳐지지 않습니다. Codex는 별도의 Responses API 설정을 사용합니다.

Ofox 같은 게이트웨이로 직접 연결 설정을 바꾸기 전에 실제 모델 ID, Anthropic 지원과 계정 가격을 확인하세요. Ofox 모델 목록에서 확인을 시작할 수 있지만, 이 글은 Ofox의 V4.1 Flash 제공 여부나 가입 후 사용 가능성을 확인한 것이 아닙니다.