Muapi에서 Claude Code 사용하기
환경 변수
| 변수 | 값 |
|---|---|
ANTHROPIC_BASE_URL | https://api.muapi.ai/anthropic |
ANTHROPIC_AUTH_TOKEN | Muapi 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는 잔액이 해당 요청의 최악의 경우 비용을 감당하지 못한다는 뜻입니다(전체 프롬프트와 최대 출력 분량이 먼저 보류되고 사용하지 않은 부분은 반환됩니다). 따라서 한 턴의 비용보다 넉넉한 잔액을 유지하세요.