Claude Code ガイド

Appearance

レートリミットのリトライメッセージ改善：どの制限に達したか・リセット時刻が明確に表示 ​

原文（日本語に翻訳） ​

レートリミットのリトライメッセージを改善：不透明な秒数のカウントダウンの代わりに、どの制限に達したか・いつリセットされるかを表示するように

原文（英語） ​

Improved rate-limit retry messages to show which limit was hit and when it resets instead of an opaque seconds countdown

概要 ​

これまでレートリミットに達した際のメッセージは「N秒後にリトライ」という不透明なカウントダウンのみで、何の制限に引っかかったのかわかりませんでした。今回の改善で、どのレートリミット（分当たりのリクエスト数、トークン数など）に達したのか、そしてリセットされる具体的な時刻が表示されるようになりました。

基本的な使い方 ​

レートリミットに達した際は自動的に改善されたメッセージが表示されます。特別な設定は不要です。

改善前のメッセージ（旧） ​

Rate limited. Retrying in 47 seconds...

改善後のメッセージ（新） ​

Rate limit hit: requests_per_minute
Resets at: 14:32:00 JST
Retrying automatically...

実践例 ​

長時間の自動タスク実行時 ​

bash
# 大規模なコード生成タスクを実行
claude -p "この1000ファイルのプロジェクトを全てリファクタリングして"

# レートリミット到達時の新しいメッセージ例:
# Rate limit hit: output_tokens_per_minute
# Resets at: 15:45:30 JST
# Retrying in 28 seconds...

CIパイプラインでのモニタリング ​

bash
#!/bin/bash
# rate_limit_aware_runner.sh

# Claude Codeの出力をログに記録しながら実行
claude -p "プロジェクト全体のコードレビューをして" 2>&1 | tee claude_output.log

# ログからレートリミット情報を確認
grep "Rate limit hit" claude_output.log

どのレートリミットに注意すべきか ​

Claude APIにはいくつかのレートリミットがあります：

リミットの種類説明
requests_per_minute1分あたりのAPIリクエスト数
input_tokens_per_minute1分あたりの入力トークン数
output_tokens_per_minute1分あたりの出力トークン数
requests_per_day1日あたりのリクエスト数

注意点 ​

  • 自動リトライ: レートリミットに達してもClaude Codeは自動的にリトライするため、手動の操作は不要です
  • リセット時刻の活用: 長時間待つ必要がある場合（日次制限など）は、リセット時刻を参考に再試行のタイミングを計画できます
  • Proプランでのリミット: 使用プランによってレートリミットの上限が異なります
  • APIキー使用時: APIキーで使用している場合のリミットはアカウントのティアに依存します

関連情報 ​