DeepSeek V4.1 Flash 전환 가이드 — 모델 이름·요금·Claude Code 설정
DeepSeek V4.1 Flash 9월 14일 전환 — 기존 API 이름의 연결 대상과 피크 요금.
목차
DeepSeek는 9월 10일 V4.1 Flash를 공개했습니다. 기존 V4 Flash 이름은 이미 새 모델로 연결되며, V4 Pro도 2026년 9월 14일 오후 1시(한국 시간)부터 V4.1 Flash로 연결될 예정입니다. 모델 이름을 그대로 둬도 응답 모델과 요금이 달라질 수 있으므로, 전환 전에 현재 설정과 실제 호출 경로를 확인해야 합니다. [1]
1. 핵심 요약
공식 API 이름은 deepseek-flash입니다. 예전 이름이 계속 받아들여져도 예전 모델이 유지되는 것은 아닙니다. 이번 전환은 코드의 문자열 변경뿐 아니라 모델의 동작·과금·연동 설정까지 함께 확인해야 하는 작업입니다. 일정과 단가는 DeepSeek 공식 발표 및 요금표 기준입니다. [1] [2]
주제 선정 당시 HN의 DeepSeek 게시물은 691점·371댓글로 관심이 컸습니다. 이는 한 커뮤니티의 관측값이며 전체 사용자 관심도 순위는 아닙니다. 이 글은 실측 성능 리뷰가 아니라 공식 문서를 대조한 전환 가이드입니다. [7]
2. 모델 이름과 실제 연결 대상
API 모델 이름은 요청에 넣는 식별자입니다. 그 식별자가 연결하는 실제 모델은 서비스 운영사가 바꿀 수 있습니다. DeepSeek는 이번 발표에서 기존 이름의 호환 경로와 Pro 전환 시점을 명시했습니다. 아래 표는 DeepSeek가 운영하는 API 기준이며, 다른 회사의 중계 서비스에 같은 일정이 적용된다는 뜻은 아닙니다. [1] [2]
| 요청의 모델 이름 | 2026-09-11 기준 연결 대상 | 9월 14일 13시 이후 예정 |
|---|---|---|
deepseek-flash | V4.1 Flash | V4.1 Flash |
deepseek-v4-flash | V4.1 Flash로 임시 호환 연결 | 기존 이름의 지원 종료일은 확인되지 않음 |
deepseek-v4-flash-vision-exp | V4.1 Flash로 임시 호환 연결 | 기존 이름의 지원 종료일은 확인되지 않음 |
deepseek-v4-pro | V4 Pro · Pro 요금 | V4.1 Flash · Flash 요금. 향후 V4.1 Pro 출시 전까지 |
원문 일정은 2026-09-14 04:00 UTC입니다. 한국은 UTC보다 9시간 빠르므로 같은 날 13시입니다. 기존 Flash 두 모델은 이미 종료됐고 이름만 임시로 받아 주는 상태입니다. 예전 모델 이름을 남겨 두는 것만으로 예전 동작으로 되돌릴 수는 없습니다. [1]
공식 문서는 새 모델이 이미지 이해를 지원하며 OpenAI 형식과 Anthropic 형식으로 호출할 수 있다고 안내합니다. 다만 호출 형식의 호환성과 개별 기능의 동일성은 별도로 확인해야 합니다. 예를 들어 Anthropic 형식의 일부 메시지 유형은 지원하지 않습니다. 구체적인 차이는 5절에서 다룹니다. [4]
3. 한국 시간으로 보는 요금
토큰은 모델이 입력과 출력을 처리하는 단위로, 글자나 단어 수와 같지 않습니다. 아래 금액은 모두 미국 달러, 100만 토큰당 V4.1 Flash 공식 API 단가이며 2026-09-11에 확인했습니다. 입력 중 캐시에서 재사용된 부분과 새로 처리한 부분, 출력이 서로 다른 단가로 계산됩니다. [2]
| 과금 항목 | 피크 | 비피크 |
|---|---|---|
| 입력 · 캐시 적중 | $0.006 | $0.003 |
| 입력 · 캐시 미적중 | $0.30 | $0.15 |
| 출력 | $1.20 | $0.60 |
피크 시간은 원문 기준 월~금 01:00~04:00 UTC, 06:00~10:00 UTC입니다. 이를 한국 시간으로 환산하면 월~금 10:00~13:00, 15:00~19:00입니다. 나머지 시간은 비피크이며 공식 단가는 절반입니다. 이는 시간대를 환산한 값으로, 특정 작업을 실제 실행해 측정한 할인율은 아닙니다. [2]
같은 사용량을 가정한 계산 예시
여러 호출을 합쳐 과금 대상 입력 100만 토큰과 출력 10만 토큰을 사용했다고 가정합니다. 출력은 청구되는 전체 출력 토큰을 뜻합니다. 아래는 공식 단가를 곱한 편집부의 파생 계산이며, 실제 작업 한 건의 비용이나 품질을 측정한 결과가 아닙니다. 모든 호출이 한 요금 구간 안에 있다고 가정하고 중계 서비스 비용 등은 포함하지 않았습니다.
| 가정 | 피크 계산 | 피크 합계 | 비피크 합계 |
|---|---|---|---|
| 입력 캐시 적중 없음 | 1 × $0.30 + 0.1 × $1.20 | $0.4200 | $0.2100 |
| 입력 90% 캐시 적중 | 0.9 × $0.006 + 0.1 × $0.30 + 0.1 × $1.20 | $0.1554 | $0.0777 |
캐시 적중률 90%는 계산을 위한 가정입니다. 공식 캐시 문서는 적중을 보장하지 않는다고 명시합니다. OpenAI 형식 응답의 usage에서 prompt_cache_hit_tokens와 prompt_cache_miss_tokens를 확인해 실제 사용량으로 다시 계산해야 합니다. Anthropic 형식에 cache_control을 넣는다고 해서 이 적중률이 보장되지는 않습니다. [6] [4]
작업 비용에는 재시도와 도구 사용에 따른 추가 모델 호출도 영향을 줍니다. DeepSeek의 Claude Code 연동 문서는 웹 검색 결과를 요약하기 위한 추가 모델 요청에 토큰 비용이 발생한다고 설명합니다. 따라서 모델 단가와 실제 업무 한 건을 끝내는 비용을 함께 비교해야 합니다. [3]
4. Claude Code 설정에서 확인할 것
DeepSeek의 공식 연동 문서는 Claude Code가 호출하는 API 주소와 인증 정보를 DeepSeek 쪽으로 설정하는 방법을 제공합니다. 이 구성에서는 Claude Code를 인터페이스로 사용하면서 모델 요청은 DeepSeek API로 보냅니다. Anthropic의 Claude 모델을 그대로 사용하면서 요금만 바꾸는 설정이 아닙니다. [3]
| 환경변수 | 공식 가이드의 값 | 확인할 점 |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.deepseek.com/anthropic | 모델 요청을 보낼 API 주소 |
ANTHROPIC_AUTH_TOKEN | 본인의 DeepSeek API 키 | 설정 파일·명령 기록에 키를 그대로 남기지 않도록 관리 |
ANTHROPIC_MODEL | deepseek-flash[1m] | 기본 모델. 아래 역할별 모델도 따로 점검 |
ANTHROPIC_DEFAULT_OPUS_MODELANTHROPIC_DEFAULT_SONNET_MODEL | deepseek-flash[1m] | Opus·Sonnet 역할에 사용할 모델을 명시 |
ANTHROPIC_DEFAULT_HAIKU_MODELCLAUDE_CODE_SUBAGENT_MODEL | deepseek-flash | Haiku 역할·서브에이전트용 모델 |
CLAUDE_CODE_EFFORT_LEVEL | max | 공식 예시의 추론 설정. 모든 작업에 최적인 값이라는 뜻은 아님 |
CLAUDE_CODE_AUTO_COMPACT_WINDOW | 786432 | 대화 압축 관련 공식 예시 설정 |
[1m]은 이 연동 예시에서 쓰는 100만 토큰 컨텍스트 설정 표기입니다. 컨텍스트 윈도우는 모델이 한 번에 처리하는 대화와 자료의 범위입니다. 일반 DeepSeek API 요청의 모델 이름은 deepseek-flash이며, 위 표의 Claude Code용 문자열을 모든 호출 형식에 그대로 쓰라는 뜻은 아닙니다. [3] [2]
역할 이름도 확인해야 합니다. DeepSeek의 Anthropic 호환 API는 claude-opus로 시작하는 이름을 deepseek-v4-pro로, claude-haiku·claude-sonnet으로 시작하는 이름을 deepseek-flash로 연결한다고 설명합니다. 앞의 Pro 경로는 9월 14일 13시 이전까지 Pro 요금입니다. 위 표처럼 역할별 모델을 명시했는지, 기존 Claude 이름이 요청에 남아 있는지 구분해야 합니다. [3]
5. API 호환에서 달라지는 동작
호환 API는 같은 형식으로 요청을 보낼 수 있게 하지만 모든 필드가 같은 동작을 보장하지는 않습니다. 다음은 2026-09-11 확인한 DeepSeek의 Anthropic 호환 API 문서에 명시된 항목입니다. 이 표를 Anthropic 자체 API의 지원 여부로 읽으면 안 됩니다. [4]
| 필드·메시지 유형 | DeepSeek 호환 API의 안내 | 전환 시 확인할 것 |
|---|---|---|
thinking.budget_tokens | 무시됨 | 기존 토큰 예산 설정이 추론량을 제한한다고 가정하지 않기 |
output_config | effort만 지원 | 추론 강도를 별도로 설정하고 결과 비교 |
도구·메시지의 cache_control | 무시됨 | 캐시 사용량을 실제 응답에서 확인 |
disable_parallel_tool_use | 무시됨 | 도구 호출이 순차 실행된다고 이 설정만으로 보장하지 않기 |
tool_result.is_error | 무시됨 | 도구 실패가 후속 모델 요청에서 어떻게 전달되는지 점검 |
document·search_result 콘텐츠 유형 | 지원하지 않음 | 기존 메시지 형식을 그대로 재사용할 수 있는지 확인 |
추론 모드는 모델이 최종 답변 전에 추가 추론을 수행하는 방식입니다. DeepSeek의 기본값은 추론 활성화와 high 강도입니다. 일반 OpenAI Chat Completions 형식에서는 thinking과 reasoning_effort를 사용하며, Anthropic 형식에서는 추론 강도에 output_config.effort를 사용합니다. 요청 형식을 섞어 설정하지 마세요. [5]
직접 Chat Completions 연동을 구현한다면 대화 기록도 확인해야 합니다. 공식 문서는 추론 모드에서 tools를 포함한 요청의 후속 호출에, 도구 호출이 없었던 차례를 포함한 이전 모든 응답의 reasoning_content를 온전히 전달해야 하며, 누락하면 HTTP 400 오류가 발생한다고 설명합니다. 이 필드는 API가 반환하는 추론 내용입니다. 도구를 쓰지 않는 일반 대화에서는 같은 필드를 다시 전달할 필요가 없다고 구분합니다. 이는 해당 API 연동 규칙이며, Claude Code 사용자가 대화 내부 데이터를 직접 수정하라는 안내가 아닙니다. [5]
운영 제안은 정상 응답 하나만 보는 대신, 도구 실패·복수 도구 호출·여러 차례 이어지는 대화도 함께 점검하는 것입니다. 무시되는 필드를 오류 없이 전송할 수 있다는 사실은 그 설정이 적용됐다는 증거가 아닙니다.
6. 전환 전 체크리스트
아래는 공식 문서의 전환 조건에서 도출한 편집부의 검증 순서입니다. 실제 성능이나 비용 절감을 보장하는 절차는 아닙니다.
- 호출 경로를 기록합니다. DeepSeek 직접 API인지 중계 서비스인지, 요청의 모델 이름과 역할별 모델 설정이 무엇인지 확인합니다. 중계 서비스의 전환 일정은 해당 서비스에서 따로 확인합니다.
- 자동 전환 시점을 일정에 반영합니다. Pro 경로는 한국 시간 9월 14일 13시 예정입니다. 기존 Flash 이름은 이미 새 모델로 연결된다는 점도 기록합니다.
- 대표 작업을 같은 조건으로 비교합니다. 문서 요약, 실제 코드 수정, 도구 호출처럼 본인이 사용하는 작업을 고르고 입력·추론 강도·도구 구성을 고정합니다. 종료된 모델을 과거 이름만으로 다시 호출할 수 있다고 가정하지 않습니다.
- 호환 API의 예외를 검증합니다. 추론 예산, 순차 도구 사용, 도구 오류 표시, 문서 메시지처럼 기존 코드가 의존하던 기능부터 확인합니다.
- 실제 청구 사용량으로 계산합니다. 캐시 적중·미적중 입력과 출력, 추가 호출을 합치고 피크·비피크를 구분합니다. 단가가 내려가도 작업당 호출 수가 늘면 절감 폭은 달라집니다.
- 복구 가능한 경로를 남깁니다. 설정 백업과 함께 실제 이용 가능한 대체 모델·서비스를 확인합니다. 이 글의 공식 호환 경로를 모델 버전 고정 수단으로 취급하지 않습니다.
전환 후 실패가 시간 초과로 나타나면 외부 도구 작업의 완료 여부도 확인해야 합니다. 무조건 재호출하기 전에 무엇을 확인할지는 에이전트 재시도 설계에 정리했습니다. 이 글에서는 모델 교체와 과금·호환 조건에 집중합니다.
7. 아직 결론이 아닌 것
- V4.1 Flash의 성능 우위를 독립 검증하지 않았습니다. DeepSeek는 V4 Pro 대비 성능·속도·비용 개선을 주장하지만, 이 글은 모델을 직접 실행하거나 공식 벤치마크를 재현하지 않았습니다. 공개 점수를 다른 평가 환경과 섞어 순위를 만들지 않았습니다.
- 호환 설정을 직접 실행한 결과가 아닙니다. 설정 표와 API 제한은 2026-09-11 공식 문서 기준입니다. 실제 Claude Code 버전·계정·네트워크에서의 연결 성공은 독자의 환경에서 확인해야 합니다.
- 비용 표의 사용량과 캐시 비율은 가정입니다. 실제 호출 길이, 재시도, 추가 모델 요청에 따라 업무 단위 비용이 달라집니다. 피크와 비피크 경계에 걸친 요청의 세부 과금 방식은 이 글에서 확정하지 않았습니다.
- 미래 일정은 발표된 계획입니다. 9월 14일 연결 전환은 아직 실행 전이며 변경될 수 있습니다. V4.1 Pro 출시일과 기존 Flash 호환 이름의 지원 종료일은 인용한 문서에서 확인하지 못했습니다.
- 관심도는 제한된 관측입니다. HN 점수·댓글과 국내 검색 노출로 주제를 골랐지만, 전체 사용자 검색량이나 국내 수요 1위를 입증하는 자료는 아닙니다.
- 중계 API·앱 구독·자체 호스팅은 별도입니다. 이 글의 요금과 전환 일정은 DeepSeek 직접 API 기준입니다. 공개 모델을 직접 운영하는 비용이나 다른 회사의 계약 가격으로 확장하지 않습니다.
8. 참고자료
| 자료 | 확인한 내용 | 성격·시점 |
|---|---|---|
| [1] DeepSeek-V4.1-Flash Release | 출시, 기존 모델 종료·이름 호환, Pro 전환 일정 | 개발사 1차 발표 · 2026-09-10 |
| [2] Models & Pricing | 모델 연결 대상, 입력·출력 단가, 피크 시간 | 공식 요금표 · 2026-09-11 확인 |
| [3] Integrate with Claude Code | 환경변수, 역할별 모델, Opus 연결 요금, 검색의 추가 비용 | DeepSeek 공식 연동 문서 · 2026-09-11 확인 |
| [4] Using the Anthropic API | DeepSeek의 모델 이름 변환과 필드·메시지 지원 범위 | DeepSeek 공식 호환 문서 · 2026-09-11 확인 |
| [5] Thinking Mode | 기본 추론 모드, 강도 설정, 도구 사용 시 대화 기록 | 공식 사용 문서 · 2026-09-11 확인 |
| [6] Context Caching | 캐시 적중·미적중 토큰 필드와 적중 보장의 한계 | 공식 사용 문서 · 2026-09-11 확인 |
| [7] HN: DeepSeek v4.1 Flash | 주제 선정 시 691점·371댓글 관측 | 커뮤니티 반응 · 한국 시간 2026-09-11 관측 |
요금과 API 동작 설명의 근거는 DeepSeek 문서입니다. 한국 시간 환산과 비용 예시는 편집부의 계산이며, 전환 체크리스트는 이를 바탕으로 한 운영 제안입니다. API 유료 호출이나 독자 환경의 설정 변경은 수행하지 않았습니다.