deepclaude – Claude Code 하네스를 DeepSeek·OpenRouter 백엔드로 쓰는 프록시

어떻게 작동하나
지원 백엔드와 전환
되는 것과 안 되는 것
사용상 주의
관련 문서
참고 자료

deepclaude는 Claude Code의 도구 루프와 터미널 UX는 그대로 두고, 모델 호출 백엔드만 DeepSeek V4 Pro, OpenRouter, Fireworks AI, Anthropic으로 전환하는 오픈소스 래퍼다. 핵심 아이디어는 “몸은 Claude Code, 두뇌는 다른 Anthropic 호환 모델”로 바꾸는 것이다.

어떻게 작동하나

Claude Code는 모델 API 호출에 ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, 기본 모델명 환경 변수를 사용한다. deepclaude는 세션 시작 시 이 변수들을 설정해 Anthropic 대신 다른 호환 엔드포인트로 보내고, 종료 시 원래 설정을 복구한다.

터미널
  -> Claude Code CLI
      -> 파일 읽기/쓰기, bash, git, subagent 루프
      -> 모델 API 호출은 DeepSeek/OpenRouter/Fireworks로 전달

지원 백엔드와 전환

기본 백엔드는 DeepSeek이며, OpenRouter와 Fireworks AI도 지원한다. deepclaude --backend ds, --backend or, --backend fw, --backend anthropic처럼 실행 시 고를 수 있다. 로컬 프록시 모드에서는 Claude Code 세션 안에서 slash command로 백엔드를 바꾸는 구조도 제공한다.

되는 것과 안 되는 것

파일 읽기·편집, bash 실행, grep/glob, git 작업, 다단계 자율 루프, subagent spawning 같은 Claude Code의 핵심 도구 사용은 유지된다. 반면 DeepSeek의 Anthropic 호환 계층 한계 때문에 이미지 입력, 일부 MCP 도구, Anthropic식 prompt caching은 그대로 기대하기 어렵다.

따라서 routine coding에는 비용 절감 효과가 크지만, 고난도 추론이나 Claude 고유 기능이 중요한 작업에서는 원래 Anthropic 백엔드로 전환하는 전략이 현실적이다.

사용상 주의

이런 래퍼는 공식 Claude Code 사용 방식과 다를 수 있고, 모델 호환성·약관·보안 경계가 백엔드별로 달라진다. 특히 회사 코드나 고객 데이터를 다른 모델 제공자에게 보낼 때는 데이터 처리 정책과 지역, 로깅 여부를 확인해야 한다.

참고 자료

aattaran/deepclaude — GitHub 공식 저장소

Like?

AI Sparkup