빠른 답변
DeepSeek V4를 Claude Code와 함께 사용하려면 가장 깔끔한 구성은 다음과 같습니다. 추론은 DeepSeek V4, 에이전트 루프는 Claude Code, 그리고 부족한 capability layer는 AnyCap 입니다. 이 조합은 DeepSeek V4의 더 낮은 비용의 코딩 성능을 활용하면서도, 에이전트가 실시간 웹 검색, 이미지 또는 영상 생성, 파일 저장, 결과물 게시까지 해야 할 때 특히 의미가 있습니다.
DeepSeek V4는 추론할 수 있습니다. Claude Code는 실행할 수 있습니다. 하지만 대부분의 팀은 이 조합을 실제 환경에서 작동하는 에이전트로 바꾸는 레이어가 여전히 부족합니다.
그 부족한 레이어는 “프롬프팅을 더 많이 하는 것”도 아니고, 일회성 통합을 더 쌓는 것도 아닙니다. 그것은 capability layer입니다. 즉, 코딩 셸이 기본으로 제공하지 않는 기능인 실시간 웹 검색, 이미지 생성, 영상 생성, 스토리지, 퍼블리싱을 에이전트에 제공하는 런타임입니다.
여기서 AnyCap이 들어갑니다. DeepSeek V4는 모델 추론을 담당하고, Claude Code는 리포지토리 안에서 에이전트 루프를 담당합니다. AnyCap은 이 두 요소에 아직 없는 capability runtime을 더해 줍니다.
이 가이드는 이 스택을 깔끔하게 구성하는 방법을 보여줍니다. 먼저 Claude Code를 DeepSeek V4로 라우팅하고, 그다음 AnyCap을 추가해 에이전트가 파일 읽기와 명령 실행을 넘어서 더 많은 일을 할 수 있게 합니다.
DeepSeek V4 + Claude Code가 매력적인 스택인 이유
DeepSeek V4가 매력적인 이유는 간단합니다. 최전선 수준의 코딩 성능을 훨씬 낮은 비용으로 제공하기 때문입니다. 큰 컨텍스트 윈도우, 강력한 에이전트형 코딩 벤치마크, 호스팅 제공자 경유 또는 셀프호스팅까지 가능한 유연한 배포 옵션을 제공합니다.
Claude Code는 자율 코딩 작업을 위한 가장 강력한 셸 중 하나입니다. 리포지토리를 살펴보고, 변경 계획을 세우고, 파일을 수정하고, 테스트를 실행하고, 반복 개선할 수 있습니다. 다시 말해 모델에 규율 있는 실행 루프를 제공합니다.
하지만 그것만으로 이 스택이 완성되는 것은 아닙니다.
이 구성에 실시간 경쟁사 페이지 조사, 출시용 비주얼 생성, 검토용 산출물 저장, 완성된 보고서 게시를 맡기면 곧바로 같은 한계에 부딪힙니다. 모델은 작업을 추론할 수 있고 Claude Code는 단계를 오케스트레이션할 수 있지만, 둘 중 어느 것도 capability runtime은 아닙니다.
그래서 더 정확한 아키텍처는 다음과 같습니다.
- DeepSeek V4 — 추론 모델
- Claude Code — 에이전트 셸 및 실행 루프
- AnyCap — 미디어, 검색, 스토리지, 퍼블리싱을 위한 capability runtime / 더 강력한 에이전트 CLI
잘 되는 부분과 깨지는 부분
잘 되는 부분:
- 코딩 중심 에이전트 워크플로를 위한 더 저렴한 모델 라우팅
- 실제 리포지토리 안에서 강력하게 작동하는 Claude Code의 실행 루프
- 추론, 오케스트레이션, capability 실행 간의 더 명확한 분리
capability layer가 없으면 깨지는 부분:
- 웹 검색과 크롤링이 필요한 실시간 리서치 작업
- 이미지 또는 영상 생성이 필요한 미디어 워크플로
- 저장, 공유, 퍼블리싱이 필요한 산출물 전달 작업
이것이 이 스택에 단순한 모델 경로와 셸이 아니라 AnyCap이 필요한 실질적인 이유입니다.
사전 준비 사항
시작하기 전에 다음을 확인하세요.
- DeepSeek V4 API 접근 권한 — DeepSeek, OpenRouter 또는 자체 호스팅 엔드포인트를 통해
- Claude Code 설치 완료 —
claude --version명령이 버전 번호를 반환해야 함 - Node.js 18+ — Claude Code와 일반적인 에이전트 도구에 필요
- 모델 경로용 API 키 — OpenRouter 또는 DeepSeek 직접 접근 키
1단계: Claude Code를 DeepSeek V4로 라우팅하기
Claude Code는 기본적으로 Anthropic 호스팅 모델을 사용합니다. 추론에 DeepSeek V4를 사용하려면 DeepSeek를 호환 가능한 엔드포인트로 제공하는 공급자를 통해 Claude Code를 라우팅해야 합니다.
옵션 A: OpenRouter
export OPENROUTER_API_KEY=sk-or-your-key-here
claude --model openrouter/deepseek/deepseek-v4-pro
더 저렴하고 빠른 기본값을 원한다면:
claude --model openrouter/deepseek/deepseek-v4-flash
옵션 B: DeepSeek 호환 직접 엔드포인트
export ANTHROPIC_BASE_URL=https://api.deepseek.com/v1
export ANTHROPIC_API_KEY=sk-your-deepseek-key
claude --model deepseek-v4-pro
옵션 C: 셀프호스팅 엔드포인트
export ANTHROPIC_BASE_URL=http://localhost:8000/v1
claude
시작 후 세션 내에서 활성 경로를 확인하세요.
> What model are you running on?
2단계: AnyCap으로 부족한 capability layer 추가하기
이 단계는 많은 글에서 흐릿하게 설명됩니다.
AnyCap은 “모델 그 자체”도 아니고 “Claude Code 자체”도 아닙니다. 그것은 Claude Code와 DeepSeek V4가 단독으로는 아직 제공하지 못하는 동작을 에이전트에 부여하는 capability runtime입니다.
여기에는 두 가지 요소가 있습니다.
- AnyCap CLI 설치 — 실행 표면입니다
- Claude Code에 AnyCap 스킬 추가 — 에이전트가 이 CLI를 효과적으로 사용하는 방법을 배우게 합니다
CLI 설치
curl -fsSL https://anycap.ai/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
한 번만 인증하기
anycap login
Claude Code에 스킬 추가
npx -y skills add anycap-ai/anycap -a claude-code
이제 스택에 빠져 있던 capability layer가 추가되었습니다.
실제로는 이것이 DeepSeek V4 + Claude Code 에이전트가 다음과 같은 일을 할 수 있다는 뜻입니다.
- 실시간 웹 검색
- 이미지 생성
- 영상 생성
- 산출물을 클라우드 스토리지에 업로드
- 완성된 결과물 게시
중요한 구분은 다음과 같습니다.
- DeepSeek V4 가 무엇을 할지 결정합니다
- Claude Code 가 에이전트 워크플로를 관리합니다
- AnyCap CLI 가 실제 기능을 실행합니다
- AnyCap 스킬 이 그 기능들을 잘 호출하는 방법을 에이전트에 가르칩니다
3단계: 프로젝트 컨텍스트 구성하기
Claude Code는 각 세션 시작 시 CLAUDE.md를 읽습니다. 이 파일로 아키텍처를 명확하게 드러내세요.
# CLAUDE.md
## Model route
- Running on DeepSeek V4 Pro via OpenRouter
- Use Flash for cheaper routine tasks
## Architecture
- DeepSeek V4 = reasoning model
- Claude Code = agent shell
- AnyCap = capability runtime for search, media, storage, and publishing
## Capability commands
- Search: anycap search
- Image generation: anycap image generate
- Video generation: anycap video generate
- Storage: anycap drive upload
- Publishing: anycap page publish
이렇게 하면 에이전트가 이 스택을 “모델 + 임의의 도구”로 취급하고, 일관된 model-shell-runtime 아키텍처로 보지 않는 흔한 실패를 막을 수 있습니다.
4단계: 실제 워크플로를 처음부터 끝까지 실행하기
좋은 테스트는 세 레이어를 모두 필요로 하는 작업입니다.
Build a landing page for a product called AgentMetrics.
- Use DeepSeek V4 for coding and reasoning
- Use Claude Code to edit files and run the workflow
- Use AnyCap to generate the hero visual
- Upload the assets
- Publish the finished page
이것이 단순한 코딩 설정과 실제 에이전트 설정의 핵심 차이입니다.
capability layer가 없으면 에이전트는 “코드는 작성했습니다”에서 멈춥니다.
capability layer가 있으면 리서치, 보조 미디어 생성, 결과 저장, 최종 산출물 배포까지 완료할 수 있습니다.
비용 최적화: Flash vs Pro
브랜딩이 아니라 추론 깊이에 따라 모델 티어를 선택하세요.
| Variant | Best for |
|---|---|
| DeepSeek V4 Flash | 빠른 반복, 더 단순한 코딩 작업, 저비용 에이전트 세션 |
| DeepSeek V4 Pro | 다중 파일 리팩터링, 더 어려운 디버깅, 아키텍처 결정 |
실용적인 패턴은 다음과 같습니다.
- 일상 작업은 Flash 를 기본값으로 사용
- 더 깊은 추론이 필요할 때는 Pro 로 전환
- 어떤 모델 티어를 선택하든 AnyCap 은 고정 capability layer로 유지
이렇게 하면 모델을 바꿀 때마다 capability 스택을 다시 만들 필요가 없습니다.
이 스택이 실제로 잘하는 것
1. 대규모 코드베이스 에이전트 작업을 더 낮은 비용으로 수행
DeepSeek V4가 추론을 맡고 Claude Code가 리포지토리 수준의 루프를 맡습니다. 모든 세션마다 프리미엄 모델 가격을 지불하지 않고도 강력한 코딩 성능을 얻을 수 있습니다.
2. 단순한 코드 제안이 아니라 실제 에이전트 결과물 생성
여기서 AnyCap이 가장 중요합니다. 많은 “에이전트” 설정은 여전히 셸 + 텍스트 수준에 머물러 있습니다. 코드를 살펴보고 수정할 수는 있지만, 작업의 비코드 부분을 끝내지는 못합니다.
워크플로에 리서치, 미디어, 파일 전달, 퍼블리싱이 필요하다면 capability runtime이 빠진 조각입니다.
3. 무작위 MCP 서버를 쌓는 것보다 더 깔끔한 아키텍처
MCP는 여전히 적절한 곳에서 쓸 수 있습니다. 특히 내부 도구나 독점 시스템에는 유용합니다. 하지만 일반적인 공통 기능에 대해서 더 깔끔한 사고방식은 “서버를 하나 더 추가하자”가 아니라 “빠진 runtime layer를 한 번 추가하자”입니다.
FAQ
이 구성에서 AnyCap은 또 다른 MCP 서버일 뿐인가요?
아니요. 더 정확한 표현은 AnyCap이 capability runtime이라는 것입니다. Claude Code는 스킬을 통해 사용법을 배울 수 있고, MCP도 주변 도구 아키텍처의 일부일 수 있지만, 제품 가치의 핵심은 흩어진 서버 설정 묶음이 아니라 통합된 실행 레이어에 있습니다.
왜 DeepSeek V4와 몇 개의 스크립트만 쓰면 안 되나요?
스크립트는 조정 문제를 해결하지 못하기 때문입니다. 에이전트가 검색하고, 미디어를 생성하고, 결과를 저장하고, 게시하는 일관된 방법이 여전히 필요합니다. runtime은 그 표면을 하나의 일관된 인터페이스로 에이전트에 제공합니다.
그래도 MCP가 필요한가요?
경우에 따라서는 그렇습니다. MCP는 내부 데이터베이스, 독점 API, 팀별 도구에 여전히 유용합니다. 하지만 MCP는 프로토콜 레이어입니다. 에이전트가 일상적인 프로덕션 작업에서 쓰는 더 넓은 capability runtime과 같은 것은 아닙니다.
이 스택에서 팀이 가장 많이 하는 실수는 무엇인가요?
Claude Code에 이미 완전한 capability layer가 포함되어 있다고 여기는 것입니다. 그렇지 않습니다. Claude Code는 셸이고 DeepSeek V4는 모델입니다. 실제 환경에서 작동하는 에이전트를 원한다면 여전히 runtime이 필요합니다.
관련 글
빠른 시작:
# Route Claude Code through DeepSeek V4
export OPENROUTER_API_KEY=sk-or-your-key
claude --model openrouter/deepseek/deepseek-v4-pro
# Install the capability runtime
curl -fsSL https://anycap.ai/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
anycap login
# Teach Claude Code how to use it
npx -y skills add anycap-ai/anycap -a claude-code