전체 가이드 / 코딩 어시스턴트

Claude Code에서 XHuoAPI 사용하기

Claude Code는 Anthropic Messages 형식으로 요청을 보내고 XHuoAPI가 이 형식을 지원하므로, 변환 도구 없이 환경 변수 두 개만 설정하면 됩니다. Claude Code 2.1.284로 실제 파일 작성 작업을 실행했고, 아래 단계와 주의 사항은 그 테스트에서 나온 것입니다.

시작하기 전에

콘솔에서 가입하고 API 토큰을 만듭니다. 가입에는 이메일만 필요하고 전화번호는 필요하지 않습니다.
토큰을 만들 때 티어를 선택합니다. 신규 계정의 기본값은 Standard입니다. 티어는 가격과 안정성, 사용 가능한 모델을 결정합니다. 자세한 내용은 가격 페이지를 참조하세요.

먼저 확인

도구를 설정하기 전에 curl로 키와 모델이 작동하는지 확인하세요. '설정했는데 반응이 없다'는 경우의 절반은 여기서 걸러집니다.

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'

설정 단계

Claude Code를 설치합니다(Node.js 18 이상 필요).

npm install -g @anthropic-ai/claude-code

환경 변수를 설정합니다. Base URL에 /v1을 붙이지 마세요. Claude Code가 /v1/messages를 직접 붙입니다. ~/.zshrc나 ~/.bashrc에 추가하면 계속 적용됩니다.

export ANTHROPIC_BASE_URL=https://api.xhuoapi.ai
export ANTHROPIC_AUTH_TOKEN=YOUR_XHUOAPI_KEY
export ANTHROPIC_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-4-6

셸 설정을 바꾸지 않으려면 ~/.claude/settings.json의 env 블록에 같은 값을 넣어도 됩니다.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xhuoapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_XHUOAPI_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6"
  }
}

프로젝트 디렉터리에서 claude를 실행하면 대화형 모드가 됩니다. 먼저 -p로 일회성 작업을 실행해 연결을 확인해도 됩니다.

claude -p "Reply with the single word: ok"

Claude가 아닌 모델을 쓰려면 ANTHROPIC_MODEL과 ANTHROPIC_DEFAULT_HAIKU_MODEL을 해당 모델 ID(예: deepseek-v3.2)로 바꾸면 됩니다.

export ANTHROPIC_MODEL=deepseek-v3.2
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v3.2

주의 사항

테스트 결과(2026-10-06, Claude Code에 파일을 만들고 쓰게 하는 작업): claude-sonnet-4-6, deepseek-v3.2, glm-5.3, qwen3.8-max는 모두 첫 시도에 성공했고, kimi-k3는 처음에 실패한 뒤 재시도에서 성공했습니다. 모델마다 속도 차이가 커서 같은 작업이 DeepSeek은 약 9초, GLM은 약 45초 걸렸습니다.

Claude Code는 일부 백그라운드 작업을 기본적으로 Haiku급 모델에 맡깁니다. ANTHROPIC_DEFAULT_HAIKU_MODEL을 지금 쓰고 있고 동작을 확인한 모델로 설정해 두면, 백그라운드 요청이 테스트하지 않은 모델로 가는 일을 막을 수 있습니다.

Claude Code는 매 요청마다 긴 시스템 프롬프트를 보냅니다. 테스트에서 첫 요청은 약 3.6만 토큰을 캐시에 기록했고, 이후 요청은 약 6.4만 토큰을 캐시에서 읽었습니다. 캐시 읽기는 일반 입력보다 저렴한 캐시 가격으로 과금되며, 모델별 가격은 가격 페이지에서 볼 수 있습니다.

ANTHROPIC_AUTH_TOKEN은 Authorization: Bearer 헤더로, ANTHROPIC_API_KEY는 x-api-key 헤더로 전송되며 XHuoAPI는 둘 다 받습니다. ANTHROPIC_API_KEY를 쓰면 대화형 Claude Code가 처음 실행될 때 이 키를 사용할지 묻습니다.

Qwen 계열과 이미지/비디오 모델은 Standard와 Official 티어에서만 사용할 수 있습니다. Saver 또는 Spot 티어의 토큰으로는 '모델 사용 불가' 오류가 발생합니다.

모델 ID는 가격 페이지의 표기와 정확히 일치해야 합니다(DeepSeek V4 Pro가 아니라 deepseek-v4-pro). 대소문자와 하이픈도 구분됩니다.

자주 사용하는 모델

이런 도구에서 자주 선택되는 모델입니다. 모델 이름을 클릭하면 티어별 가격을 볼 수 있습니다. 전체 목록은 가격 페이지에 있습니다.

claude-sonnet-4-6 claude-sonnet-5 deepseek-v3.2 glm-5.3 qwen3.8-max

단계는 해당 도구의 현재 공식 문서를 기준으로 정리했습니다. 업데이트 후 UI가 바뀔 수 있습니다. 다른 점이 있으면 알려 주세요.