DeepClaude, Claude Code 백엔드를 DeepSeek V4 Pro로 교체

Claude Code의 자율 에이전트 루프(파일 편집, bash, git, 하위 에이전트 생성)는 최고 수준입니다. 문제는 한도가 있는 $200/월의 비용입니다. DeepClaude는 전체 도구 루프를 변경하지 않고 백엔드 모델만 교체하는 경량 셸 스크립트입니다. 기본 백엔드는 DeepSeek V4 Pro(입력 $0.44/M, 출력 $0.87/M)이며, Anthropic의 $3/$15(100만 토큰당) 대비 17배 가격 차이입니다.

작동 방식

Claude Code는 API 엔드포인트와 인증을 위해 환경 변수를 읽습니다. DeepClaude는 세션별로 이를 설정합니다:

ANTHROPIC_BASE_URL — API 엔드포인트
ANTHROPIC_AUTH_TOKEN — 백엔드용 API 키
ANTHROPIC_DEFAULT_OPUS_MODEL — Opus 등급 작업용 모델 이름
ANTHROPIC_DEFAULT_SONNET_MODEL — Sonnet 등급 작업용 모델 이름
ANTHROPIC_DEFAULT_HAIKU_MODEL — Haiku 등급(하위 에이전트)용 모델 이름
CLAUDE_CODE_SUBAGENT_MODEL — 생성된 하위 에이전트용 모델

실행 후 종료 시 원래 설정이 복원됩니다.

빠른 시작 (2분)

1. DeepSeek API 키 받기 — platform.deepseek.com에 가입하고 $5 크레딧을 추가하세요.

2. 환경 변수 설정:

# Windows (PowerShell)
setx DEEPSEEK_API_KEY "sk-your-key-here"

macOS/Linux
echo 'export DEEPSEEK_API_KEY="sk-your-key-here"' >> ~/.bashrc
source ~/.bashrc

3. 스크립트 설치:

# Windows — PATH에 있는 디렉토리로 복사 Copy-Item deepclaude.ps1 "$env:USERPROFILE\.local\bin\deepclaude.ps1" macOS/Linux

chmod +x deepclaude.sh sudo ln -s "$(pwd)/deepclaude.sh" /usr/local/bin/deepclaude

4. 사용:

deepclaude                              # DeepSeek V4 Pro로 실행 (기본값)
deepclaude --status                     # 사용 가능한 백엔드와 키 표시
deepclaude --backend or                 # OpenRouter 사용 (입력 $0.44/M)
deepclaude --backend fw                 # Fireworks AI 사용 (가장 빠름, 미국 서버)
deepclaude --backend anthropic          # 일반 Claude Code (Opus용)
deepclaude --cost                       # 가격 비교 표시
deepclaude --benchmark                  # 모든 제공업체 지연 시간 테스트

지원되는 백엔드

백엔드	플래그	입력/M	출력/M	서버	비고
DeepSeek (기본)	`--backend ds`	$0.44	$0.87	중국	자동 컨텍스트 캐싱 (반복 작업 시 120배 저렴)
OpenRouter	`--backend or`	$0.44	$0.87	미국	미국/유럽에서 가장 저렴한 지연 시간
Fireworks AI	`--backend fw`	$1.74	$3.48	미국	가장 빠른 추론
Anthropic	`--backend anthropic`	$3.00	$15.00	미국	원본 Claude Opus

비용 비교

가벼운 사용 (월 10일): Anthropic Max $200/월 → DeepSeek 약 $20/월 → 90% 절감
많은 사용 (월 25일): $200/월 → 약 $50/월 → 75% 절감
자동 루프 포함: $200/월 → 약 $80/월 → 60% 절감

DeepSeek의 자동 컨텍스트 캐싱은 에이전트 루프를 매우 저렴하게 만듭니다. 첫 요청 이후 시스템 프롬프트와 파일 컨텍스트가 $0.004/M에 캐시되는 반면, 캐시되지 않으면 $0.44/M입니다.

작동하는 것과 작동하지 않는 것

작동: 파일 읽기/쓰기/편집, bash/PowerShell 실행, glob/grep 검색, 다단계 자율 도구 루프, 하위 에이전트 생성, git 작업, 프로젝트 초기화 (/init), 사고 모드 (기본 활성화).

작동하지 않거나 성능 저하: 이미지/비전 입력 (DeepSeek의 Anthropic 엔드포인트는 이미지를 지원하지 않음), 병렬 도구 사용 (비활성화 — 도구가 하나씩 실행됨), MCP 서버 도구 (호환성 계층을 통해 지원되지 않음). 프롬프트 캐싱 절감은 DeepSeek 자체 시스템에서 처리됩니다.