Claude Code · 문제 해결

Claude Code API 오류 400 bad request: 흔한 원인

400은 API가 사용자가 누구인지는 이해했지만 요청 자체를 거부했다는 뜻입니다. invalid_request_error 뒤의 메시지가 보통 무엇이 잘못됐는지 정확히 알려줍니다. 아래 표와 대조해 보세요.

마지막 확인

오류 텍스트

Claude Code
API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"..."}}

메시지 대조

메시지에 포함된 내용원인해결
model / not found / invalid modelANTHROPIC_MODEL 또는 /model이 사용할 수 없는 모델 ID를 가리킴/model 또는 모델 페이지에서 모델 선택
prompt is too long / context대화가 모델의 컨텍스트 창을 초과함/compact 실행, 또는 /clear 후 새로 시작
max_tokens출력 토큰 재정의가 모델에 비해 너무 높음CLAUDE_CODE_MAX_OUTPUT_TOKENS 제거 또는 낮추기
Not found / 404 instead of 400Base URL이 /v1로 끝남https://api.aicodewith.ai를 정확히 사용
image / file모델이 받을 수 없는 첨부 파일첨부 파일 크기 조정 또는 제거

단계별 해결

  1. 1. 메시지 읽기

    invalid_request_error 뒤의 텍스트가 문제를 알려줍니다. 위 표에서 대조하세요.

  2. 2. 모델 재정의 초기화

    settings.json에서 ANTHROPIC_MODEL 및 기타 모델 재정의를 제거하고 재시작한 뒤 /model로 모델을 선택하세요.

    ~/.claude/settings.json
    {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_API_KEY": "",
        "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
      }
    }
  3. 3. 컨텍스트 줄이기

    /compact를 실행하세요. 세션이 매우 길면 /clear 후 새 세션에서 계속하세요.

실패한 요청에도 요금이 청구되나요?

실패한 요청(4xx/5xx, 타임아웃, 끊긴 연결)에는 요금이 청구되지 않습니다 — 성공적으로 완료된 요청에만 과금됩니다. 업스트림 실패가 자동으로 재시도되어 성공하면 한 번만 청구됩니다.

계속 실패하나요?

  • aicodewith의 모델 페이지에서 각 채널의 최근 상태를 확인하세요.
  • 대시보드 사용 기록에서 요청을 찾아 모델, 상태, 비용을 확인하세요.
  • 오류 발생 시각, 모델, 오류 텍스트를 support@aicodewith.com으로 이메일로 보내세요(전체 API 키는 절대 보내지 마세요).

모델 상태 및 가격지원팀 문의문서

FAQ

Claude Code 오류 400은 무엇을 의미하나요?

API가 요청 내용을 거부했다는 뜻입니다. invalid_request_error 뒤의 메시지가 이유를 알려줍니다: 흔히 잘못된 모델 ID 또는 너무 긴 대화입니다.

"prompt is too long"은 어떻게 고치나요?

/compact를 실행해 세션을 요약하거나, /clear 후 새로 시작하세요. CLAUDE.md와 붙여넣은 로그는 짧게 유지하세요.

Base URL에 /v1이 필요한가요?

아니요. https://api.aicodewith.ai를 사용하세요; /v1을 추가하면 요청 경로가 깨집니다.

settings.json을 편집한 뒤 왜 시작됐나요?

모델 또는 토큰 재정의가 흔한 원인입니다. 재정의를 제거하고 재시작한 뒤 /model로 모델을 선택하세요.

어떤 모델 ID를 사용할 수 있나요?

Claude Code에서 /model을 실행하거나, 모델 페이지에서 사용 가능한 모든 모델과 해당 ID를 확인하세요.

실패한 요청에도 요금이 청구되나요?

실패한 요청(4xx/5xx, 타임아웃, 끊긴 연결)에는 요금이 청구되지 않습니다 — 성공적으로 완료된 요청에만 과금됩니다. 업스트림 실패가 자동으로 재시도되어 성공하면 한 번만 청구됩니다.

지금 사용해 보세요

요금은 선불 잔액에서 토큰 단위로 청구됩니다. 속도 및 동시성 제한이 적용되며, 각 API 키에 일일, 월간 또는 총 지출 한도를 설정할 수 있습니다.

관련 항목

출처

Claude 및 Claude Code는 Anthropic PBC의 상표입니다. aicodewith는 독립 플랫폼이며 Anthropic과 제휴하거나 승인받지 않았습니다. 오류 형식은 Claude Code에서 인용했으며 변경될 수 있습니다. 확인일 2026-10-10.