最近Claude APIでプロジェクトを進めていたら、いろんなエラーに悩まされて頭が痛かった。何日も試行錯誤して、ハマった点を整理してみたので、同じように困っている人の助けになればと思う。
Error 401 Unauthorized
このエラーが最も多く、十中八九API Keyの問題だ。Keyを完全にコピーできているか確認しよう。特に先頭のsk-ant-が抜けていないか。また、Keyの期限切れや失効(取り消し)でもこのエラーになるので、Anthropicの管理画面で再生成すればOK。
Error 429 Rate Limit Exceeded
リクエストが多すぎてレート制限にかかった状態。無料アカウントは1分あたり60回までで、有料アカウントはもう少し高い。対処法:
- コード側で遅延を入れる(例:各リクエストの間隔を1秒にする)
- 指数バックオフ戦略でリトライを処理する
- プランをアップグレードして上限を引き上げる
Error 529 Overloaded
Claudeのサーバーが過負荷。こういうときは数分待ってから再試行すればよい。頻繁に出るなら、北米時間帯のピークを避けて利用するなど、時間帯をずらすのも手。


