Claude Code에서 DeepSeek-V4.1-Flash 사용하는 방법

Claude Code에 I Code Easy API Key, 루트 URL https://api.icodeeasy.cc, 모델 deepseek-flash을 설정하면 이 서비스를 통해 DeepSeek-V4.1-Flash을 사용할 수 있습니다. macOS, Linux, Windows 설정과 확인 방법, 자주 발생하는 오류를 안내합니다.

모델 이름과 클라이언트의 차이

DeepSeek-V4.1-Flash는 모델이고 Claude Code는 Anthropic의 코딩 클라이언트입니다. 이 안내에서는 이 사이트의 API Key와 URL을 사용하며 DeepSeek 공식 Key나 구독을 사용하지 않습니다. 클라이언트 이름이 Claude Code여도 아래 설정은 DeepSeek를 선택합니다.

화면 표시 이름은 DeepSeek-V4.1-Flash이고 권장하는 정식 모델 ID는 deepseek-flash입니다. 이 서비스는 deepseek-v4.1-flash도 별칭으로 허용하지만 예제에서는 정식 ID로 통일합니다. 표시 이름을 모델 변수에 붙여 넣거나 다른 DeepSeek 안내의 일반 모델 이름을 가져오지 마세요.

시작하기 전에

1. 클라이언트를 아직 설치하지 않았다면 Claude Code 설치 안내를 먼저 따르세요. Windows 터미널과 Git Bash 요구 사항은 Anthropic의 최신 설치 설명을 기준으로 합니다.
2. 회원 가입 후 API Keys에서 이 서비스의 Key를 복사하세요. 빠른 시작에 따라 사용할 접속점을 선택하세요.
3. 현재 요금은 가격 페이지, 지원 기능은 모델 기능 목록에서 확인하세요. DeepSeek 공식 가격, 할당량, 구독은 이 서비스에 적용되지 않습니다.
4. Key는 본인의 로컬 설정에만 저장하세요. 저장소, 스크린샷, 채팅, 지원 문의에 포함하지 마세요.

설정 요약

기본 변수 세 개는 Haiku, Sonnet, Opus 별칭도 deepseek-flash를 선택하도록 합니다. DeepSeek를 Claude 모델로 바꾸지는 않습니다. 이 환경 변수는 Claude Code CLI용입니다. Desktop은 기본 안내를 참고하세요.

DeepSeek 공식 Anthropic 호환 주소에는 /anthropic이 포함되며 공식 Key를 사용합니다. 이 사이트를 통한 설정에서는 위 루트 URL만 입력하고 /anthropic, /v1, /v1/messages를 붙이지 마세요. ANTHROPIC_AUTH_TOKEN에는 사이트 Key만 입력하고 Bearer 접두사를 넣지 마세요.

CLAUDE_CODE_ATTRIBUTION_HEADER=0으로 설정하지 말고 클라이언트의 기본 귀속 정보를 유지하세요. 서비스 제한은 Claude Code 기본 안내를 참고하세요.

Linux / MacOS

Claude Code를 실행할 터미널에 아래 설정을 붙여 넣고 자리표시자를 이 서비스의 Key로 바꾸세요. 먼저 현재 터미널 세션에 적용됩니다.

export ANTHROPIC_AUTH_TOKEN="본인의 I Code Easy API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="deepseek-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

계속 사용하려면 같은 export 줄을 셸 시작 파일에 추가하세요. zsh는 ~/.zshrc, bash는 ~/.bashrc입니다. 저장 후 터미널을 다시 여세요. 자세한 저장 방법과 Windows 설정은 Claude Code 설정을 참고하세요.

터미널을 새로 열어도 됩니다. 이미 실행 중인 Claude Code는 변경된 환경 변수를 읽지 않으므로 종료한 뒤 설정한 터미널에서 다시 실행하세요.

Windows

현재 PowerShell 세션에만 적용하려면 다음을 실행하세요.

$env:ANTHROPIC_AUTH_TOKEN = "본인의 I Code Easy API Key"
$env:ANTHROPIC_BASE_URL = "https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL = "deepseek-flash"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-flash"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-flash"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "deepseek-flash"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

사용자 수준으로 저장하려면 위 변수를 설정한 같은 창에서 아래 코드를 실행하세요. 이 일곱 값을 사용자 환경에 저장합니다.

$names = @(
  "ANTHROPIC_AUTH_TOKEN",
  "ANTHROPIC_BASE_URL",
  "ANTHROPIC_MODEL",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL",
  "ANTHROPIC_DEFAULT_SONNET_MODEL",
  "ANTHROPIC_DEFAULT_OPUS_MODEL",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC"
)
foreach ($name in $names) {
  $value = [Environment]::GetEnvironmentVariable($name, "Process")
  [Environment]::SetEnvironmentVariable($name, $value, "User")
}

사용자 환경 변수는 이후 실행되는 프로세스에 적용됩니다. 저장 후 PowerShell을 새로 여세요. VS Code 등 통합 터미널을 사용한다면 호스트 앱도 재시작한 뒤 Claude Code를 실행하세요.

로컬 확인 후 실제 요청 보내기

먼저 클라이언트 설치를 확인하세요. 다음 명령은 버전만 출력하며 모델 요청을 보내지 않습니다.

claude --version

Key 자체를 출력하지 말고 불리언 값으로 존재 여부만 확인하세요.

macOS / Linux:

test -n "$ANTHROPIC_AUTH_TOKEN" && echo true || echo false

PowerShell:

[bool]$env:ANTHROPIC_AUTH_TOKEN

설정한 터미널에서 claude를 실행한 뒤 클라이언트에 /status를 입력해 모델과 연결 설정을 확인하세요. 상태 화면은 설정을 살펴보는 단서입니다. 화면에 Claude Code, Haiku, Sonnet, Opus가 표시된다는 사실만으로 Claude 모델이 요청을 처리했다고 판단할 수는 없습니다.

그다음 Claude Code에서 “OK만 답해 줘”와 같은 짧은 프롬프트를 직접 보내세요. 실제 요청이 발생하며 현재 규칙에 따라 요금이 부과됩니다. 요청 로그에서 성공 여부, 기록된 모델, 요금을 확인하세요. 응답에서 모델이 자신을 소개한 이름만 믿고 판단하지 마세요.

자주 발생하는 문제 해결

기본 도메인 연결이 느리면 ANTHROPIC_BASE_URL만 변경하고 다른 변수는 유지하세요. 대체 주소에도 /v1을 붙이지 않습니다.

https://jp.icodeeasy.cc
https://sg.icodeeasy.cc

주소 변경 후 Claude Code를 재시작하고 위 확인 절차를 반복하세요. 문제 해결 시 오류 코드, 발생 시각, 민감 정보를 제거한 로그를 제공하고 Key 원문은 보내지 마세요.

관련 안내와 공식 참고 자료

• Claude Code 설치 및 기본 설정
• GLM 연결 안내
• Kimi 연결 안내: Kimi를 쓸 때는 전용 페이지의 설정을 따르고 모델 이름을 섞지 마세요.
• 가격, 잔액, 사용량
• Anthropic 환경 변수
• Anthropic 모델 설정
• DeepSeek Anthropic 호환 API
• DeepSeek 코딩 클라이언트 안내

공식 자료는 호환 인터페이스와 클라이언트 설정을 이해하기 위한 참고입니다. 공식 직접 연결의 Key, URL, 가격과 구독은 이 서비스와 별개입니다.