PaPoo
cover

Error: 429 {"type":"error","error":{"type":"rate_limit_error" が出て、Claude Code が「You've hit your limit」と返すとき

この症状は、Issue の報告ではどちらも 429 の rate limit エラー として出ています。メッセージは同じで、どちらも

This request would exceed your account's rate limit. Please try again later.

という文言を含んでいました。該当する報告は #56991#64462 です。

まず切り分けたいのは、「自分のアカウント上限に本当に達しているのか」と「別の不具合で 429 に見えているだけなのか」です。今回の issue 群だけを見ると、どちらも利用枠が尽きたように見える一方で、報告者は「小さなプロジェクトなのに短時間で尽きた」「1 つのバグ対応で日次トークンを使い切った」と述べています。つまり、少なくとも体感としては“通常の使い方ではない消費”に見えていたわけです。ここまでは分かりますが、issue だけからは「実際に上限が正しく反映されていたのか」「更新の影響があったのか」は断定できません。

代表 issue のコメントでは、重複候補として #56365#55030#56458 が挙がっていました。少なくともコミュニティ側では、同種の 429 が繰り返し報告されていたことは読み取れます。ただし、コメントだけでは恒久的な修正方法は確認できませんでした。

筆者の環境では、Claude Code 自体は次の状態でした。

$ claude --version
2.1.207 (Claude Code)
$ 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.

この出力から確実に言えるのは、筆者の検証環境では native の 2.1.207 が動いていて、別系統の npm-global 版が残っていたことです。もっとも、今回の 429 とこの重複インストールが直接つながるとは、現時点では言えません。claude doctor は健全性チェックとしては役に立ちますが、429 の原因をこれだけで特定できるわけではありません。

一方で、コメントの中には「Claude 本体や Claude Code、ログを消して環境をきれいにしたら直った」という体験談もありました。これは実際の報告としては存在しますが、再現性は不明です。ここは「効いた人がいた」以上のことは書けません。少なくとも issue だけでは、一般的な解決策として採用できるほど裏が取れていませんでした。

現時点で確実なのは、次の 2 点です。

もし同じ画面に遭遇したら、まずは自分のケースが「429 と rate_limit_error を含む同型の症状か」を確認し、そのうえで既存 issue #56991#64462 に近いかを見比べるのがよさそうです。claude doctor でインストール状態を見て、複数インストールが出ていればそこは別途整理しておく価値があります。ただし、それが 429 の根本原因だとまでは言えません。

この症状について、issue から確認できる範囲では「アカウントの rate limit に達した」というエラー表示が中心で、恒久対処はまだ読み取れませんでした。再発するなら、既存 issue への 👍 や新規 issue の起票で、同じエラー文字列と状況をそのまま伝えるのが一番確実です。


検証環境

claude --version : 2.1.207 (Claude Code)
OS          : Darwin 25.3.0 (arm64)
Python      : 3.14.2
検証日時    : 2026-08-10T12:37:19+09:00

参照した Issue(anthropics/claude-code): #56991, #64462

同じ著者の記事