Claude Codeで起きるトラブルを4件集めて、直し方を1か所にまとめました。設定で直るものと、ツール側の制約で直らないものを分けています。直らないものを探して時間を溶かさないためです。
直すまでにやることは、平均で3つ。多くは3つ以内で止まります。
まず、どれに当たるか
| 段 | 意味 | Claude Codeでの件数 |
|---|---|---|
| 使い方で直る | 設定ではなく、渡し方や手順で止まる | 4件 |
3段目に当たったら、設定を探すのをやめてください。そのAIにその機能が無いか、仕様で決まっています。探すほど時間が減ります。
使い方で直る（4件）
| 症状 | 起きる理由 | 最初にやること |
|---|---|---|
| 既存のコードを壊される | 文脈を読み違えて、関係ない部分まで書き換えることがあります。 | 変更前にコミットしておく |
| テストを書かずに完成と言う | 指示に含まれていないと、確認の工程を省きます。 | テストまで含めて依頼する |
| エージェントが勝手にファイルを消す | 作業を自律で進める設定では、削除まで実行されることがあります。 | 確認を挟む設定にする |
| バージョン管理と噛み合わない | AIがまとめて変更すると、差分が大きくなって追えなくなります。 | 変更を小さく区切って依頼する |
Claude CodeはどんなAIか
| 項目 | 内容 |
|---|---|
| 提供元 | Anthropic |
| 月額 | 3,000〜3,000円 |
| 無料で試せるか | 無料枠なし |
| 日本語 | 日本語○ |
| 向く場面 | 業務への導入が決まっている場合 |
コマンドラインの中で働く開発の補助役。ファイルの書き換えやコマンドの実行まで任せられる。有料プランに付いてくる形で使えます。実行された中身のチェックは使う側が負います。
料金は提供元が公表している価格です。プランによって、止まる症状そのものが変わることがあります（生成の上限、使えるモデル、同時の本数）。
Claude Codeでとくに多い4件を、手順まで
1. 既存のコードを壊される
なぜ起きるか：文脈を読み違えて、関係ない部分まで書き換えることがあります。
直し方（3つ）
- 変更前にコミットしておく
- 変更範囲を明示して指示する
- 差分を必ず目で確かめる
次からの避け方：作業の前に必ず記録を取ってください。戻せる状態を保つことです。
それでも止まらないとき：Clineで回避できることがあります（無料枠あり）。
2. テストを書かずに完成と言う
なぜ起きるか：指示に含まれていないと、確認の工程を省きます。
直し方（3つ）
- テストまで含めて依頼する
- 動作確認の手順を指定する
- 自分で動かして確かめる
次からの避け方：「動いたことをどう確かめるか」を毎回指示に入れてください。
それでも止まらないとき：Claude Codeで回避できることがあります（有料のみ）。
3. エージェントが勝手にファイルを消す
なぜ起きるか：作業を自律で進める設定では、削除まで実行されることがあります。
直し方（3つ）
- 確認を挟む設定にする
- 作業用の複製で動かす
- 変更前に必ず記録を取る
次からの避け方：自律で動かす範囲を、先に決めておいてください。
それでも止まらないとき：Cursorで回避できることがあります（無料枠あり）。
4. バージョン管理と噛み合わない
なぜ起きるか：AIがまとめて変更すると、差分が大きくなって追えなくなります。
直し方（3つ）
- 変更を小さく区切って依頼する
- こまめに記録を取る
- 差分を読んでから確定する
次からの避け方：1回の依頼で触る範囲を小さく保ってください。
それでも止まらないとき：Clineで回避できることがあります（無料枠あり）。
直らないときに、ほかのAIへ移る目安
Claude Codeで止まる症状には、別のAIなら回避できるものがあります。このサイトで代わりに挙げているのは次のとおりです。
| 代わりに使えるもの | この症状のとき |
|---|---|
| Cline | 既存のコードを壊される／バージョン管理と噛み合わない |
| Claude Code | テストを書かずに完成と言う |
| Cursor | エージェントが勝手にファイルを消す |
乗り換える前に、いま出ている症状が2段目までかを見てください。使い方で直るものを、AIを替えて解決しようとすると、同じことが次でも起きます。
問い合わせる前にそろえるもの
| 控えるもの | 例 |
|---|---|
| いつから | 日付と時刻 |
| 何をしたら | 押した順番・貼った内容 |
| どう出たか | 画面の文字をそのまま。写真でもよい |
| 使っているもの | OS・アプリかブラウザか・プラン |
| 試したこと | 新しい会話で試した／別の端末で試した など |
「動きません」だけでは調べようがありません。この5つがあると1往復で終わります。
先に試す3つ（症状を問わず）
- 新しい会話で、短い指示だけで試す。前のやり取りを引きずっていることが多い
- ブラウザとアプリを入れ替える。どちらかで動けば、動かないほうの問題
- 拡張機能を切る。広告ブロックやVPNが通信を止めていることがある
このページの決めごと
症状は109件を調べ、そのうちClaude Codeで起きるものを4件選んでいます。口コミの点数・満足度・おすすめ順位は載せていません。集めていないためです。並べ方は「設定で直るもの」から順で、優劣ではありません。仕様は変わるので、直らないときは提供元の最新の記載を見てください。