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 자체 시스템에서 처리됩니다.

대상 사용자

에이전트 루프에서 Claude Code를 많이 사용하는 개발자로서, 비용의 일부로 거의 동일한 기능을 원하는 분 — 특히 DeepSeek V4 Pro의 96.4% LiveCodeBench 점수로 충분한 반복 코딩 작업에 적합합니다.