PaPoo
cover

Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"Rate limited"} のときに、まず切り分けたいこと

この症状は、Claude Code が API から 429rate_limit_error を受け取って止まるものです。今回集まっている issue は 3 件とも解決済みで、どれも同じ系統のエラー文字列を含んでいました。

報告内容で共通しているのは、単なる「使いすぎ」で出る制限ではなく、API Error: Server is temporarily limiting requests (not your usage limit) と読める点です。つまり、少なくとも issue 上では「自分の利用上限に達した」とは書かれていません。サーバー側の一時的な制限として扱われています。

実際の報告では、次の文字列がそのまま出ています。

Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"Rate limited"},"request_id":"req_011CdBp6diwVhNmSZmaw4Xjm"}
    at generate (B:/~BUN/root/src/entrypoints/cli.js:11:53135)

別の報告でも同じ形式です。

Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"Rate limited"},"request_id":"req_011CdBp7iirEkVyTK93kP3NB"}
    at generate (B:/~BUN/root/src/entrypoints/cli.js:11:53135)

この時点で読者が自分のケースかどうかを見るなら、まず 429rate_limit_errorRate limited の 3 点が揃っているかを確認するのが早いです。少なくとも今回の issue 群では、同じ文言がそろっていました。

解決の方向として issue で実際に示されていたのは、#73655 に寄せることでした。コメントでは、重複として閉じられており、「そちらを follow して 👍 を付けてほしい」と案内されています。今回の 3 件だけを見る限り、個別の恒久対処は本文中で確定していません。

筆者環境で claude doctor を実行すると、インストール状態は次のように出ました。

Claude Code doctor

Running: native (2.1.207)
Commit: bc512d563325
Platform: darwin-arm64
Path: ~/.local/share/claude/versions/2.1.207
Config install method: native
Search: OK (bundled)
Auto-updates: enabled
Auto-update channel: latest
Last update attempt: none recorded

Multiple installations found
- npm-global at /usr/local/bin/claude
- native at ~/.local/bin/claude

Remote Control
Control this session from claude.ai/code or the Claude mobile app

1 warning found
- Leftover npm global installation at /usr/local/bin/claude
  Fix: Run: npm -g uninstall @anthropic-ai/claude-code

For a full setup checkup that can also fix issues, run /doctor in a Claude Code session.

ただし、これが今回の 429 rate_limit_error の直接原因だとは、issue からも検証出力からも断定できません。言えるのは、筆者環境では複数インストールが検出されていたことだけです。claude doctor が警告しているのは npm global の残骸で、これは別件として切り分けるのが無難です。

このエラーに遭遇したとき、現時点で記事として言い切れるのはここまでです。少なくとも、今回の 3 件はすべて同系統のサーバー側制限として扱われ、#73655 への集約が案内されていました。自分のログに上のエラー文字列が出ているなら、同じ症状の可能性が高いです。


検証環境

claude --version : 2.1.207 (Claude Code)
OS          : Darwin 25.3.0 (arm64)
Python      : 3.14.2
検証日時    : 2026-08-16T14:06:25+09:00

参照した Issue(anthropics/claude-code): #79476, #79171, #79169

同じ著者の記事