Claude Code에서 Doubao Seed 2.1 Turbo 사용하는 방법

Claude Code에 I Code Easy API Key, 루트 URL https://api.icodeeasy.cc, 모델 doubao-seed-2.1-turbo를 설정하면 Doubao Seed 2.1 Turbo를 사용할 수 있습니다. macOS, Linux, Windows 설정과 확인 및 문제 해결을 안내합니다.

모델, 클라이언트, 계정 구분

Doubao Seed 2.1 Turbo는 텍스트 모델이고 Claude Code는 Anthropic의 코딩 클라이언트입니다. 이 설정은 Doubao를 선택하며 Claude 모델이 요청을 처리한다는 뜻이 아닙니다. Seed 텍스트 모델은 Seedream 이미지 생성 및 Seedance 영상 생성과 별개 서비스입니다.

여기서는 I Code Easy API Key를 사용합니다. Volcengine / Ark 공식 키, 공식 요금제 또는 Doubao 소비자 앱 로그인을 사용하지 않습니다. 서로 다른 서비스의 키와 URL을 섞지 마세요.

시작하기 전에

1. Claude Code 안내로 클라이언트를 설치하세요. 시스템과 터미널 준비는 환경 준비를 확인하세요.
2. 회원가입 후 API Keys에서 서비스 키를 복사하고 로컬 설정에만 저장하세요.
3. 현재 가격과 사용량 및 모델 기능 목록에서 공개 지원 범위를 확인하세요.

새 설정에는 doubao-seed-2.1-turbo를 직접 사용하세요. 이전 이름 doubao-seed-2.0-pro는 Seed 2.1 Turbo로 자동 업그레이드되며 별도의 이전 모델을 선택하지 않습니다. 세 ANTHROPIC_DEFAULT_*_MODEL 변수는 Haiku, Sonnet, Opus 별칭도 같은 모델에 연결합니다.

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="doubao-seed-2.1-turbo"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="doubao-seed-2.1-turbo"
export ANTHROPIC_DEFAULT_SONNET_MODEL="doubao-seed-2.1-turbo"
export ANTHROPIC_DEFAULT_OPUS_MODEL="doubao-seed-2.1-turbo"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

지속적으로 적용하려면 같은 export 줄을 셸 시작 파일에 추가하세요. zsh는 ~/.zshrc, bash는 ~/.bashrc입니다. 사용하는 셸에 맞는 줄만 실행하세요.

source ~/.zshrc

source ~/.bashrc

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

Windows

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

$env:ANTHROPIC_AUTH_TOKEN = "본인의 I Code Easy API Key"
$env:ANTHROPIC_BASE_URL = "https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL = "doubao-seed-2.1-turbo"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "doubao-seed-2.1-turbo"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "doubao-seed-2.1-turbo"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "doubao-seed-2.1-turbo"
$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 설치 및 기본 설정
• 환경 준비
• 가격, 잔액, 사용량
• 모델 기능 목록
• Anthropic 환경 변수
• Anthropic 모델 설정