NextHub 자주 묻는 질문(FAQ)

문제가 발생하면 먼저 여기를 확인하세요.

429 오류가 발생하면 어떻게 하나요?

429는 동시 요청 수 초과 또는 잔액 부족을 의미합니다. 계정의 한도와 잔액이 충분한지 확인하세요. 한도가 충분한데도 자주 발생한다면 ApiKey 또는 그룹의 속도 제한(5시간 / 일일 / 주간 주기)에 도달했을 수 있으므로, 잠시 후 재시도하거나 속도 제한 설정을 조정하세요.

'모델을 사용할 수 없음' 또는 '요청이 거부됨'이 표시되나요?

대부분 그룹 또는 모델 ID 문제입니다. ApiKey 생성 시 선택한 그룹이 호출 가능한 모델 범위를 결정하므로, 대상 모델이 선택한 그룹에 속하는지, 그리고 모델 ID가 모델 목록의 표기와 일치하는지 확인하세요.

settings.json 저장 후에도 claude 명령어가 연결되지 않나요?

파일 경로가 올바른지 확인하고(Windows: %USERPROFILE%\.claude\settings.json, macOS: ~/.claude/settings.json), JSON 형식이 유효한지 확인하며(마지막 줄 뒤에 쉼표가 없어야 함), ANTHROPIC_BASE_URL이 https://api.nexthub.cc로 설정되어 있는지 확인하세요(끝에 /v1을 붙이지 마세요).

선택 가능한 그룹은 무엇이고, 배율은 각각 얼마인가요?

현재 공개된 그룹은 9개입니다(스냅샷 날짜 2026-09-27): claude code(0.37x, 클라이언트 제한 없음), Claude Max(0.5x, 높은 안정성과 높은 캐시 적중률), Claude-AWSB(0.7x), GPT-Azure(0.47x), GPT-Pro(0.11x, 이미지 생성 불가), Gemini-aistudio(0.28x), Gemini-Vertex(0.49x), Grok(0.55x), 国产模型组(0.15x). 그 외에 이미지 생성 등의 전용 그룹이 있으며, 콘솔에 로그인하고 해당 권한을 개통한 후에 표시됩니다. 실제 차감액 = 공식 가격 × 그룹 배율이며, 자세한 내용은 그룹 배율 안내를 참고하세요.

Claude Desktop 설정 후 경고가 표시되고 '테스트 통과' 안내가 없나요?

정상적인 현상입니다. Claude Desktop의 서드파티 게이트웨이 모드는 공식 로그인 검증을 거치지 않으므로, 설정 페이지에 '연결 성공' 안내가 표시되지 않으며, 재시작 후 대화 페이지에 나타나는 '설정 미검증' · '네트워크 연결' 경고 배너도 일반적인 오탐입니다. 바로 메시지를 보내 정상적으로 응답이 오면 설정이 적용된 것입니다. 자세한 내용은 Claude Desktop 설정 튜토리얼을 참고하세요.

Zed 설정 후 요청 오류가 발생하면 어떻게 하나요?

먼저 Base URL이 https://api.nexthub.cc/v1(/v1 포함)로 입력되어 있는지 확인하세요. chat/completions와 Responses 두 가지 요청 방식을 모두 지원하므로 기본값을 유지하면 됩니다. 모델 ID는 모델 목록과 일치해야 합니다(예: claude-opus-5-5).

Kilocode 연결 후 응답이 없나요?

Base URL이 올바르게 입력되었는지(https://api.nexthub.cc/v1, /v1 포함) 확인하고, API Provider가 다른 유형이 아닌 **OpenAI Compatible (Responses)**로 선택되어 있는지 확인하세요.