Claude Code를 무료 DeepSeek로 전환: 지금 설정해 두면 11월 24일에 바로 시작

HiAPI 2026 블랙 프라이데이는 베이징 시간 11월 24일 16:00에 시작하여 12월 1일 15:59에 종료되며, 충전 이력이 있는 계정은 매일 1000만 DeepSeek V4.1 Flash tokens를 무료로 사용할 수 있습니다. 환경 변수 5개를 설정하면 Claude Code가 이 무료 모델 위에서 실행됩니다. 지금 바로 설정하고 미리 검증해 둘 수 있으며, 24일 16:00이 되면 곧바로 시작할 수 있습니다. Python, curl 설정도 아래에 있습니다.

딱 한 가지만 제대로 하면 됩니다: 무료 요청에는 프로모션 요청 헤더를 포함해야 합니다. 헤더가 없으면 원가로 청구됩니다(백만 tokens당 입력 $0.44, 출력 $1.32).

준비물: Key 하나, 요청 헤더 하나

export HIAPI_API_KEY="sk-your-key"

Claude Code

Claude Code를 HiAPI로 향하게 하고, 주 모델과 백그라운드 소형 모델을 모두 DeepSeek로 설정한 뒤 요청 헤더를 추가하세요:

export ANTHROPIC_BASE_URL="https://api.hiapi.ai"
export ANTHROPIC_AUTH_TOKEN="$HIAPI_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_CUSTOM_HEADERS="X-HiAPI-Promotion: deepseek-v41-flash-bf2026"
claude

ANTHROPIC_DEFAULT_HAIKU_MODEL은 반드시 설정해야 합니다: Claude Code는 제목, 요약 같은 백그라운드 작업에 소형 모델을 사용하며, 이런 호출도 무료 모델로 가야 합니다. 이 변수들은 별도의 터미널 창(또는 스크립트)에서 설정하여 평소 사용하는 Claude Code 설정에 영향을 주지 않도록 권장합니다. HiAPI로 Claude Code를 연결하는 전체 설명은 Claude Code 가이드를 참고하세요.

Python(OpenAI SDK)

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["HIAPI_API_KEY"],
    base_url="https://api.hiapi.ai/v1",
    default_headers={"X-HiAPI-Promotion": "deepseek-v41-flash-bf2026"},
)

resp = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "순서를 유지하는 리스트 중복 제거 Python 함수를 작성해 줘"}],
)
print(resp.choices[0].message.content)

default_headers는 이 client가 보내는 모든 요청에 요청 헤더를 추가하며, 나머지 코드는 수정할 필요가 없습니다.

curl

curl https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-HiAPI-Promotion: deepseek-v41-flash-bf2026" \
  -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"이 정규식을 설명해 줘: ^(?=.*\\d).{8,}$"}]}'

지금 바로 검증 가능: 이벤트 전에는 403 반환, 요금 청구 없음

24일 16:00 이전에 위 요청을 보내면 403이 반환되고, 에러 코드는 promotion_not_active이며 이번 호출은 요금이 청구되지 않습니다. 이 응답이 보이면 요청 헤더가 HiAPI에 도달한 것이므로 설정이 올바르며, 이벤트 시작을 기다리기만 하면 됩니다. 만약 정상 응답이 바로 반환되었다면 요청 헤더가 누락되어 원가로 청구된 것이니, 철자를 확인하고 사용하는 도구가 실제로 사용자 정의 요청 헤더를 보내는지 점검하세요.

이벤트 시작 후 첫 요청을 보낸 뒤 HiAPI 콘솔에서 사용량 기록을 확인하면, 이 DeepSeek 요청은 $0으로 표시되어야 합니다.

다른 도구도 사용자 정의 OpenAI 호환 Base URL, 모델명, 사용자 정의 요청 헤더를 설정할 수 있다면 같은 방식으로 사용할 수 있습니다. 사용자 정의 요청 헤더를 보낼 수 없는 경우 요청은 원가로 청구됩니다.

제한 사항

• 계정에 성공한 충전 이력이 한 번 이상 있어야 합니다(금액 무관). 한 번도 충전한 적이 없다면 24일 전에 소액을 충전하면 됩니다.
• 계정당 매일 1000만 tokens, 태평양 시간 자정(베이징 시간 16:00)에 리셋됩니다. 베이징 시간 11월 24일 16:00부터 12월 1일 15:59까지입니다.
• deepseek-v4.1-flash만 무료이며, DeepSeek V4 Pro 등 다른 모델은 평소대로 청구됩니다.
• 무료 tokens는 비용이 들지 않으므로 소비 환급에 포함되지 않습니다.
• 기업 계정은 참여할 수 없습니다.

24일부터 무엇에 활용할까

• Agent로 밀린 작업 정리: 아무도 작성하지 않은 테스트, 계속 미뤄 온 리팩터링, 특정 모듈의 문서. 코딩 Agent가 중형 저장소에서 한 라운드를 실행하면 약 20만 tokens이며, 하루 1000만이면 수십 라운드를 실행할 수 있습니다.
• 실제 데이터로 평가: V4.1 Flash를 기존 파이프라인에 교체하고 수천 개의 실제 입력으로 출력을 비교해 보세요. 이벤트 주간에는 비용이 들지 않습니다.
• 긴 컨텍스트 읽기: 100만 tokens 컨텍스트라면 한 번에 전체 코드베이스나 계약서 더미를 넣을 수 있습니다.

같은 주에 이미지, 영상도 실행하시나요? 충전 시 최대 10% 추가 증정, 이미지/영상/오디오 소비 최대 20% 환급: 계산은 여기서.

블랙 프라이데이 이벤트 페이지로 돌아가기 →