deepclaude

Claude Code 의 자율 에이전트 루프를 DeepSeek V4 Pro, OpenRouter 또는 Anthropic 호환 백엔드로 사용하세요. 동일한 UX, 17 배 저렴.

이 것이 하는 일

Claude Code 는 가장 좋은 자율 코딩 에이전트이지만, 사용량 제한이 있고 월 $200 을 비용합니다. DeepSeek V4 Pro 는 LiveCodeBench 에서 96.4% 점수를 얻고 출력 토큰당 $0.87 입니다.

deepclaude 는 머리를 바꾼 채 몸을 유지합니다:

Your terminal
  +-- Claude Code CLI (도구 루프, 파일 편집, bash, git - 변경 없음)
        +-- API 호출 -> DeepSeek V4 Pro ($0.87/M) 대신 Anthropic ($15/M)

모든 것이 작동합니다: 파일 읽기, 편집, bash 실행, 서브 에이전트 생성, 자율 다단계 코딩 루프. 유일한 차이는 생각하는 모델이 다릅니다.

빠른 시작 (2 분)

1. DeepSeek API 키 받기

platform.deepseek.com 에서 가입하고 $5 크레딧 추가, API 키 복사.

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 로 Claude Code 시작
deepclaude --status         # 사용 가능한 백엔드와 키 표시
deepclaude --backend or     # OpenRouter 사용 (가장 저렴, $0.44/M 입력)
...

작동 방식

Claude Code 는 API 호출을 어디로 보낼지 결정하기 위해 이 환경 변수를 읽습니다:

Variable	What it does
ANTHROPIC_BASE_URL	API 엔드포인트 (기본값: api.anthropic.com)
...
deepclaude 는 세션별로 이들을 설정합니다 (영구적 아님), Claude Code 를 시작하고 종료 시 원래 설정을 복원합니다.

지원되는 백엔드

Backend	Flag	Input/M	Output/M	Servers	Notes
DeepSeek (기본값)	--backend ds	$0.44	$0.87	China	자동 컨텍스트 캐싱 (반복 턴에서 120 배 저렴)
...

백엔드별 설정

DeepSeek (기본값 - DEEPSEEK_API_KEY 만 필요):

setx DEEPSEEK_API_KEY "sk-..."           # Windows
export DEEPSEEK_API_KEY="sk-..."         # macOS/Linux

OpenRouter (선택적):

setx OPENROUTER_API_KEY "sk-or-..."      # Windows
export OPENROUTER_API_KEY="sk-or-..."    # macOS/Linux

Fireworks AI (선택적):

setx FIREWORKS_API_KEY "fw_..."          # Windows
export FIREWORKS_API_KEY="fw_..."        # macOS/Linux

비용 비교

Usage level	Anthropic Max	deepclaude (DeepSeek)	Savings
Light (10 days/mo)	$200/mo (capped)	~$20/mo	90%
...

DeepSeek 의 자동 컨텍스트 캐싱은 에이전트 루프를 매우 저렴하게 만듭니다 - 첫 요청 후 시스템 프롬프트와 파일 컨텍스트는 $0.004/M (캐시되지 않은 경우 $0.44/M) 로 캐시됩니다.

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

Works

• 파일 읽기, 작성, 편집 (Read/Write/Edit 도구)
• Bash/PowerShell 실행
• Glob 및 Grep 검색
• 다단계 자율 도구 루프
• 서브 에이전트 생성
• Git 작업
• 프로젝트 초기화 (/init)
• Thinking 모드 (기본값으로 활성화됨)

작동하지 않거나 성능 저하

기능	원인
이미지/시각 입력	DeepSeek 의 Anthropic 엔드포인트는 이미지를 지원하지 않습니다
...

지능 차이

• 루틴 작업 (작업의 80%): DeepSeek V4 Pro 는 Claude Opus 와 유사한 성능을 보입니다.
• 복잡한 추론 (20%): Claude Opus 가 더 강함 - --backend anthropic 로 전환하세요.

실시간 전환 (재시작 없음)

Anthropic 과 DeepSeek 사이를 세션 중 (mid-session) 에서 전환합니다. Claude Code 내부에서 수행됩니다. 재시작, 터미널 명령어 불필요. 단순히 슬래시 명령어를 입력하면 됩니다.

Claude Code 터미널에서:

Claude Code VS Code 확장 프로그램에서:

작동 원리

프록시는 localhost:3200 에서 실행되며 모든 API 호출을 인터셉트합니다. 제어 엔드포인트 (/_proxy/mode) 를 통해 활성 백엔드를 즉시 전환할 수 있습니다:

Claude Code -> localhost:3200 (프록시)
                 |
                 +-- /_proxy/mode POST -> 백엔드 전환
...

옵션 1: 슬래시 명령어 (권장)

~/.claude/commands/ 에 다음 파일을 추가하세요:

deepseek.md:

모델 프록시를 DeepSeek 으로 전환합니다. 이 명령어를 조용히 실행하고 결과를 보고하세요:
curl -sX POST http://127.0.0.1:3200/_proxy/mode -d "backend=deepseek"
성공 시 다음을 말하세요: "DeepSeek 으로 전환했습니다."

anthropic.md:

모델 프록시를 Anthropic 으로 되돌립니다. 이 명령어를 조용히 실행하고 결과를 보고하세요:
curl -sX POST http://127.0.0.1:3200/_proxy/mode -d "backend=anthropic"
성공 시 다음을 말하세요: "Anthropic 으로 전환했습니다."

openrouter.md:

모델 프록시를 OpenRouter 로 전환합니다. 이 명령어를 조용히 실행하고 결과를 보고하세요:
curl -sX POST http://127.0.0.1:3200/_proxy/mode -d "backend=openrouter"
성공 시 다음을 말하세요: "OpenRouter 로 전환했습니다."

그런 후 Claude Code 세션에서 /deepseek, /anthropic, 또는 /openrouter 를 입력하여 즉시 전환할 수 있습니다.

옵션 2: CLI 플래그

deepclaude --switch deepseek    # 또는: ds, or, fw, anthropic
deepclaude -s anthropic

옵션 3: VS Code 키보드 단축키

.vscode/tasks.json 에 추가하세요:

{
  "version": "2.0.0",
  "tasks": [
...

그런 후 keybindings.json 에서 결합하세요:

{ "key": "ctrl+alt+d", "command": "workbench.action.tasks.runTask", "args": "프록시: DeepSeek 으로 전환" },
{ "key": "ctrl+alt+a", "command": "workbench.action.tasks.runTask", "args": "프록시: Anthropic 으로 전환" }

비용 추적

프록시는 토큰 사용량을 추적하고 Anthropic 가격 대비 절감액을 계산합니다:

curl -s http://127.0.0.1:3200/_proxy/cost

반환값:

{
  "backends": {
    "deepseek": {
...

VS Code / Cursor 통합

IDE 에서 deepclaude 를 실행할 수 있도록 터미널 프로필을 추가하세요:

설정 > JSON:

{
  "terminal.integrated.profiles.windows": {
    "DeepSeek Agent": {
...

또는 macOS/Linux 에서:

{
  "terminal.integrated.profiles.linux": {
    "DeepSeek Agent": {
...

원격 제어 (--remote)

어떤 브라우저에서 Claude Code 세션을 열어 DeepSeek 을 뇌로 사용하세요:

deepclaude --remote                # 원격 제어 + DeepSeek
deepclaude --remote -b or          # 원격 제어 + OpenRouter
deepclaude --remote -b anthropic   # 원격 제어 + Anthropic (일반)

이는 휴대폰, 태블릿 또는 브라우저에서 열 수 있는 https://claude.ai/code/session_... URL 을 출력합니다.

작동 원리

원격 제어를 위해 WebSocket 연결을 위한 Anthropic 의 브릿지가 필요하지만, 모델 호출은 다른 곳으로 갈 수 있습니다. deepclaude 는 로컬 프록시를 시작하여 트래픽을 분할합니다:

claude remote-control
+-- Bridge WebSocket -> wss://bridge.claudeusercontent.com (Anthropic, hardcoded)
+-- Model API calls -> http://localhost:3200 (proxy)
...

Prerequisites

• Must be logged into Claude Code: claude auth login
• Must have a claude.ai subscription (the bridge is Anthropic infrastructure)
• Node.js 18+ (for the proxy)

The proxy starts automatically and stops when the session ends. See proxy/README.md for technical details.

License

MIT