結論:Claude Codeで「You’ve hit your limit」が出たときは、まず/usageと/statusで「session/weekly上限」か「429系rate limit」かを切り分けると、最短で再開できます。
- 要点1:session limitは待機とリセット時刻確認が基本。Pro/Max/Team/seat-based Enterpriseでは5時間枠と週次枠を確認します。
- 要点2:429はサーバー混雑かAPIレート制限。
/statusで認証経路を確認し、並列度とモデルを調整します。 - 要点3:運用では
/clear・/compact・モデル切替(Sonnet/Opus/Haiku)・fallback設定の4点で上限到達を減らせます。
対象読者:「今すぐ開発作業を再開したい」実務エンジニア・テックリード・運用担当。
今日やること:このあと紹介する10分手順をそのまま実行し、次回の停止を防ぐためにモデルと並列度の初期設定まで済ませてください。
(2026年7月5日確認時点) 本記事はClaude公式ドキュメント/ヘルプセンターの一次情報だけを使って整理しています。まず誤解しやすいポイントを先に言うと、Claude Codeの「利用上限」と「rate limit」は似て見えて、対処がまったく違います。ここを分けるだけで、復旧までの時間がかなり短くなります。
事例区分:実装パターン解説
以下は実案件データの公開ではなく、公式仕様に基づいた再現可能な運用手順です。
まず切り分ける:session limit と rate limit の違い
同じ「止まった」状態でも、CLIメッセージの種類で打ち手は変わります。最初にここだけ確認してください。
| 表示される主なメッセージ | 意味 | 最初のアクション |
|---|---|---|
| You’ve hit your session limit / weekly limit / Opus limit | 契約プラン側の利用枠に到達 | /usageでリセット時刻確認、必要なら/usage-creditsまたはプラン変更 |
| Server is temporarily limiting requests | 短期的なサーバー側スロットル(プラン上限とは別) | 短時間待機して再試行、継続時はstatusページ確認 |
| Request rejected (429) | APIキー/クラウド側のrate limit超過 | /statusで認証経路確認、並列度とモデルを下げる |
| Usage credits required for 1M context | 1Mコンテキスト利用にusage creditsが必要 | /modelで通常コンテキストモデルへ戻すか、usage credits有効化 |
止まってから10分で再開する手順
1) いま何で詰まっているかを即確認
/status
/usage
/statusは「どの認証(subscription/API key/クラウド)」で動いているかを確認するために使います。意図せず低Tier APIキーが有効になっていると、Pro/Max契約中でも429が出やすくなります。/usageはセッション/週次の残量とリセット時刻確認に使います。
2) session/weekly limit なら「再開時刻」を固定する
session/weekly系エラーは、表示されたリセット時刻までリクエストがブロックされます。慌てて連打しても改善しません。まず再開時刻をチームに共有し、次の作業を先に切り分けます。
- 同一セッションを再開する前提なら、メモを残しておき、リセット後に
claude --resumeで復帰。 - Pro/Max/Team/seat-based Enterpriseは、必要時にusage creditsで継続可能。
- 「1Mコンテキスト必須」でなければ、
/modelで通常枠モデルに戻すと再開しやすい。
3) 429系なら「負荷の出し方」を変える
429は「使いすぎ」だけでなく、短時間バーストでも発生します。APIのレート制限はtoken bucketで運用され、固定時刻リセットではなく連続回復です。したがって、瞬間的な並列実行を落とすのが有効です。
# モデルを軽くする
/model sonnet
# 高負荷時の並列を見直す(必要に応じて環境変数を調整)
# CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY を下げる
# サービス側状況の確認
# https://status.claude.com
4) 作業文脈を保って再開する
強制終了しても会話は消えません。claude --continueまたはclaude --resumeで復帰できます。途中の文脈が肥大化している場合は、再開直後に/compactを先に実行して、不要な履歴を圧縮してから続けると再停止を防げます。
上限を踏みにくくする日常運用(効果が高い順)
1. タスクが変わるたびに /clear
Claude Codeは過去メッセージを毎ターン再送するため、別件作業を同一セッションに積むほど消費が増えます。ログイン修正のあとにDB移行を始める、のような切替時は/clearが基本です。
2. 長時間セッションは /compact で圧縮
長いデバッグでファイル読込やdiffが蓄積すると、コンテキスト枠と使用量を同時に圧迫します。/compactで要約化して継続すると、品質低下と上限到達を同時に避けられます。
3. モデルを仕事に合わせる
公式ガイドでも、重い思考を常時使うより、用途別のモデル選択が推奨されています。とくに「計画は重め、実装は軽め」の分業が有効です。
4. 貼り付けよりファイル参照
大きなコードやログを毎回貼り付けると、それ自体がコンテキスト常駐してコスト増になります。可能な限りファイルパス指定で必要箇所だけ読ませる運用に変えると、消費が安定します。
5. CLAUDE.md を肥大化させない
CLAUDE.mdは毎ターン先頭で読まれるため、長文化すると恒常的に重くなります。古いルールを定期削除し、現行運用だけに保つのが実務的です。
セッション再開系の運用をさらに詰めたい場合は、Claude Codeセッション再開の実践(continue/resume)もあわせて確認してください。
モデル切替の実務:Sonnet 5・Opus・Haikuをどう使い分けるか
Claude Codeの/modelで、セッション中にモデルを切り替えられます。公式のmodel-configでは、Anthropic API環境でsonnetエイリアスがSonnet 5に解決されること、opusplanで「Plan時Opus→実行時Sonnet」が可能であることが明記されています。
| 場面 | 推奨モデル | 狙い |
|---|---|---|
| 詰まった障害解析・設計判断 | Opus(またはopusplanのPlan側) |
深い推論に寄せる |
| 通常の実装・テスト追加・既知不具合修正 | Sonnet(環境によりSonnet 5) | 品質と消費のバランス |
| 機械的な置換・軽作業 | Haiku | 速度優先でlimit節約 |
さらに止まりにくくするには、fallback chainを設定します。一次モデルが過負荷や一時不可の場合だけ次モデルへ切り替えるため、無駄な失敗リトライを減らせます。
# そのセッションだけfallback
claude --fallback-model sonnet,haiku
# セッション内でモデル確認・変更
/model
/model sonnet
fallback設計の具体例は、Claude Code fallbackModel設定の実装事例が参考になります。組織配布まで含めるなら、全社ガバナンス記事も有効です。
プラン別に見る「上限で止まる条件」と運用方針
実務ではここを誤ると、対処が逆になります。最低限、次の違いだけ押さえてください。
| 契約形態 | 挙動の要点 | 実務上の対処 |
|---|---|---|
| Pro / Max | Web/アプリ/Claude Code/IDEで利用枠を共有 | 同日中の利用チャネルを絞る。必要時はusage creditsで継続。 |
| Team / seat-based Enterprise | 含有枠到達後はusage credits運用が可能 | 管理者側でusage creditsポリシーと上限を先に決める。 |
| usage-based Enterprise | seatごとの上限より従量課金で管理 | 予算とレート制限をConsole側で監視・制御。 |
補足として、Usage settingsでは5時間セッション枠と週次枠(Opus系/その他)を確認できます。運用設計時は「誰がいつ重いモデルを使うか」を事前に決めると、突発停止を減らせます。
❌⭕ よくある失敗パターンと回避策
失敗1:limitエラーを全部同じ扱いにする
❌「とりあえず再実行を連打する」
⭕ まず/usageと/statusで、プラン上限か429かを分ける。
失敗2:重いモデルを常時固定する
❌ 常にOpus固定で小タスクも処理する
⭕ PlanはOpus、実装はSonnet、軽作業はHaikuに分離する。
失敗3:長大ログを毎回貼り付ける
❌ エラーログ全体を毎ターン貼る
⭕ 必要行だけ抜粋し、元ファイルを参照させる。
失敗4:並列サブエージェントを増やしすぎる
❌ 高負荷時間帯に多数の並列実行で429多発
⭕ 並列数を絞り、必要時は小さいモデルへ退避する。
今すぐ使えるCLI指示テンプレート5選
以下は、停止直後にそのまま使える最小セットです。
# 1) 認証経路・現在状態を確認
/status
# 2) session/weekly上限とリセット時刻を確認
/usage
# 3) 利用可能モデルを表示して切替
/model
/model sonnet
# 4) 長文脈を圧縮して継続
/compact keep only the plan and current diff
# 5) タスク切替時に履歴を分離
/clear
FAQ
Q1. 「You’ve hit your session limit」が出たら、すぐ再開できませんか?
A. そのメッセージが示すリセット時刻まではブロックされます。まず/usageで時刻確認を行い、待機中は別タスクを新規セッションで進めるか、usage credits適用可否を確認してください。
Q2. 429はプランを上げれば必ず消えますか?
A. 必ずではありません。429は短時間バーストや認証経路ミス(低Tier APIキー経由)でも発生します。/statusで経路を確認し、並列数・モデル・リクエスト間隔を見直すのが先です。
Q3. Sonnet 5に切り替える最短手順は?
A. セッション内で/modelを実行し、選択肢からSonnet系を選びます。環境によって解決先モデルが異なるため、実際に表示されたモデル名を確認してから固定設定してください。
Q4. 作業が止まるたびに履歴が消えるのが不安です。
A. /clearしても過去会話は保存され、claude --resumeで戻せます。完全破棄ではなく「現行タスクの文脈を軽くする」ための運用と考えると管理しやすいです。
まとめ:今日から始める3つのアクション
- 今日やること:
/statusと/usageを実行し、現在の停止理由を1回正確に判定する。 - 今週中:モデル運用ルール(Opus/Sonnet/Haiku)とfallbackの既定値をチームで決める。
- 今月中:429発生時の再試行間隔・並列度・ステータス確認手順を運用Runbook化する。
次に読むと実装が速い記事
セッション再開(continue/resume)実践 /
fallbackModel設定で障害耐性を上げる方法
著者プロフィール:佐藤傑(さとう・すぐる)。株式会社Uravation代表取締役。X(@SuguruKun_ai)フォロワー約10万人。100社以上の企業向けAI研修・導入支援。著書『AIエージェント仕事術』(SBクリエイティブ)。
出典(一次情報)
- Claude Code Docs: Error reference(session/weekly limit, 429, 一時スロットル,
/usage・/status・/usage-credits) - Claude Code Docs: Model configuration(
/model, Sonnet/Opus/Haiku alias,opusplan, fallback chain) - Claude Code Docs: Manage sessions(
claude --continue,claude --resume,/clear,/compact) - Claude Help Center: Manage usage credits for paid Claude plans(Pro/Max 5x/20x, limit到達後の継続, 5時間リセット)
- Claude Help Center: Usage limit best practices(Usage settings上の5時間枠・週次枠確認)
- Claude Help Center: Team/Enterprise planでのClaude Code利用(usage-based Enterpriseとseat-basedの挙動差)