Originally published at claudeguide.io/claude-api-error-400

Claude API 400 invalid_request_error: 원인과 해결법 (2026)

Claude API 400 invalid_request_error는 JSON이 malformed이거나 required field가 누락된 경우에 발생합니다. 잘못된 요청 형식이며, 재시도하지 말고 요청 자체를 수정해야 합니다. 이 글은 5가지 흔한 원인과 Python/TypeScript 코드 예시를 다룹니다.

전반적인 Claude API 에러 처리 패턴은 Claude API Error Handling 가이드를 참고하세요.

---

무엇을 의미하는가?

400 HTTP 상태 코드는 JSON이 malformed이거나 required field가 누락된 경우을 의미합니다. Anthropic API의 에러 응답 본문에는 error.type이 "invalid_request_error"로 명시되며, error.message에 구체적 사유가 옵니다.

응답 예시:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "..."
  }
}

---

흔한 원인 5가지

1. messages 배열 형식 오류 (role/content 필수)
2. max_tokens가 모델 한도 초과 (예: Sonnet 4.5는 8192)
3. temperature가 0~1 범위 밖
4. tool_choice 형식 오류
5. model 이름 오타 (예: claude-sonnet-4 → claude-sonnet-4-5)

---

해결 코드 (Python)

python
# Validate before sending
def safe_request(client, model, messages, max_tokens=1024):
    # Sonnet 4.5 max_tokens cap
    if model.startswith("claude-sonnet") and max_tokens