Claude Code에서 DeepSeek 모델을 쓰는 방법

Claude Code를 DeepSeek으로 설정하는 법

1. DeepSeek API 키 발급받기

   platform.deepseek.com의 API keys에서 키를 만들고 계정에 잔액을 충전하세요. 사용량은 토큰 단위로 과금돼요.

2. Claude Code가 없다면 설치하기

   DeepSeek 가이드는 npm으로 설치해요. Node.js 18 이상(Windows에서는 Git for Windows도)을 준비하고 npm install -g @anthropic-ai/claude-code를 실행한 뒤 claude --version으로 확인하세요.

3. 환경 변수 설정하기(macOS, Linux)

   이 변수들은 Claude Code가 DeepSeek의 Anthropic 호환 엔드포인트를 쓰게 하고, 메인 모델과 서브에이전트에 1M 컨텍스트의 deepseek-flash를 쓰며, effort 레벨과 자동 압축 창을 높여요. 계속 쓰려면 셸 프로필에 넣어 두세요.

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

4. Windows라면(PowerShell)

   같은 설정을 현재 세션용 PowerShell 환경 변수로 지정해요.

   $env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
   $env:ANTHROPIC_AUTH_TOKEN="<your DeepSeek API Key>"
   $env:ANTHROPIC_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
   $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
   $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
   $env:CLAUDE_CODE_EFFORT_LEVEL="max"
   $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

5. 프로젝트에서 Claude Code 실행하기

   cd로 프로젝트에 들어가 claude를 실행하세요. CLAUDE.md, skills, hooks, MCP 서버 같은 나머지는 평소처럼 설정하면 돼요.

출처: DeepSeek API 문서, Integrate with Claude Code

Claude 모델 이름이 DeepSeek 모델로 매핑되는 방식

Claude Code(또는 Claude 데스크톱 앱)가 Claude 모델 이름을 DeepSeek 엔드포인트로 보내면 DeepSeek은 아래처럼 매핑해요. 위 설정에서 모든 모델 변수를 deepseek-flash로 지정하는 이유가 이거예요. 그러지 않으면 Opus를 요청하는 호출은 모두 V4 Pro 가격으로 과금돼요.

비용은 얼마나 들까

2026년 11월 6일 기준 DeepSeek API 가격이며, 단위는 100만 토큰당 미국 달러예요. 비피크 시간대(평일 UTC 01:00–04:00과 06:00–10:00 외) 요금은 피크 요금의 절반이에요. Claude Code의 웹 검색도 DeepSeek API에서 작동하지만, 검색할 때마다 결과를 요약하느라 모델 토큰이 추가로 들고 DeepSeek의 Search API로 과금돼요.

Codex에서 DeepSeek 쓰기

DeepSeek은 Responses API를 통해 Codex도 지원해요. 가이드에 있는 설정 스크립트는 ~/.codex/config.toml을 백업하고, deepseek-flash와 deepseek-v4-pro가 들어 있는 ~/.codex/models.json 카탈로그를 만든 뒤 DeepSeek 제공자를 추가해요. 그러면 설정 하나로 Codex CLI, ChatGPT 데스크톱 앱, VS Code 확장이 모두 동작해요. 실행하기 전에 스크립트를 읽어 보거나, 같은 가이드의 수동 설정 단계를 따르세요. 내장 웹 검색은 스크립트가 꺼 두며, deepseek-v4-pro에서만 쓸 수 있어요. Codex 자체의 지침 파일은 Codex AGENTS.md 가이드를 참고하세요.

Claude Code + DeepSeek vs DeepSeek Harness

• Claude Code + DeepSeek: CLAUDE.md, skills, hooks, 플러그인을 포함해 Claude Code의 인터페이스와 익숙한 방식을 그대로 쓰면서, Claude 요금제 대신 DeepSeek의 토큰당 가격을 내요.
• DeepSeek Harness: 플러그인을 중심으로 만든 DeepSeek의 오픈소스 에이전트 앱으로, 데스크톱 앱과 웹 UI가 있어요. Claude Code나 Codex를 서브에이전트로 돌릴 수도 있어요. DeepSeek Harness 가이드를 참고하세요.
• 어느 쪽이든 모델은 같은 deepseek-flash와 deepseek-v4-pro이고, 요금은 DeepSeek이 청구해요.
• Anthropic 모델로 돌아가려면 변수를 해제하고(또는 변수가 없는 새 셸을 열고) 평소처럼 Claude Code에 로그인하면 돼요.

저렴한 모델, 하루 종일 일하게

Claude Code나 DeepSeek Harness를 DeepSeek 가격으로 돌리면 에이전트를 계속 일하게 해도 부담이 적어요. Crewmark는 그 세션을 직무, 목표, 근무 시간을 가진 AI 직원으로 바꾸고, 하트비트로 하나씩 깨워 보드에서 다음 이슈를 가져가게 해요.

1. 지금 쓰는 설정 그대로

   직원은 내 컴퓨터의 Claude Code, Codex, DeepSeek Harness, OpenCode 세션에서 내 환경과 키로 돌아가요.

2. 하트비트로 일을 시작하게 하기

   근무 시간 동안 직원은 15분, 30분, 60분마다 같은 대화에서 깨어나 다음 이슈를 가져가요. Claude Code를 능동적으로 만드는 방법을 참고하세요.

3. 청구액 관리하기

   근무 시간을 정하고 한 번에 이슈 하나만 맡기면 사용량을 예측할 수 있어요. Claude Code 토큰 사용량 줄이는 방법을 참고하세요.

Claude Code + DeepSeek 자주 묻는 질문