DeepSeek V4는 Claude Code에 최적화되어 있습니다. CNBC가 출시 당일 보도했습니다. 공식 문서는 V4의 에이전트 코딩 벤치마크가 오픈소스 SOTA임을 확인합니다. 그러나 "이 모델이 에이전트와 작동한다"와 "정확히 어떻게 설정하는가" 사이에는 간극이 있습니다. 이 가이드는 실제 명령어와 함께 모델 라우팅, 기능 확장, 비용 최적화를 단계별로 그 간극을 메워줍니다.
DeepSeek V4 + Claude Code가 매력적인 스택인 이유
DeepSeek V4 Pro는 에이전트 코딩 벤치마크에서 GPT-5.5와 Claude Opus 4.7에 필적하면서도 비용은 훨씬 저렴합니다: 입력 토큰 1M당 $0.28 대 GPT-5.5의 $5/1M. 1M 토큰 컨텍스트 창을 지원하여 전체 코드베이스를 한 번에 처리할 수 있습니다. Apache 2.0 라이선스로 사용 제한 없이 자체 호스팅이 가능합니다. DeepSeek V4의 기능과 한계에 대한 전체 내용은 DeepSeek V4 기능 가이드를 참조하세요.
Claude Code는 Anthropic의 터미널 네이티브 자율 코딩 에이전트입니다. 저장소를 읽고, 다단계 변경을 계획하고, 파일을 편집하고, 테스트를 실행하며, 실패 시 반복합니다. MCP(모델 컨텍스트 프로토콜)를 네이티브로 지원하여 코드 이외의 기능으로 확장할 수 있습니다. Claude Code가 처음이라면 설치 가이드와 Claude Code vs Cursor 비교를 먼저 확인하세요.
조합은 간단합니다: DeepSeek V4가 추론과 코드 생성을 처리합니다. Claude Code가 에이전트 실행 — 파일 읽기, 명령 실행, git 관리 — 을 담당합니다. AnyCap(또는 MCP 서버)이 멀티모달 기능 — 이미지 생성, 비디오, 웹 검색, 저장, 게시 — 을 처리합니다.
사전 요구사항
시작하기 전에 다음을 확인하세요:
- DeepSeek V4 API 접근 — DeepSeek 플랫폼(api.deepseek.com), OpenRouter, 또는 자체 호스팅을 통해. 설정 옵션은 DeepSeek V4 개발자 가이드를 참조하세요.
- Claude Code 설치 —
claude --version이 버전 번호를 반환해야 합니다. 그렇지 않다면:curl -fsSL https://claude.ai/install.sh | bash - Node.js 18+ — Claude Code와 npm 기반 도구를 위해
- API 키 또는 OpenRouter 키 — Claude Code를 DeepSeek V4로 라우팅하기 위해
1단계: Claude Code를 DeepSeek V4로 라우팅
Claude Code는 기본적으로 Anthropic의 Claude 모델을 사용합니다. DeepSeek V4를 추론 엔진으로 사용하려면 Claude Code 에이전트 프로토콜과 DeepSeek V4의 API를 모두 지원하는 모델 제공자를 통해 라우팅해야 합니다.
옵션 A: OpenRouter (빠른 설정에 권장)
OpenRouter는 Anthropic과 DeepSeek 모델 모두에 대한 통합 API 접근을 제공합니다. openrouter.ai에서 가입하고 API 키를 받은 후 Claude Code를 구성하세요:
export OPENROUTER_API_KEY=sk-or-your-key-here
claude --model openrouter/deepseek/deepseek-v4-pro
Flash 변형의 경우 (더 빠르고, $0.14/1M 토큰으로 저렴):
claude --model openrouter/deepseek/deepseek-v4-flash
옵션 B: DeepSeek API 직접 + 커스텀 엔드포인트
DeepSeek API에 직접 접근할 수 있다면 커스텀 엔드포인트를 구성하세요. Claude Code 설정 또는 환경에서:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/v1
export ANTHROPIC_API_KEY=sk-your-deepseek-key
claude --model deepseek-v4-pro
참고: 직접 API 라우팅에는 호환성 차이가 있을 수 있습니다. 먼저 간단한 프롬프트로 테스트하세요: "이 프로젝트의 아키텍처를 세 문장으로 설명해 주세요."
옵션 C: 자체 호스팅 DeepSeek V4
DeepSeek V4를 로컬에서 실행 중이라면(llama.cpp, vLLM 등을 통해), Claude Code를 로컬 엔드포인트로 연결하세요:
export ANTHROPIC_BASE_URL=http://localhost:8000/v1
claude
4비트 양자화된 DeepSeek V4 Flash는 단일 소비자 GPU에서 실행됩니다. V4 Pro는 더 많은 VRAM이 필요하지만 워크스테이션급 하드웨어에서 실행 가능합니다.
라우팅 확인
Claude Code 세션을 시작하고 어떤 모델이 활성화되어 있는지 확인하세요:
> What model are you running on?
Claude Code는 구성된 경로를 통해 DeepSeek V4에서 실행 중임을 나타내는 응답을 해야 합니다.
2단계: AnyCap으로 멀티모달 기능 추가
DeepSeek V4는 텍스트 전용 모델입니다. 이미지 생성, 비디오 생성, 웹 검색, 파일 저장, 콘텐츠 게시가 불가능합니다. Claude Code는 에이전트 실행 레이어를 제공하지만 — 파일 읽기, 명령 실행, git 관리 — 이런 기능도 추가하지 않습니다.
AnyCap이 이 간극을 채웁니다. MCP 스킬로 설치하세요. MCP 구성 옵션에 대한 자세한 안내는 MCP로 Claude Code에 기능 추가하기 가이드를 참조하세요:
npx -y skills add anycap-ai/anycap -a claude-code
한 번 인증하세요:
anycap login
이제 DeepSeek V4 + Claude Code 에이전트가 다음을 수행할 수 있습니다:
| 기능 | 에이전트 세션에서의 명령 |
|---|---|
| 이미지 생성 | anycap image generate "설명" |
| 비디오 생성 | anycap video generate "설명" |
| 웹 검색 | anycap search "검색어" |
| 파일 저장 | anycap drive upload ./경로 |
| 페이지 게시 | anycap page publish ./file.md |
3단계: 프로젝트 컨텍스트 구성
Claude Code는 각 세션 시작 시 지속적인 프로젝트 컨텍스트를 위해 CLAUDE.md 파일을 읽습니다. DeepSeek V4 설정에 맞게 커스텀 파일을 만드세요:
# CLAUDE.md
## 모델 구성
- OpenRouter를 통해 DeepSeek V4 Pro에서 실행 중
- 1M 토큰 컨텍스트 창 사용 가능
- 텍스트 전용 모델 — 멀티모달 작업에는 AnyCap 사용
## 기능 확장
- 이미지 생성: anycap image generate
- 비디오 생성: anycap video generate
- 웹 검색: anycap search
- 파일 저장: anycap drive upload
- 게시: anycap page publish
Claude Code 내부에서 /init으로 초기 버전을 생성한 후 위의 섹션으로 커스터마이즈하세요. Claude Code 구성에 대한 자세한 내용은 고급 기능 가이드를 참조하세요.
4단계: 실제 워크플로우 엔드투엔드 실행
다음은 스택의 모든 구성 요소를 테스트하는 완전한 워크플로우입니다:
1. "AgentMetrics"라는 SaaS 제품의 랜딩 페이지 구축
- 하나의 엔드포인트가 있는 FastAPI 백엔드
- 간단한 HTML/CSS 프론트엔드
- 모든 코드 생성에 DeepSeek V4 사용
2. 랜딩 페이지를 위한 히어로 이미지 생성
- anycap image generate 사용
3. 생성된 에셋 저장
- anycap drive upload 사용
4. 랜딩 페이지 게시
- anycap page publish 사용
추론을 위해 DeepSeek V4를 사용하는 에이전트가 랜딩 페이지를 구축합니다. 히어로 이미지를 위해 AnyCap을 호출합니다. Drive에 에셋을 저장합니다. 결과를 게시합니다. 하나의 세션에서 세 가지 구성 요소가 함께 작동합니다.
비용 최적화: V4 Flash vs V4 Pro
DeepSeek V4는 두 가지 등급이 있습니다. 워크플로우에 따라 선택하세요:
| 변형 | 비용 (입력) | 비용 (출력) | 최적 용도 |
|---|---|---|---|
| V4 Flash | $0.14/1M 토큰 | $0.56/1M 토큰 | 빠른 반복, 단순 리팩토링, 비용 민감 워크플로우 |
| V4 Pro | $0.28/1M 토큰 | $1.12/1M 토큰 | 복잡한 다중 파일 리팩토링, 아키텍처 설계, 디버깅 |
대부분의 Claude Code 세션에서는 V4 Flash로 충분합니다. 빠르고 저렴하며 대부분의 코딩 작업을 잘 처리합니다. 복잡한 경쟁 조건 디버깅, 새로운 아키텍처 설계, 20개 이상의 파일에 걸친 리팩토링 등 더 깊은 추론이 필요할 때 V4 Pro로 전환하세요.
대안과의 비용 비교:
| 스택 | 무거운 코딩 세션당 대략적인 비용 |
|---|---|
| Claude Code + Claude Opus 4.7 | $5–15 (구독 또는 API) |
| Claude Code + GPT-5.5 | $3–10 (API 토큰당) |
| Claude Code + DeepSeek V4 Flash | $0.50–2 (API 토큰당) |
| Claude Code + DeepSeek V4 Pro | $1–4 (API 토큰당) |
입력 토큰 $0.14/1M의 DeepSeek V4 Flash는 Claude Opus 4.7의 약 1/35 비용입니다. 매일 에이전트를 사용하는 한 달 동안 차이는 수백 달러입니다. Claude Code 전체 요금제 비교는 요금제 비교를 참조하세요. DeepSeek V4와 GPT-5.5의 직접 비교는 기능 비교를 참조하세요.
이 스택이 탁월한 분야
대규모 리팩토링. DeepSeek V4의 1M 토큰 컨텍스트 창으로 Claude Code는 전체 모노레포를 한 번에 처리할 수 있습니다. 50개 이상의 파일에서 인터페이스 이름 변경, 임포트 업데이트, 테스트 스위트 실행이 단일 자율 세션에서 이루어집니다.
예산 제약 에이전트 워크플로우. 자율 코딩 에이전트를 원하지만 월 $100–200의 Claude Max가 부담스럽다면, DeepSeek V4 Flash + Claude Code + AnyCap이 동일한 에이전트 아키텍처를 훨씬 저렴한 비용으로 제공합니다.
자체 호스팅, 에어갭 개발. DeepSeek V4는 Apache 2.0 라이선스입니다. 자체 하드웨어에서 실행하세요. Claude Code와 결합하여 에이전트를 실행하세요. 인프라 내에서 유지되는 기능을 위해 AnyCap을 추가하세요. 데이터가 환경을 벗어나지 않습니다.
예산 내 멀티모달 에이전트 워크플로우. DeepSeek V4가 추론을 처리합니다. AnyCap이 이미지, 비디오, 검색, 저장, 게시를 처리합니다. 멀티모달 모델 비용 없이 완전한 멀티모달 에이전트를 얻을 수 있습니다. 자세한 내용은 DeepSeek V4에 멀티모달 기능 추가 가이드를 참조하세요.
자주 묻는 질문
DeepSeek V4가 Claude Code 대신 Cursor와 작동하나요?
네. 동일한 라우팅 패턴이 적용됩니다. Cursor에서 설정 → 모델 → 커스텀 모델 추가를 통해 DeepSeek V4를 모델 제공자로 추가하세요. AnyCap은 MCP 스킬로 동일하게 설치됩니다. 에이전트 셸은 상호 교환 가능합니다.
DeepSeek V4를 OpenClaw와 함께 사용할 수 있나요?
네. CNBC는 DeepSeek V4가 OpenClaw에 최적화되어 있다고 특별히 보도했습니다. 설정 패턴은 유사합니다: OpenClaw에서 모델 엔드포인트를 구성하고, 기능을 위해 AnyCap을 설치하세요.
DeepSeek V4의 에이전트 코딩 성능이 실제로 경쟁력이 있나요?
네. V4 Pro는 SWE-bench Verified에서 81%를 기록하며 GPT-5.5와 Claude Opus 4.7에 필적합니다. 에이전트 코딩 벤치마크에서 DeepSeek는 오픈소스 SOTA를 주장합니다. 실제 개발자 보고서는 특히 가격 차이를 고려했을 때 강력한 성능을 확인합니다. 전체 벤치마크 분석은 DeepSeek V4 개발자 가이드를 참조하세요.
한계는 무엇인가요?
DeepSeek V4는 텍스트 전용입니다 — 네이티브 멀티모달 없음. Claude Code의 에이전트 프로토콜은 Anthropic 모델을 위해 설계되었으므로 일부 Claude 전용 기능(확장 사고, 특정 권한 모델)은 DeepSeek V4 라우팅으로 완벽하게 변환되지 않을 수 있습니다. 스택을 확정하기 전에 특정 워크플로우를 테스트하세요. V4가 할 수 있고 없는 것에 대한 포괄적인 개요는 DeepSeek V4 기능 가이드를 참조하세요.
Claude Opus 4.7을 직접 사용하는 것과 어떻게 다른가요?
Claude Opus 4.7 + Claude Code는 가장 통합된 경험입니다 — 모든 것이 함께 작동하도록 설계되어 있습니다. DeepSeek V4 + Claude Code는 더 저렴하지만 라우팅 구성이 필요합니다. 절충점은 비용 대 통합 원활성입니다. 예산이 제약이 아니라면 네이티브를 유지하세요. 1/35 비용으로 프론티어 에이전트 코딩을 원한다면 DeepSeek V4가 선택입니다.
관련 기사
- DeepSeek V4: 완전한 개발자 가이드 — 아키텍처, 벤치마크, API 통합, 자체 호스팅, DeepSeek V4 통합에 필요한 모든 것.
- DeepSeek V4 vs GPT-5.5: 전체 기능 비교 — 벤치마크, 요금, 멀티모달 격차, 배포 유연성 나란히 비교.
- DeepSeek V4 에이전트에 멀티모달 기능 추가하기 — 2분 안에 DeepSeek V4 에이전트에 이미지 생성, 비디오, 웹 검색, 클라우드 저장소 추가.
- Claude Code vs Cursor: 2026년 어떤 AI 코딩 에이전트가 더 나은가? — 터미널 네이티브 에이전트 vs IDE 포크. 자율성, 컨텍스트 처리, 요금, 실제 작업 비교.
- MCP로 Claude Code에 에이전트 기능 추가하기 — 단계별 MCP 구성 가이드와 AnyCap 원커맨드 빠른 경로.
DeepSeek V4와 Claude Code 설정:
# Claude Code를 DeepSeek V4로 라우팅
export OPENROUTER_API_KEY=sk-or-your-key
claude --model openrouter/deepseek/deepseek-v4-pro
# 멀티모달 기능 추가
npx -y skills add anycap-ai/anycap -a claude-code