Claude Code에서 Qwen 사용하는 방법

Claude Code에 I Code Easy API Key, 루트 URL https://api.icodeeasy.cc, 모델 qwen3.8-max를 설정하면 이 서비스를 통해 Qwen을 사용할 수 있습니다. qwen3.8-flash도 선택할 수 있습니다. 설정과 확인 절차, 자주 발생하는 오류를 안내합니다.

시작하기 전에

1. Claude Code 안내에 따라 클라이언트를 설치하세요. 이 페이지는 Claude Code용이며 Qwen Code의 설치나 로그인 절차가 아닙니다.
2. 회원 가입 후 API Keys에서 이 서비스의 Key를 복사하세요. Alibaba Cloud 공식 Key나 공식 Coding Plan 구독과는 별개입니다.
3. 접속점 선택에서 Qwen3.8-Max / Flash를 확인하고 선택하세요. 현재 요금은 가격 페이지에서 확인하며, 이용 범위는 계정에 현재 표시되는 내용을 기준으로 합니다.
4. Key는 본인의 로컬 설정에만 보관하세요. 저장소, 스크린샷, 채팅, 지원 문의에 포함하지 마세요.

모델 이름과 별칭 설정

Qwen은 모델이고 Claude Code는 클라이언트입니다. 이전 Claude나 Kimi 설정이 적용되지 않도록 Haiku, Sonnet, Opus 별칭도 같은 Qwen 모델에 연결하세요.

Flash로 바꾸려면 ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL 네 값을 모두 qwen3.8-flash로 변경한 뒤 Claude Code를 재시작하세요. 모델 이름을 정확히 입력하고 임의의 버전이나 접미사를 추가하지 마세요.

macOS / Linux 설정

Claude Code를 실행할 터미널에서 아래 명령을 실행하고 자리표시자를 이 서비스의 Key로 바꾸세요. 현재 터미널 세션에 적용됩니다.

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

설정을 유지하려면 같은 export 줄을 셸 시작 파일에 추가하세요. zsh는 ~/.zshrc, bash는 ~/.bashrc입니다. 저장 후 새 터미널을 열거나 사용하는 셸에 맞는 줄만 실행하세요.

source ~/.zshrc

source ~/.bashrc

Windows PowerShell 설정

현재 PowerShell 세션에는 다음을 설정하세요.

$env:ANTHROPIC_AUTH_TOKEN = "본인의 I Code Easy API Key"
$env:ANTHROPIC_BASE_URL = "https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL = "qwen3.8-max"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "qwen3.8-max"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "qwen3.8-max"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "qwen3.8-max"
$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 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 Code에서 “OK만 답해 줘”와 같은 짧은 프롬프트를 직접 보내세요. 실제 요청이 발생하며 현재 규칙에 따라 요금이 부과됩니다. 요청 로그에서 성공 여부, 기록된 모델, 요금을 확인하세요. 모델이 응답에서 소개하는 이름만으로 판단하지 마세요.

자주 발생하는 오류 해결

기본 도메인 연결이 느리면 ANTHROPIC_BASE_URL만 변경하고 다른 값은 유지하세요. 공식 대체 주소 두 개도 /v1 없는 루트 URL을 사용합니다.

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

변경 후 클라이언트를 재시작하고 다시 확인하세요. 문제 해결 시 오류 코드, 발생 시각, 민감 정보를 제거한 로그만 제공하고 Key 원문은 보내지 마세요.

관련 안내와 공식 참고 자료

• Claude Code 설치 및 기본 설정
• GLM 연결 안내
• Kimi 연결 안내
• 가격, 잔액, 사용량
• Anthropic 환경 변수
• Anthropic 모델 설정