Claude Code에서 DeepSeek 사용: V4 Flash / Pro 설정 가이드
APIMaster를 통해 Claude Code에서 DeepSeek V4 Flash 및 Pro를 실행하세요. 게이트웨이와 API 키를 설정하고, 모델을 전환하고, 파일 읽기 도구를 확인하고, 구성 오류를 수정하세요.
Claude Code가 DeepSeek를 사용할 수 있나요? Claude Code 2.1.239를 사용한 테스트에서 APIMaster의 Messages 엔드포인트를 통해 deepseek-v4-flash 및 deepseek-v4-pro를 성공적으로 사용했습니다. ANTHROPIC_BASE_URL을 https://apimaster.ai로 설정하고, APIMaster 키를 제공하고, 모델을 명시적으로 선택하세요. 이 구성은 클라이언트 이름이 Claude Code이더라도 DeepSeek를 실행합니다.
마지막 테스트: 2026-09-07, Claude Code 2.1.239, Linux. 두 모델 모두 예상된 텍스트를 반환하고 파일 읽기 도구 왕복을 완료했습니다. 모든 실행이 코드 0으로 종료되었습니다. CLI는
unrecognized_model을 출력했지만 테스트된 요청은 성공했습니다. 이러한 검사는 모든 Claude Code 기능, 긴 세션 또는 향후 릴리스에 대한 지원을 보장하지 않습니다. Windows / macOS 설정 명령이 포함되어 있습니다. 기록된 테스트는 Linux에서 실행되었습니다.
1. CLI 및 API 키 준비
환경 가이드 및 Claude Code 설정 가이드를 따라 설치하세요. 버전을 확인하세요:
claude --version
선택한 DeepSeek 모델에 대한 액세스 권한과 충분한 할당량이 있는 APIMaster API 키를 받으세요. 이 튜토리얼에서는 아래 세션 설정을 사용하세요. 일반 settings.json을 덮어쓸 필요는 없습니다.
2. 게이트웨이 및 키 설정
이 설정을 일반 CLI 세션과 분리하려면 새 터미널을 여세요.
macOS / Linux:
export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN
Windows PowerShell:
$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
여기서 사이트 출처를 사용하세요. /v1 없이: Claude Code는 /v1/messages를 추가합니다. API 키는 APIMaster에서 가져와야 합니다. 이 명령은 이 터미널 및 해당 하위 프로세스에 영향을 미치며 저장된 로그인 파일에는 영향을 미치지 않습니다. 공유 설정 파일이나 저장소에 실제 키를 넣지 마세요.
3. 최소 테스트 요청 보내기
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"
예상 결과: is_error는 false이고, result는 DEEPSEEK_TEST_OK이며, 프로세스는 코드 0으로 종료됩니다. --model을 deepseek-v4-pro로 변경하고 다시 실행하세요.
테스트된 버전의 --bare 모드는 명시적 API 키 인증을 사용하고 일반적인 백그라운드 통합을 건너뜁니다. --setting-sources ""는 저장된 설정 소스를 제외하고, --tools ""는 이 단일 텍스트 테스트에 대해 도구를 비활성화합니다. 이는 의도적인 진단 설정이며, 일반 사용 중에 도구를 비활성화하라는 요구 사항이 아닙니다. 이전 CLI 버전은 이러한 플래그를 모두 허용하지 않을 수 있습니다.
4. 파일 읽기 도구 확인
현재 디렉토리에 probe.txt를 만들고 다음 내용을 넣으세요:
TOOL_PROBE_739182
실행:
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."
예상 결과: CLI가 파일을 읽고 TOOL_PROBE_739182를 반환합니다. deepseek-v4-pro로 반복하세요. 이는 모델이 도구를 요청하고, 결과를 받고, 응답할 수 있는지 확인합니다. 이 테스트에서는 Read 도구만 활성화됩니다.
동일한 터미널 설정으로 일반 대화형 작업의 경우:
claude --bare --setting-sources "" --model deepseek-v4-flash
Pro로 시작하려면:
claude --bare --setting-sources "" --model deepseek-v4-pro
대화형 명령은 --tools ""를 생략하므로 기본 도구를 사용할 수 있습니다. 평소와 같이 권한 프롬프트를 검토하세요. --bare는 후크 및 자동 프로젝트 지침과 같은 편의 기능을 건너뜁니다. 최소 설정이 작동한 후 의도적으로 일반 설정을 활성화하고 게이트웨이 또는 모델을 재정의하지 않는지 확인하세요. 완료되면 이 터미널을 닫아 이 세션의 환경을 정리하세요.
문제 해결
| 증상 | 확인 사항 |
|---|---|
unrecognized_model |
2.1.239에서 두 DeepSeek ID 모두에서 관찰됨. 요청 완료를 방해하지 않았습니다. 경고만으로 실패로 간주하지 말고 최종 결과를 확인하세요. |
| 401 또는 예기치 않은 로그인 프롬프트 | ANTHROPIC_API_KEY가 설정되어 있는지 확인하고, 이 터미널에서 충돌하는 ANTHROPIC_AUTH_TOKEN을 제거하고 bare 모드를 다시 시도하세요. |
| 404 | ANTHROPIC_BASE_URL은 https://apimaster.ai여야 하며, 전체 /v1/messages 엔드포인트 또는 /v1로 끝나는 베이스가 아니어야 합니다. |
알 수 없는 --bare 옵션 |
테스트된 2.1.239와 버전을 비교하세요. 적절한 경우 일반 설치 가이드를 사용하여 업데이트하세요. |
probe.txt를 읽을 수 없음 |
파일이 있는 디렉토리에서 실행하세요. 도구 테스트의 경우 --tools ""를 사용하지 말고 Read를 활성화하세요. |
| 다른 모델이 선택됨 | --model로 전체 모델 ID를 전달하고, 저장된 설정 또는 모델 별칭 재정의를 활성화하기 전에 확인하세요. |
| 속도 제한, 할당량 부족 또는 업스트림 오류 | 오류 본문을 읽고, 할당량 및 모델 권한을 확인하고, 지원을 위해 타임스탬프를 기록하세요. |
자주 묻는 질문
Claude 모델을 사용하는 것과 동일합니까?
아니요. 여기서 Claude Code는 클라이언트이고 선택된 모델은 DeepSeek입니다. 특정 Claude 모델에 의존하는 기능은 이 설정으로 자동으로 지원되지 않습니다.
Python SDK 예제와 기본 URL이 다른 이유는 무엇입니까?
Python OpenAI SDK는 https://apimaster.ai/v1를 사용하고 /chat/completions를 추가합니다. Claude Code는 https://apimaster.ai를 사용하고 /v1/messages를 추가합니다. 각 클라이언트의 문서화된 기본 형식을 사용하세요.
이 게이트웨이에서 DeepSeek 공식 키를 사용할 수 있습니까?
이 튜토리얼은 APIMaster에서 발급한 키가 필요합니다. 키는 발급한 공급자에 따라 다릅니다. 엔드포인트만 변경해도 자격 증명이나 할당량이 이전되지 않습니다.
실제 도구 사용이 테스트되었습니까, 아니면 텍스트 응답만 테스트되었습니까?
두 모델 모두에 대해 둘 다 테스트되었습니다. 도구 테스트는 로컬 파일을 읽고 내용을 반환했습니다. 모든 도구, 백그라운드 에이전트 또는 긴 코딩 작업이 지원된다는 것을 보장하지는 않습니다.