Muapi에서 Claude Code 사용하기

환경 변수

변수값
ANTHROPIC_BASE_URLhttps://api.muapi.ai/anthropic
ANTHROPIC_AUTH_TOKENMuapi API 키 (Claude Code가 Bearer 토큰으로 전송합니다)
ANTHROPIC_MODEL선택 사항. 모델 엔드포인트에서 확인한 id (예: claude-sonnet-5-5)

기본 URL에 /v1/messages를 포함하지 마세요. Claude Code가 알아서 붙입니다.

빠른 시작 (셸)

export ANTHROPIC_BASE_URL=https://api.muapi.ai/anthropic
export ANTHROPIC_AUTH_TOKEN="$MUAPI_API_KEY"
claude

설정 파일

~/.claude/settings.json (또는 .claude/settings.local.json)입니다. 여기에 적은 값은 그대로 사용되므로, 키를 파일에 남기고 싶지 않다면 셸에서 export 하는 방식을 권장합니다. 인증 정보를 프로젝트 수준의 .claude/settings.json에 커밋하지 마세요.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.muapi.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<your Muapi API key>"
  }
}

모델

curl -s -H "Authorization: Bearer $MUAPI_API_KEY" https://api.muapi.ai/anthropic/v1/models

무검열(abliterated) 모델

모델 엔드포인트에는 도구 호출을 지원하는 Muapi의 무검열 모델(예: qwen-3-8-27b-obliterated, mimo-v2-6-flash-abliterated, glm-5-3-abliterated, abliterated-model-large-v2)도 함께 나열됩니다. Claude Code를 이 모델들로 실행할 수 있으며, Claude Code의 프로토콜과 모델의 채팅 API 사이의 변환은 Muapi가 대신 처리합니다.

export ANTHROPIC_BASE_URL=https://api.muapi.ai/anthropic
export ANTHROPIC_AUTH_TOKEN="$MUAPI_API_KEY"
export ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen-3-8-27b-obliterated
export ANTHROPIC_SMALL_FAST_MODEL=qwen-3-8-27b-obliterated
claude --model qwen-3-8-27b-obliterated

HAIKU/SMALL_FAST 두 변수는 같은 모델 id로 설정하세요. Claude Code는 백그라운드 요청(제목, 요약 등)을 "Haiku"라는 이름의 소형 모델로 보내는데, 이 변수를 설정하지 않으면 해당 요청이 404 오류로 실패합니다.

알아두어야 할 점:

  • 모델마다 품질이 다릅니다. 비교적 작은 오픈 모델이라 여러 단계로 이루어진 코딩 작업에서 한 단계를 건너뛸 수 있습니다(예: 여러 파일 중 하나를 만들지 않는 경우). 결과를 확인하고, 더 어려운 작업에는 더 큰 모델을 사용해 보세요.
  • 비용은 턴마다 늘어납니다. 프롬프트 캐싱이 없어서 매 턴마다 지금까지의 전체 대화에 대해 요금이 청구됩니다. 작은 모델에서는 한 턴에 대략 1센트에서 몇 센트, 큰 모델에서는 그보다 더 듭니다. 정확한 사용량은 모델 엔드포인트와 대시보드에서 확인할 수 있습니다.
  • 응답 한 번당 출력은 16,384 토큰으로 제한됩니다(일부 모델은 더 낮음). 또한 모델의 컨텍스트 윈도우가 Claude보다 작으므로, 매우 긴 세션에서는 /compact를 더 일찍 사용해야 합니다.
  • 여기에서는 도구 호출을 지원하는 모델만 제공합니다. Claude Code는 도구 없이는 실행되지 않기 때문입니다.
  • 이미지 입력은 비전을 지원하는 모델에서만 작동합니다.

확인

Claude Code에서 /status를 실행해 기본 URL을 확인하세요. 요청을 살펴보려면 claude --debug를 사용합니다.

참고 사항

  • Claude Code가 Anthropic 로그인을 요구하면 터미널을 완전히 종료한 뒤, 변수를 export한 셸에서 다시 여세요.
  • 401은 키나 헤더가 잘못되었다는 뜻이고, 402는 잔액이 해당 요청의 최악의 경우 비용을 감당하지 못한다는 뜻입니다(전체 프롬프트와 최대 출력 분량이 먼저 보류되고 사용하지 않은 부분은 반환됩니다). 따라서 한 턴의 비용보다 넉넉한 잔액을 유지하세요.