deepclaude: Claude Code의 에이전트 루프를 DeepSeek 등 더 저렴한 백엔드로 돌리는 도구

9bow · 6월 23, 2026, 12:30오후

deepclaude 소개

deepclaude는 Claude Code의 자율 에이전트 루프를 그대로 쓰면서, 그 뒤에서 실제로 추론하는 모델만 DeepSeek V4 Pro, OpenRouter, 또는 Anthropic 호환 백엔드로 바꿔 주는 도구입니다. 파일 읽기·편집, bash 실행, 서브에이전트 생성, 여러 단계에 걸친 자율 코딩 루프 같은 Claude Code의 동작은 그대로 두고, "어떤 모델이 생각하는가"만 교체한다는 발상입니다.

저자는 이 구조를 "몸은 유지하고 두뇌를 바꾼다" 로 설명합니다. Claude Code는 강력한 자율 코딩 에이전트지만 사용량 상한이 있는 구독형이고, deepclaude는 같은 사용 경험(UX)을 유지하면서 더 저렴한 백엔드로 비용을 낮추는 것을 목표로 합니다. README는 DeepSeek V4 Pro가 LiveCodeBench에서 96.4%를 기록하며 출력 토큰 100만 개당 0.87달러 수준이라고 소개합니다.

이런 종류의 수치와 절감 효과는 저자가 제시한 것이므로 실제 작업 부하에서는 달라질 수 있습니다. 본 게시물에서는 deepclaude가 어떤 방식으로 백엔드를 교체하는지, 어떤 백엔드를 지원하는지, 그리고 무엇이 되고 무엇이 안 되는지를 정리합니다.

deepclaude의 동작 방식

Claude Code는 API 호출을 어디로 보낼지 환경 변수로 결정합니다. deepclaude는 ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, 그리고 Opus·Sonnet·Haiku 등급별 모델 이름을 세션 단위로만 바꿔 Claude Code를 실행하고, 종료 시 원래 설정을 복원합니다. 영구 설정을 건드리지 않으므로 평소 환경은 그대로 남습니다.

세션 도중에 백엔드를 바꾸는 라이브 스위칭에는 로컬 프록시가 쓰입니다. 아래 그림은 그 흐름을 정리한 것입니다.

프록시는 localhost:3200에서 모든 API 호출을 가로채고, /_proxy/mode 엔드포인트로 활성 백엔드를 즉시 바꿉니다. 모델 호출(/v1/messages)만 DeepSeek 같은 대체 백엔드로 보내고, 그 외 호출은 Anthropic으로 그대로 통과시킵니다. /_proxy/status로 현재 백엔드와 가동 시간을, /_proxy/cost로 토큰 사용량과 절감액을 조회할 수 있습니다.

deepclaude가 지원하는 백엔드

deepclaude는 네 가지 백엔드를 지원하며, 각각 --backend 플래그로 선택합니다. 아래 가격은 README가 제시한 값입니다.

백엔드	플래그	입력/100만	출력/100만	서버	비고
DeepSeek (기본)	`--backend ds`	$0.44	$0.87	중국	자동 컨텍스트 캐싱
OpenRouter	`--backend or`	$0.44	$0.87	미국	미국·유럽에서 낮은 지연
Fireworks AI	`--backend fw`	$1.74	$3.48	미국	가장 빠른 추론
Anthropic	`--backend anthropic`	$3.00	$15.00	미국	원래의 Claude Opus

기본 백엔드인 DeepSeek은 자동 컨텍스트 캐싱을 제공해, 저자에 따르면 첫 요청 이후 시스템 프롬프트와 파일 컨텍스트가 캐시되어 반복 턴에서 비용이 크게 낮아집니다. 어려운 문제에는 --backend anthropic으로 원래의 Claude Opus를 그대로 쓸 수 있습니다.

deepclaude로 세션 중 모델 전환하기

deepclaude는 세션을 재시작하지 않고 Claude Code 안에서 바로 백엔드를 전환하도록 슬래시 명령을 제공합니다. ~/.claude/commands/에 deepseek.md, anthropic.md, openrouter.md 같은 파일을 두면, 세션에서 /deepseek나 /anthropic를 입력해 즉시 전환할 수 있습니다.

VS Code·Cursor 확장에서는 키보드 단축키로, 명령줄에서는 deepclaude --switch ds 플래그로도 같은 전환을 할 수 있습니다.

deepclaude에서 되는 것과 안 되는 것

대부분의 Claude Code 기능이 그대로 동작합니다. 파일 읽기·쓰기·편집(Read/Write/Edit), bash·PowerShell 실행, Glob·Grep 검색, 여러 단계의 자율 도구 루프, 서브에이전트 생성, git 작업, /init 프로젝트 초기화, 기본 활성화된 사고 모드(thinking mode)가 포함됩니다.

반면 호환 계층의 한계로 동작하지 않거나 제한되는 기능도 있습니다.

이미지·비전 입력: DeepSeek의 Anthropic 호환 엔드포인트가 이미지를 지원하지 않습니다.
MCP 서버 도구: 호환 계층을 통해서는 지원되지 않습니다.
병렬 도구 호출: DeepSeek 자체는 지원하지만, Claude Code가 기본적으로 도구를 순차 전송합니다.
Anthropic 프롬프트 캐싱: DeepSeek은 자체 캐싱을 쓰며 Anthropic의 cache_control은 무시됩니다.

저자는 일상적인 작업의 약 80%에서는 DeepSeek V4 Pro가 Claude Opus에 견줄 만하고, 복잡한 추론이 필요한 나머지 약 20%에서는 Opus가 더 강하다고 정리합니다.

deepclaude 설치와 사용법

먼저 platform.deepseek.com에서 API 키를 발급받아 환경 변수로 설정합니다.

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

# 스크립트를 PATH에 연결
chmod +x deepclaude.sh
sudo ln -s "$(pwd)/deepclaude.sh" /usr/local/bin/deepclaude

설치 후에는 다음과 같이 실행합니다.

deepclaude                      # DeepSeek V4 Pro로 Claude Code 실행
deepclaude --backend or         # OpenRouter 사용
deepclaude --backend anthropic  # 일반 Claude Code (Opus가 필요할 때)
deepclaude --cost               # 가격 비교 보기
deepclaude --remote             # 브라우저에서 원격 제어

deepclaude의 라이선스

deepclaude는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

deepclaude 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~