動作・エラー

Claude Codeのエラー・動作トラブルとは｜このカテゴリで分かること

Claude Code を使っていると、動作が重くなる、固まる、会話が長すぎると言われる、API のエラーが出る、といった問題が起こります。公式のトラブルシューティングとエラー一覧には、それぞれの原因と対処がまとめられています。このカテゴリでは、Claude Code のエラーと動作のトラブルを、症状から探せるように整理します。

対象は、動作が遅いと感じている人、エラー文の意味が分からない人、長い作業の途中で止まってしまった人です。ゴールは、症状から原因の種類（自分の環境、会話の大きさ、サーバー側の障害）を見分け、無駄な設定変更をせずに対処できることです。

はじめにおすすめの3本

迷ったら、まずこの3本から読んでください。残りの記事は、このページ下の項目一覧から選べます。

1. Claude Codeが重い・遅い・固まる問題｜原因の切り分けと対処
   重い、遅い、固まるときの、原因の切り分けの手順です。
2. Prompt is too longエラー｜原因と直し方
   会話が長いときに出るエラーの、原因別の直し方です。
3. Claudeの障害確認とAPI Error 5xx｜待つか直すかの判断
   5xx のエラーが出たときの、待つか直すかの判断です。

押さえておきたいポイント（リサーチ）

公式ドキュメントで確認できた事実です。

仕様は更新されます。最新は公式で確認してください。

よくある疑問

Q. 重いのは、パソコンの性能が原因ですか。
A. 多くの場合、会話の大きさやサーバーの混雑が原因です。切り分けの手順は Claude Codeが重い・遅い・固まる問題｜原因の切り分けと対処 にあります。

Q. 「Prompt is too long」が出ました。会話は消えますか。
A. /clear をしない限り、消えません。/compact で要約して続けられます。使い分けは Claude Codeのコンテキスト管理｜/compactと/clearで節約する方法 で説明しています。

Q. 固まったあと、作業は失われますか。
A. 失われません。端末を閉じて開き直し、claude --resume で再開できます。

Q. 5xx のエラーは、自分の設定が原因ですか。
A. 多くはサーバー側です。確認の順番は Claudeの障害確認とAPI Error 5xx｜待つか直すかの判断 にまとめています。

Q. 529 と 5xx は同じですか。
A. 529 は5xx の一種で、API の混雑を示します。Claude Codeの529 Overloadedエラー｜原因と対処 で詳しく扱っています。

症状から探す目安

症状ごとに、最初に見る記事の目安です。