エラーは番号で原因がわかります。400はリクエストの書き方の誤り、401はAPIキーの問題、402は支払いの問題、429は上限、500はAnthropic側の予期しないエラー、529はAPI全体の混雑です。問い合わせのときは、レスポンスについているリクエストIDを伝えます。
エラーコード一覧
| 番号 | 種類 | 意味・対処 |
|---|---|---|
| 400 | invalid_request_error | 書き方や内容の誤り |
| 401 | authentication_error | キーが不正・無効・期限切れ |
| 402 | billing_error | 支払い情報を確認 |
| 403 | permission_error | キーの権限やワークスペース設定を確認 |
| 404 | not_found_error | エンドポイントやIDを確認 |
| 413 | request_too_large | リクエストが大きすぎる（Messages APIは128MBまで） |
| 429 | rate_limit_error | 上限に到達（429エラー（rate_limit_error）が出たら？） |
| 500 | api_error | 時間をおいて再試行 |
| 504 | timeout_error | 長い処理はストリーミングで（ストリーミング（少しずつ表示）とは？） |
| 529 | overloaded_error | 混雑。時間をおいて再試行 |
失敗したリクエストは請求されません。ただし、成功する途中で接続が切れた場合は請求されます。
出典・参考：Claude Docs「Errors」、Claudeヘルプセンター「How do I pay for my Claude API usage?」（2026年11月時点で確認）