도움말
FAQ
증상별로 원인을 찾아보세요. 각 오류 메시지는 오류에서 설명합니다. 여기에 답이 없으면 먼저 서비스 상태를 확인한 뒤, 피드백 및 문의에 따라 사용 로그에서 실패한 요청의 시각을 보내 주세요.
연결과 설정
처음 실행하면 Unable to connect to Anthropic services가 나옵니다
첫 실행 온보딩은 Anthropic 서비스에 접속하는데, 중국 본토에서는 접속이 안 되는 경우가 많습니다. 편집기로 ~/.claude.json(Windows는 %USERPROFILE%\.claude.json)을 열어 최상위에 "hasCompletedOnboarding": true를 추가하고 저장한 뒤 claude를 다시 실행하세요.
여전히 공식 계정을 사용하고 있습니다
/status를 실행해 Base URL을 확인하세요. 틀렸다면 설정 파일 경로를 확인하고, 새 터미널을 열거나 /logout으로 claude.ai 로그인에서 나가세요.
VS Code 확장이 CoreCode를 사용하지 않습니다
~/.claude/settings.json에 env가 있는지 확인한 뒤 VS Code를 완전히 종료하고 다시 여세요. 확장에 claude.ai 계정으로 로그인했다면 먼저 로그아웃하세요.
모델이 존재하지 않는다고 나옵니다
요금 페이지에 나열된 모델 이름을 공급사 접두사 없이 사용하세요.
오랫동안 출력이 없습니다
확장 사고 중에는 몇 분 동안 텍스트가 없을 수 있으며 정상입니다. 게이트웨이의 읽기 타임아웃은 10분입니다.
오류
401 잘못된 키
키가 불완전하게 복사되었거나 삭제되었습니다. API 키 페이지에서 다시 복사하고, ANTHROPIC_API_KEY가 함께 설정되어 있지 않은지 확인하세요.
403 할당량 부족
잔액이 모두 소진되었습니다. 지갑 페이지에서 충전하세요.
403 Claude Code의 요청만 허용됩니다
Claude 满血（仅限CC）그룹의 키는 Claude Code CLI의 요청만 받습니다. Anthropic SDK, curl, 그 밖의 클라이언트에서 직접 호출하면 거부됩니다. 이런 곳에서 호출하려면 Claude 满血（可外接）그룹에서 다른 키를 만드세요.
429
키의 요청 속도 또는 동시 실행 한도를 초과했습니다. 잠시 기다렸다가 다시 시도하세요. 동시 실행이 더 필요하면 문의해 주세요.
과금과 캐시
캐시 적중률이 낮고 예상보다 지출이 많습니다
가장 흔한 원인은 auto 모드이고, 그다음은 세션 도중 모델 전환이나 5분 넘게 멈춘 경우입니다. 확인 방법은 캐싱과 과금을 참고하세요.
사용 로그에 Non-stream 요청이 많습니다
Claude Code의 메인 대화는 항상 스트리밍하므로 non-stream 요청은 보통 도구 호출 전에 auto 모드가 하는 검사입니다. auto 모드의 비용을 참고하세요.
Opus만 쓰는데 청구서에 Haiku나 Sonnet이 보입니다
백그라운드 요약, 서브에이전트, auto 모드의 분류기는 다른 모델을 사용합니다. 청구서에 나타나는 다른 모델을 참고하세요.