Claude Code + DeepSeek V4 Flash: 연결 방법과 작업 비용

DeepSeek에는 Anthropic 형식의 주소(https://api.deepseek.com/anthropic)가 있고, Claude Code를 위한 공식 가이드도 있습니다. 키는 DeepSeek 콘솔(platform.deepseek.com)에서 만들고, 잔액은 미리 충전해 둡니다. 2026년 11월 2일 기준 DeepSeek 가이드에 나온 환경 변수는 다음과 같습니다:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-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
claude

처음 실행하기 전에 알아두면 좋은 점:

• 모델 이름. 2026년 9월 10일부터 deepseek-flash는 V4.1 Flash를 가리키며, 10월 17일부터는 같은 가격에 업데이트 버전 1017이 적용됩니다. 예전 이름인 deepseek-v4-flash도 DeepSeek는 아직 받아주지만, 응답하는 모델은 동일한 V4.1 Flash입니다. 접미사 [1m]은 모델의 컨텍스트 윈도우가 100만 토큰임을 Claude Code에 알려주고, CLAUDE_CODE_AUTO_COMPACT_WINDOW는 어느 용량에서 기록을 압축할지 지정합니다.
• Claude 이름. Claude Code에서 Claude라는 이름의 모델을 그대로 두면 DeepSeek가 자사 모델로 대체합니다. claude-opus 계열 이름은 V4 Pro로 연결되어 V4 Pro 가격으로 청구되고, 나머지는 deepseek-flash로 갑니다. 그래서 가이드에서는 모든 별칭을 명시적으로 고정했습니다.
• 피크 시간. 2026년 8월 16일부터 DeepSeek는 중국 공휴일을 제외한 평일 UTC 01:00~04:00와 06:00~10:00에 두 배 가격을 받습니다. 베이징 시간으로는 거의 하루 업무 시간 전체에 해당하고, 유럽에서는 아침, 미국에서는 저녁과 밤입니다.
• 웹 검색. Claude Code가 내장 도구로 인터넷을 검색할 때, 검색은 DeepSeek가 직접 수행합니다. 2026년 10월 31일부터는 유료이며, 성공한 요청 1,000건당 $0.75에 모델이 검색 결과를 읽는 데 쓰는 토큰이 추가로 부과됩니다.

Gonka 네트워크에서는 DeepSeek V4 Flash 버전 0731이 돌아갑니다 — MIT 라이선스의 오픈 웨이트입니다. 게이트웨이가 Claude Code의 요청을 Anthropic 형식(/v1/messages)으로 그대로 받으므로 중간 계층이 필요 없습니다.

1단계. 키. JoinGonka Gateway에 가입하면 — 신규 계정에는 3M 무료 토큰이 지급됩니다 — 관리 페이지에서 jg-… 키를 생성하세요.

2단계. 설치 프로그램.

npx @joingonka/setup --tool claude-code --model deepseek

설치 프로그램은 키를 물어보고, ~/.claude/settings.json 복사본을 저장하며, env 블록에 자기 변수만 기록합니다: 게이트웨이 주소와 키, 현재 및 새 세션용 모델, 별칭 opus, sonnet, fable 및 서브에이전트용 모델, Claude Code가 백그라운드 작업을 유지하는 별칭 haiku용 MiniMax M2.7, 모델의 실제 한계 — 380,000 토큰 윈도와 최대 32,768 응답. 나머지 설정은 건드리지 않고, 키 파일에는 600 권한을 설정합니다. 마지막으로 설치 프로그램은 실제 요청으로 키를 검증합니다. 같은 설치 프로그램이 다른 프로그램도 설정할 수 있습니다 — 이미 25개이며 Codex CLI와 OpenCode도 포함됩니다.

3단계. 확인. claude를 실행하고 /status를 엽니다: 게이트웨이 주소가 있는 Anthropic base URL 줄과 ANTHROPIC_AUTH_TOKEN이 있는 Auth token 줄이 있어야 합니다. 그런 다음 코드 작업을 맡겨보세요. 예를 들어 Read calc.py and tell me in one sentence whether it has a bug.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai",
    "ANTHROPIC_AUTH_TOKEN": "jg-your-key",
    "ANTHROPIC_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMaxAI/MiniMax-M2.7",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "380000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32768"
  }
}

Windows와 단일 프로젝트 전용 설정을 포함한 모든 설정 방법은 Claude Code 가이드에 있습니다.

실무에서 이것이 의미하는 바:

• 모델 버전. V4.1 Flash가 더 새롭고, DeepSeek 자체 테스트에서도 더 강력합니다. Terminal-Bench 2.1에서 V4.1 Flash가 90.6, V4 Flash 0731이 82.7을 기록했습니다(9월 10일과 7월 31일 릴리스 데이터 기준). 이미지, 100만 토큰 윈도우, 최신 버전이 필요하면 공식 API DeepSeek를 선택하세요. 대규모 작업 비용과 시간대에 상관없는 단일 가격이 더 중요하다면, 게이트웨이를 통한 V4 Flash를 직접 과제에서 비교해 보세요. 무료 토큰으로 시작할 수 있습니다.
• 장시간 세션. 380,000 토큰 윈도우에는 100만 토큰보다 적은 기록이 들어갑니다. 일반 업무에는 충분합니다. 2026년 10월 당사 게이트웨이를 통한 DeepSeek V4 Flash에 대한 Claude Code의 평균 요청은 약 96,000 토큰입니다.

모델 자체에 대한 자세한 내용은 Gonka 네트워크의 DeepSeek V4 Flash 기사에서 확인하세요.

먼저 2026년 11월 2일 기준 100만 토큰당 가격입니다 — DeepSeek 가격 페이지와 OpenRouter API 기준입니다. DeepSeek 옆에는 OpenRouter의 최저가 제공업체에서 제공하는 동일한 V4 Flash 0731을 배치했습니다:

일반 입력은 저희가 DeepSeek보다 24~49배 저렴하고, 출력은 32~65배 저렴합니다. 하지만 DeepSeek의 캐시 읽기는 피크 시간대에 거의 저희 입력과 비슷하고, 그 외 시간대에는 저희의 절반 수준이며, Claude Code는 거의 항상 같은 것 — 시스템 프롬프트, 도구 설명, 세션 기록 — 을 다시 읽습니다. 따라서 토큰 가격이 아니라 전체 작업을 비교해야 합니다.

작업. 모델에 대한 30회 호출로 구성된 작업을 가정해 봅시다 — 예를 들어 버그를 찾고, 코드를 수정하고, 테스트를 실행하는 경우입니다. 2026년 10월 당사 게이트웨이 데이터에 따르면, DeepSeek V4 Flash에 대한 Claude Code 요청은 평균적으로 입력 약 96,000 토큰, 출력 0.9천 토큰입니다. 합계로 작업은 입력 290만 토큰, 출력 27,500 토큰입니다. Claude Code는 각 단계에서 세션을 다시 전송하고, 그 대부분이 이전 요청과 중복되므로 DeepSeek와 OpenRouter에서는 입력의 95%가 캐시에서 읽힌다고 가정합니다.

금액은 2026년 11월 2일 가격으로 계산되었습니다. 이 페이지의 저희 토큰 가격은 실시간이며 GNK 환율에 따라 변동합니다. 이런 작업에서 게이트웨이는 DeepSeek 피크 시간대보다 약 5배, 그 외 시간대보다 2.5배, OpenRouter에서 동일 모델의 최저가 제공업체보다 2.3배 저렴합니다.

차이는 캐시에 달려 있습니다. 입력의 98%가 캐시에서 읽히면 DeepSeek는 피크 외 시간대에 저희보다 약 1.8배, 피크 시간대에 3.7배 비쌉니다. 90%라면 — 3.7배와 7.4배입니다. 저희는 캐시 비율이 금액에 영향을 미치지 않습니다: 모든 입력이 동일한 가격입니다. 월간 계산, GLM-5.3 Flash 사례, 참고용 Claude 자체 가격은 「Claude Code 더 저렴하게」 기사에서 확인하세요.

Claude Code Router(CCR)는 MIT 라이선스의 오픈 소스 프로젝트입니다. 사용자 컴퓨터에서 실행되는 로컬 게이트웨이로 기본 주소는 http://127.0.0.1:3456입니다. Claude Code와 다른 에이전트가 요청을 보내면 CCR이 선택한 프로바이더로 전달합니다. 요청을 포맷 간(Anthropic Messages, OpenAI Chat, Responses, Gemini)에 변환하고, 규칙에 따라 작업을 모델별로 라우팅하며, 장애 시 대체 모델로 전환하고, 토큰과 비용 추정치가 포함된 요청 로그를 기록합니다. macOS, Windows, Linux용 앱으로 설치하거나 npm install -g @musistudio/claude-code-router 명령으로 설치할 수 있습니다(Node.js 22 이상 필요).

DeepSeek 하나만 쓴다면 CCR은 필요 없습니다. DeepSeek에는 Anthropic 포맷의 자체 엔드포인트가 있고, JoinGonka Gateway도 Claude Code 요청을 직접 받습니다. CCR이 유용한 경우는 다음과 같습니다:

• 여러 프로바이더를 등록하고 어떤 작업을 어디로 보낼지 규칙을 관리하고 싶을 때;
• 주 모델이 응답하지 않을 때 자동으로 대체 모델로 전환하고 싶을 때;
• 요청, 토큰, 비용 로그를 한곳에서 보고 싶을 때;
• OpenAI 포맷만 이해하는 프로바이더를 연결하고 싶을 때.

CCR은 커스텀 엔드포인트를 Anthropic Messages 또는 OpenAI Chat 프로토콜로 연결할 수 있으며, 저희 게이트웨이는 두 프로토콜을 모두 지원합니다. 기본 주소는 Anthropic용이 https://gate.joingonka.ai, OpenAI용이 https://gate.joingonka.ai/v1입니다. 자세한 내용은 Gonka API 문서의 Anthropic Messages 섹션을 참고하세요.

Claude Code는 서드파티 API 키를 두 변수 중 하나에서 가져옵니다:

• ANTHROPIC_AUTH_TOKEN — 키가 Authorization: Bearer 헤더로 전송되며 즉시 적용됩니다. DeepSeek 가이드와 저희 설치 프로그램 모두 이 방식을 씁니다.
• ANTHROPIC_API_KEY — 키가 x-api-key 헤더로 전송됩니다. 대화형 모드에서는 Claude Code가 한 번 사용 여부를 묻습니다.

DeepSeek와 JoinGonka 모두 두 헤더를 받습니다. 키 변수가 설정되어 있는 동안에는 claude.ai 구독이 소모되지 않습니다. Claude Code는 로그인 정보를 기억하지만 전송하지 않고, 요청은 해당 키의 잔액에서 결제됩니다. 키 없이 주소만 설정하면 Claude Code가 새 주소로 claude.ai 로그인 정보를 보내 요청이 실패합니다.

키는 ~/.claude/settings.json 또는 프로젝트의 .claude/settings.local.json에 보관하세요. 리포지토리의 공용 .claude/settings.json에는 두지 마세요. 보통 커밋되기 때문입니다. --scope local 플래그가 있는 설치 프로그램은 settings.local.json에 쓰고 자동으로 .gitignore에 추가합니다.

Claude로 돌아가기 — env 블록에서 DeepSeek나 게이트웨이를 가리키는 줄을 제거하고 Claude Code를 재시작하면 다시 claude.ai 로그인 정보를 사용합니다.