핵심 요약
- DeepSeek은 Anthropic 호환 엔드포인트를 제공해서 Claude Code가 프록시 도구 없이 바로 붙어요.
- 전환은 환경 변수 블록 하나면 끝나요: ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN, 그리고 모델별 매핑.
- 별칭 모델은 의도를 갖고 매핑하세요: Opus와 Sonnet 슬롯엔 deepseek-v4-pro, Haiku와 서브에이전트 슬롯엔 deepseek-v4-flash.
- 과금은 DeepSeek 종량제 API로 넘어가요 — 영상의 데모 세션은 완성된 앱을 만들고 테스트하는 데 몇 센트를 썼고, 사용량은 플랫폼 대시보드에서 그대로 확인됐어요.
DeepSeek v4 Pro on Claude Code - Full Setup Tutorial
채널: Prince does AI8:08
Use Claude Code with ANY AI Model GPT, Gemini, DeepSeek
채널: AyyazTech17:00
Anthropic-compatible API — official DeepSeek documentation
문서: api-docs.deepseek.com
스크린샷은 Prince does AI의 설정 워크스루 — 깔끔한 전체 화면 녹화 — 에서 가져왔어요. 라우터 비교는 AyyazTech의 만능 모델 투어를, 엔드포인트 사실은 DeepSeek 공식 API 문서를 따랐어요.
프레임 권리는 각 제작자에게 있으며, 해당 장면으로 바로 가는 딥 링크와 함께 출처를 표기했어요. 글은 저희가 썼어요.
npm 설치부터 DeepSeek 위에서 돌아가는 앱까지
파트 1 · 설치와 설정
- 1
Claude Code 설치하고 확인하기
npm으로 CLI를 설치하고 claude --version을 실행해요 — 영상에서는 2.1.89가 찍혀요. 유일한 선행 조건은 Node.js이고, 같은 설치가 macOS, Linux, Windows에서 다 동작해요.
버전 확인으로 Claude Code 2.1.89 설치를 확인.0:46에 시청 - 2
DeepSeek API 키 받기
platform.deepseek.com에 로그인하고 Billing 페이지에서 조금 충전한 뒤, 사이드바의 API keys에서 새 키를 만들어요. 바로 복사하세요 — 플랫폼은 딱 한 번만 보여줘요.
DeepSeek 플랫폼 콘솔, 사이드바에 API keys.0:49에 시청 - 3
환경 변수 블록 설정하기
PowerShell에서 ANTHROPIC_BASE_URL을 DeepSeek의 Anthropic 엔드포인트로, ANTHROPIC_AUTH_TOKEN을 내 키로 잡고, 모델 슬롯을 매핑해요: ANTHROPIC_MODEL과 OPUS·SONNET 기본값은 deepseek-v4-pro, HAIKU 기본값과 CLAUDE_CODE_SUBAGENT_MODEL은 deepseek-v4-flash로. 블록을 통째로 붙여 넣고 엔터.
환경 변수 블록: 엔드포인트, 토큰, 모델 매핑.1:35에 시청
파트 2 · DeepSeek에서 띄우기
- 4
Claude Code 띄우기
같은 PowerShell 창에서 claude를 입력하고 폴더 신뢰 프롬프트를 수락해요. env 접두사로 설정한 환경 변수는 그 창에서만 살아요 — 나중에 다시 띄우려면 프로필에 저장해 두지 않는 한 블록을 다시 붙여 넣어야 해요.
설정된 PowerShell 창에서 Claude Code 실행.2:05에 시청 - 5
API 과금 배지 확인하기
환영 화면에 플랜 이름 대신 API Usage Billing 배지가 보이면 DeepSeek 엔드포인트가 살아 있다는 신호예요. 모델 행에 Opus 1M 컨텍스트로 표시될 수 있어요: 그건 매핑된 이름일 뿐이고, 실제로 답하는 건 deepseek-v4-pro예요.
Opus 4.6과 API Usage Billing을 보여 주는 환영 화면.2:25에 시청 - 6
첫 프롬프트 돌리기
영상은 데모가 끊기지 않게 권한 확인을 건너뛰고 실행했어요. 그 플래그가 없으면 Claude Code는 여느 때처럼 편집마다 물어봐요. 먼저 추론 문제 하나로 배관부터 점검해요.
권한을 건너뛰고 데모 세션 실행.2:50에 시청 - 7
답부터 새니티 체크
데모는 작은 논리 퀴즈 — 세차장까지 걸어갈까 차로 갈까 — 를 던지고 근거가 붙은 정답을 받아요. 여기서 10초 투자하면 나중에 10분의 디버깅을 아껴요.
세차장 테스트를 DeepSeek 경유로 정답 처리.3:18에 시청
파트 3 · 실력 증명시키기
- 8
진짜 빌드 한 번 맡기기
그럴듯한 걸 시켜요 — 데모는 인상적인 Electron 앱을 요청하고 모델에게 먼저 계획하게 해요. 계획 먼저, 빌드는 다음인 흐름이 DeepSeek에서도 똑같이 돌아가요: 계획을 승인하고 단계가 하나씩 지워지는 걸 지켜보세요.
클립보드 관리 앱 ClipMaster를 계획 중인 모델.4:22에 시청 - 9
완주를 기다리고 앱 열기
Claude Code가 골격을 세우고, 코드를 쓰고, 결과물을 실행해요 — 데모의 ClipMaster는 클립보드를 감시하고, 히스토리를 쌓고, 전역 단축키를 등록해요. 계획-승인-빌드 사이클이 내놓는, 기대에 딱 맞는 결과예요.
기능 목록과 함께 완성된 ClipMaster 앱.5:25에 시청 - 10
사용자처럼 결과물 테스트하기
시스템 아무 데서나 뭔가를 몇 개 복사하고, 생성된 앱의 히스토리에 뜨는 걸 지켜보세요. 눈으로 확인이 맹신을 이겨요 — 데모는 두 번째 모니터에서 복사해서 캡처가 진짜임을 증명해요.
복사한 항목이 ClipMaster의 실시간 히스토리에 착지.5:55에 시청 - 11
얼마가 들었는지 확인하기
DeepSeek 플랫폼으로 돌아가면 Usage 페이지에 그 세션의 요청 수, 토큰, 지출이 보여요. 제작자의 헤드라인: 약 200만 토큰에 8센트. 내 숫자도 같은 대시보드에 거의 실시간으로 쌓여요.
빌드와 테스트 세션을 마친 뒤의 사용량 대시보드.7:00에 시청
직접 엔드포인트, 아니면 claude-code-router?
DeepSeek에서 Claude Code를 돌리는 방법은 둘이에요. 이 가이드는 Anthropic 호환 엔드포인트 직접 연결을 쓰고, 라우터 도구가 다른 길이에요.
- 1직접 엔드포인트(이 가이드): 추가 도구 제로 — 환경 변수만으로 Claude Code가 api.deepseek.com과 바로 대화해요.
- 2claude-code-router: 세션 도중 모델 전환과 멀티 프로바이더 라우팅을 얹어 주는 로컬 프록시. 대가는 서비스 하나를 더 깔고 설정하는 일이에요.
- 3DeepSeek이 메인이면 직접 연결을. 여러 프로바이더를 오가거나 작업별로 모델을 바꾼다면 라우터를.
- 4어느 쪽이든 Claude Code 경험은 같아요 — 계획, 도구, 권한이 똑같이 동작하고, 바뀌는 건 과금과 별칭 뒤의 모델뿐이에요.
저희 Claude Code 라우터 튜토리얼이 프록시 길을 전용 DeepSeek 설정까지 포함해 단계별로 다뤄요.
설정이 말을 안 들을 때
여기서 거의 모든 실패는 환경 변수나 낡은 창이 원인이에요. 다른 걸 건드리기 전에 이 목록부터 훑으세요.
- 1여전히 Claude 플랜으로 청구됨: 환영 화면에 플랜 이름이 뜨고 API Usage Billing이 없다면 — 환경 변수 블록을 다른 터미널 창에서 설정한 거예요. claude를 띄우는 그 창에서 다시 실행하세요.
- 2인증 에러: 토큰을 따옴표나 공백과 함께 붙여 넣었거나 키 잔액이 없어요. 새 키를 만들고 충전한 뒤 ANTHROPIC_AUTH_TOKEN을 다시 설정하세요.
- 3도구 사용을 언급하는 모델 에러: 예전 DeepSeek 스냅샷은 일부 도구 호출을 잘 못 다뤘어요 — 3단계처럼 메인 슬롯은 deepseek-v4-pro, 서브에이전트는 flash로 유지하세요.
- 4답하는 모델이 다른 느낌: 별칭을 기억하세요. UI는 Opus나 Sonnet이라 표시하지만 진짜 모델은 내 매핑이 정해요 — 라벨 말고 ANTHROPIC_MODEL부터 확인하세요.
- 5설정이 세션마다 증발: PowerShell 환경 변수는 창과 운명을 같이해요. 블록을 셸 프로필에 저장해 두거나, 코딩 전에 실행하는 작은 스크립트로 감싸세요.
Anthropic 과금으로 돌아가려면: 변수를 지우세요 — 같은 창에서 remove-env ANTHROPIC_BASE_URL과 그 친구들 — 그리고 Claude Code를 재시작하세요.