Claude Code에서 DeepSeek API 사용법: 실제 옵션
Claude Code에서 DeepSeek API를 사용하는 방법을 알아보고 있다면, 먼저 Claude Code가 Anthropic 스타일 엔드포인트와 통신하며 이 서비스는 OpenAI 형식을 사용한다는 점을 알아야 합니다. 작은 변환 프록시가 간극을 메우며, 이 페이지는 설정 방법을 보여줍니다.
업데이트
주요 포인트
- Claude Code는 Anthropic Messages API를 요구합니다. 이 서비스는 OpenAI 호환 /v1/chat/completions을 제공합니다.
- LiteLLM과 같은 로컬 프록시는 두 형식 간에 변환할 수 있습니다.
- Aider, Continue, Cline는 프록시 없이 OpenAI 호환 Base URL을 직접 지원합니다.
- DeepSeek 공식 API가 아닙니다. ID가
uncensored인 독립 오픈 웨이트 모델입니다.

작동할 것과 작동하지 않을 것부터 시작하세요
혼란을 피하기 위해 두 가지 명확화가 필요합니다. 첫째, 이 서비스는 공식 DeepSeek API가 아니며 DeepSeek나 기타 벤더의 라우터도 아닙니다. 독립적인 제공자가 운영하는 하나의 오픈 웨이트 모델을 모델 ID uncensored로 실행 중입니다. DeepSeek 자체 모델이 필요하면 DeepSeek로 직접 이동하세요. 둘째, Claude Code는 Anthropic의 Messages API를 기반으로 합니다. 요청을 보내는 위치를 변경할 수 있지만, 보내는 내용은 여전히 Anthropic 스타일 JSON입니다.
이 서비스는 OpenAI 형식으로 POST /v1/chat/completions 및 GET /v1/models을 제공합니다. Claude Code를 직접 연결해도 작동하지 않습니다. 해결책은 번역 계층입니다. 내 머신에서 작은 프록시를 실행하여 Claude Code의 Anthropic 호출을 받아 OpenAI 형식으로 https://api.getdeepseekapi.com/v1로 전달합니다. 이 용도의 도구가 있으며 다음 섹션에서 설정 방법을 설명합니다.
시작하기 전, 한 가지 기대치 확인이 필요합니다. Claude Code는 파일 읽기, 편집, 명령 실행을 위해 함수 호출에 크게 의존합니다. 이 API는 스트리밍 tool_calls을 포함한 함수 호출을 지원합니다. 하지만 특정 모델이 긴 에이전트 루프를 얼마나 잘 주도하는지는 단정하지 말고 자체 저장소에서 테스트해야 합니다.
키를 얻고 엔드포인트를 확인하세요
Google 또는 이메일/비밀번호로 계정을 생성한 후 API 키 페이지를 엽니다. 신규 사용자는 클릭 한 번으로 $0.50 무료 체험 크레딧을 받을 수 있습니다. 7일 동안 유효하며 결제 정보가 필요 없고 아래 모든 내용을 테스트하기에 충분합니다. 체험 키는 동시 요청 2개, 분당 60개의 제한이 있으므로 여러 호출을 동시에 보내는 에이전트 도구에는 주의하세요.
export UNCENSORED_API_KEY="paste-your-key-here"
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
완료 응답이 반환되면 업스트림 측 작업이 완료된 것입니다. 남은 작업은 프록시를 연결하는 것입니다.
옵션 1: Claude Code 앞의 LiteLLM 프록시
LiteLLM은 Anthropic 호환 엔드포인트를 제공하고 OpenAI 호환 백엔드로 라우팅할 수 있는 프록시 서버를 갖춘 오픈소스 프로젝트입니다. 이 생태계의 이 부분은 빠르게 변화하므로 현재 기능 목록을 확인하려면 문서를 참조하세요.
설치 및 구성
pip install 'litellm[proxy]'
cat > litellm-config.yaml <<'EOF'
model_list:
- model_name: uncensored
litellm_params:
model: openai/uncensored
api_base: https://api.getdeepseekapi.com/v1
api_key: os.environ/UNCENSORED_API_KEY
EOF
litellm --config litellm-config.yaml --port 4000
openai/ 접두사는 LiteLLM이 OpenAI 호환 어댑터를 사용하도록 지시합니다. 그 뒤의 이름이 모델로 전송됩니다. 터미널을 실행 상태로 유지하세요.
Claude Code를 프록시에 연결하세요
Claude Code는 환경 변수에서 엔드포인트와 자격 증명을 읽습니다. 두 번째 터미널에서 다음을 실행하세요:
export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="any-local-string"
export ANTHROPIC_MODEL="uncensored"
export ANTHROPIC_SMALL_FAST_MODEL="uncensored"
claude
여기의 인증 토큰은 로컬 프록시가 기대하는 값일 뿐입니다. 실제 키는 프록시의 환경에 유지됩니다. 작고 빠른 모델 설정도 중요합니다. Claude Code는 경량 백그라운드 작업에 두 번째 모델을 사용하기 때문입니다. 이를 설정하지 않으면 프록시가 알지 못하는 Anthropic 모델 이름을 호출하려고 할 수 있습니다. 새 버전에서는 이 설정의 이름이 다를 수 있으므로 변수가 무시되는 경우 claude --help를 실행하거나 현재 Claude Code 설정 문서를 읽어보세요.
옵션 2: OpenAI base URL을 직접 받는 도구
목적이 Claude Code 자체가 아닌 AI 코딩 어시스턴트라면, 이미 OpenAI 형식을 지원하므로 프록시를 건너뛸 수 있는 여러 도구가 있습니다. 각 도구는 사용자 정의 base URL과 모델 이름을 설정할 수 있습니다.
- Aider은 터미널 기반 페어 프로그래밍 도구입니다.
OPENAI_API_BASE및OPENAI_API_KEY를 읽으며 모델 앞에openai/접두사를 붙입니다. - Continue는 모델 항목에
apiBase및 OpenAI 스타일 제공자를 포함할 수 있는 편집기 확장 프로그램입니다. - Cline은 설정에서 Base URL, 키, 모델 ID 필드가 있는 OpenAI 호환 제공자를 제공합니다.
Aider의 전체 설정은 세 줄로 끝납니다:
export OPENAI_API_BASE="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="$UNCENSORED_API_KEY"
aider --model openai/uncensored
이 도구들은 메뉴를 자주 변경하므로 위의 필드명은 참고용이며 각 프로젝트의 현재 문서를 따르세요. 필요한 값은 변하지 않습니다: Base URL https://api.getdeepseekapi.com/v1, 키, 모델 ID uncensored.
간단한 에이전트 루프 직접 작성
전체 코딩 어시스턴트가 과하다면 함수 호출이 포함된 짧은 스크립트로 많은 작업을 처리할 수 있습니다. 이 스크립트는 모델이 파일 읽기를 요청한 후 파일을 role: "tool" 메시지로 다시 전달합니다.
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key=os.environ["UNCENSORED_API_KEY"],
)
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Read a text file from the project",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "What does main.py do? Read it first."}]
for _ in range(5):
r = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = r.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"]) as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
5회 루프 제한은 오작동하는 모델이 무한히 실행되는 것을 방지합니다. 실제 도구에서는 경로도 검증하여 모델이 프로젝트 외부 파일을 읽지 못하게 해야 합니다.
속도 제한, 비용 및 429 오류 해결
에이전트 도구는 요청이 많습니다. 단일 작업으로 수십 개의 요청이 트리거될 수 있으며, 각 요청은 증가하는 컨텍스트를 다시 전송합니다. 전체 키의 경우 동시 요청 8개와 분당 300개의 요청이 가능합니다. concurrency가 있는 429 오류는 호출이 너무 많이 겹친다는 것을 의미하며, rate_limited가 있는 429 오류는 분당 요청이 너무 많다는 것을 의미합니다. 짧은 과부하 동안 Retry-After: 5가 있는 429 오류를 볼 수 있습니다. LiteLLM에 재시도 설정을 추가하면 자동으로 재시도할 수 있습니다. 문서를 확인하세요.
가격은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50으로 저렴합니다. 에이전트 세션에서 40회의 호출을 수행하고 각 호출이 30,000개의 컨텍스트 토큰을 보내고 600개의 토큰을 받으면 입력은 1,200,000 토큰으로 비용은 1.2 x $0.15 = $0.18입니다. 출력은 24,000 토큰으로 비용은 0.024 x $0.50 = $0.012입니다. 전체 세션 비용은 $0.192입니다. 컨텍스트 창은 100,000 토큰이므로 로드하는 파일을 집중적으로 관리하세요.
체험 기간이 끝나면 암호화폐(TRC20의 USDT, Base의 USDC)로 $20부터 $500까지 원하는 정수 금액을 충전할 수 있습니다. 보너스는 $50부터 +5%, $100부터 +10%, $200부터 +15%입니다. 자세한 내용은 가격 책정 페이지 및 문서를 참조하세요.
프록시 설정 문제 해결
| 증상 | 원인 | 시도할 사항 |
|---|---|---|
| Claude Code가 알 수 없는 모델을 보고합니다 | 백그라운드 모델 이름이 매핑되지 않음 | 작은 빠른 모델 변수도 uncensored로 설정합니다. |
| 연결 거부됨 | 프록시가 실행 중이지 않거나 포트가 일치하지 않음 | LiteLLM을 시작하고 ANTHROPIC_BASE_URL의 포트를 일치시킵니다. |
| 상위 서버에서 401 오류 | 프록시 환경의 잘못된 키 | UNCENSORED_API_KEY를 다시 내보내고 프록시를 재시작합니다. |
| 함수 호출 실패 또는 루프 발생 | 모델이 에이전트 형식에 어려움을 겪음 | 온도 값을 낮추거나 프롬프트를 짧게 하거나 Aider를 사용하세요 |
| 자주 발생하는 429 오류 | 체험 키의 동시 요청 수는 2개입니다 | 8개의 동시 요청 슬롯을 갖춘 전체 키로 크레딧을 충전하세요 |
두 가지 습관으로 설정을 안전하게 유지할 수 있습니다. 프록시를 로컬호스트에서만 실행하여 네트워크의 다른 사용자가 크레딧을 사용하지 못하게 하세요. 또한 실제 키를 버전 관리 시스템에 포함될 수 있는 프로젝트 파일이 아닌 프록시의 환경 변수에 보관하세요. 첫 긴 세션 중 X-Balance-USD 응답 헤더를 모니터링하세요. 에이전트 루프는 예상보다 많은 토큰을 사용할 수 있기 때문입니다. 잔액이 위의 추정치보다 빠르게 감소하면 제공된 파일의 길이를 줄이거나 단계 수를 제한하세요.
실패한 요청에는 요금이 부과되지 않으므로 실험 비용이 저렴합니다. 프롬프트는 학습에 사용되지 않습니다. 다른 게이트웨이와 비교하려면 API 키 개요를 읽어보세요.
더 많은 가이드
질문과 답변
Claude Code에서 이 API에 직접 연결할 수 있나요?
아니요. Claude Code는 Anthropic의 Messages 형식을 사용하고 이 API는 OpenAI의 chat completions 형식을 사용합니다. LiteLLM과 같은 번역용 프록시를 사이에 두세요.
이것이 공식 DeepSeek API인가요?
아니요. 이 API는 ID uncensored로 하나의 독립적인 오픈 웨이트 모델을 호스팅하며 DeepSeek나 기타 벤더와 제휴 관계가 아닙니다.
프록시 없이 작동하는 도구는 무엇인가요?
Aider, Continue, Cline과 같은 OpenAI 호환 제공자 설정이 있는 도구입니다. Base URL, 키 및 모델 ID uncensored를 설정하세요.
함수 호출이 작동하나요?
네. 스트리밍되는 tool_calls와 role tool 메시지로 반환되는 결과를 포함합니다. 모델이 이를 어떻게 처리하는지 확인하려면 자체 에이전트 워크플로우를 테스트하세요.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 Base URL을 변경하세요. 설정은 이것으로 끝입니다.