Claude Code · 문제 해결
Claude Code API 오류 400 bad request: 흔한 원인
400은 API가 사용자가 누구인지는 이해했지만 요청 자체를 거부했다는 뜻입니다. invalid_request_error 뒤의 메시지가 보통 무엇이 잘못됐는지 정확히 알려줍니다. 아래 표와 대조해 보세요.
마지막 확인
오류 텍스트
API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"..."}}메시지 대조
| 메시지에 포함된 내용 | 원인 | 해결 |
|---|---|---|
| model / not found / invalid model | ANTHROPIC_MODEL 또는 /model이 사용할 수 없는 모델 ID를 가리킴 | /model 또는 모델 페이지에서 모델 선택 |
| prompt is too long / context | 대화가 모델의 컨텍스트 창을 초과함 | /compact 실행, 또는 /clear 후 새로 시작 |
| max_tokens | 출력 토큰 재정의가 모델에 비해 너무 높음 | CLAUDE_CODE_MAX_OUTPUT_TOKENS 제거 또는 낮추기 |
| Not found / 404 instead of 400 | Base URL이 /v1로 끝남 | https://api.aicodewith.ai를 정확히 사용 |
| image / file | 모델이 받을 수 없는 첨부 파일 | 첨부 파일 크기 조정 또는 제거 |
단계별 해결
1. 메시지 읽기
invalid_request_error 뒤의 텍스트가 문제를 알려줍니다. 위 표에서 대조하세요.
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. 컨텍스트 줄이기
/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.