Claude Code에서 DeepSeek-V3.1 사용법

Claude Code는 보통 Anthropic의 Claude 모델에 연결되는 경량 코딩 어시스턴트입니다. DeepSeek의 Anthropic 호환 API 덕분에 몇 가지 환경 변수만 설정하면 DeepSeek V3.1 위에서 Claude Code를 실행할 수 있습니다.

이 가이드에서는 설치, 구성 및 사용법을 안내합니다.

---

1. Claude Code 설치하기

Claude Code는 두 가지 방법으로 설치할 수 있습니다:

옵션 A (curl 설치 스크립트):

curl -fsSL https://claude.ai/install.sh | bash

옵션 B (npm):

npm install -g @anthropic-ai/claude-code

---

2. DeepSeek V3.1용 구성

Claude Code는 Anthropic API 변수를 사용합니다. 이를 DeepSeek의 Anthropic 호환 엔드포인트로 연결하려면 다음 환경 변수를 설정하세요:

# DeepSeek의 Anthropic 호환 엔드포인트 지정
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

# DeepSeek API 키
export ANTHROPIC_AUTH_TOKEN="YOUR_DEEPSEEK_API_KEY"

# DeepSeek V3.1을 메인 모델로 사용
export ANTHROPIC_MODEL="deepseek-chat"

# DeepSeek V3.1을 소형/빠른 모델로도 사용
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

참고:

• deepseek-chat = DeepSeek V3.1 (추론 모드 아님)
• deepseek-reasoner = DeepSeek V3.1 추론 모드 (상세한 “사고” 추적 지원, 도구 사용은 제한적)

추론 모델을 사용하려면 deepseek-chat 대신 deepseek-reasoner로 바꾸세요.

---

3. 원클릭 시작 스크립트

사용을 간편하게 하려면 start-claude-deepseek.sh라는 셸 스크립트를 만드세요:

#!/bin/bash
# Claude Code와 함께하는 DeepSeek V3.1

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_DEEPSEEK_API_KEY"
export ANTHROPIC_MODEL="deepseek-chat"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

# Claude Code 실행
claude "$@"

실행 권한을 부여하세요:

chmod +x start-claude-deepseek.sh

이제 다음 명령으로 Claude Code를 실행할 수 있습니다:

./start-claude-deepseek.sh

---

4. 사용법

프로젝트 폴더로 이동한 후 스크립트를 실행하세요:

cd your-project
../start-claude-deepseek.sh

이제 Claude Code는 이전과 동일하게 작동하지만, DeepSeek V3.1 기반으로 동작합니다.

---

5. 문제 해결

• 잘못된 토큰 오류 → ANTHROPIC_AUTH_TOKEN이 올바른 DeepSeek API 키로 설정되었는지 확인하세요.
• 응답 없음 → ANTHROPIC_BASE_URL이 정확한지 확인하세요 (https://api.deepseek.com/anthropic).
• 도구/함수 호출 문제 → deepseek-chat에서 지원되며, deepseek-reasoner는 deepseek-chat으로 대체될 수 있습니다.

---

✅ 이제 DeepSeek V3.1과 함께하는 Claude Code를 AI 코딩 어시스턴트로 사용할 준비가 되었습니다.