よくある失敗と対策

「ログイン機能を作って」→「ついでにデザインも直して」→「あ、あとこのバグも...」 と1つのセッションに色々詰め込むと、後半で指示を忘れたり、関係ない変更をし始めます。

対策: 1セッション = 1タスク。タスクが変わったら /clear。
たとえ: 1つの会議で10個の議題を話すと、最後には最初の話を誰も覚えていない。会議を分けましょう。

「違う」→「まだ違う」→「そうじゃない」を繰り返すと、 失敗した会話がどんどん溜まって、Claude がますます混乱します。

対策: 2回失敗したら /clear。もっと具体的な書き方でゼロからやり直す。
たとえ: 道に迷って何度も引き返すより、一度止まって地図を確認するほうが早い。

500行以上のルールを書き連ねると、Claude は重要なルールまで見落とします。

対策: 100~200行に収める。詳細は別ファイルにして「あのファイルを参照して」と書く。
たとえ: 新人に100ページのマニュアルを渡しても読まない。A4 1枚の要点メモのほうが効果的。

詳しくは CLAUDE.md 徹底解説 へ。

Claude が書いたコードをテストせずにそのまま使うと、本番で問題が発生します。 調査によると、AIが生成するコードは人間の約1.75倍のロジックエラーを含む傾向があります。

対策: 「テストを書いて → 実行して → 全部通るまで直して」を毎回伝える。
たとえ: 料理を味見せずに客に出す人はいない。AIのコードも「味見(テスト)」が必要。

Claude に「このプロジェクト全体を調べて」と頼むと、 調査結果だけで記憶容量がいっぱいになり、肝心の実装ができなくなります。

対策: 調査はサブエージェント(Explore)に任せる。要約だけ返してもらう。
たとえ: 自分で図書館に行くのではなく、秘書に「要点だけまとめて」と頼む。

完璧な設定を目指して、Hook、スキル、サブエージェントを大量に作り込む。 しかし実際にはほとんど使わない。

対策: まずはデフォルト設定で使い始める。不便を感じたら、その都度カスタマイズする。 Claude Code の生みの親 Boris Cherny 氏のセットアップが「驚くほど普通」なのは示唆的。
たとえ: 新しいスマホの設定を3日かけて完璧にするより、まず使い始めてから調整するほうが効率的。