初心者 ヒント ベストプラクティス トラブルシューティング

初心者がよくする Claude Code の 10 の間違い（と回避方法）

他の人の失敗から学ぶ。新しい Claude Code ユーザーが直面する最も一般的な落とし穴と、それを克服するための実践的な解決策。

2026年1月18日 • 12 分 • 著者：Claude World

新しいことを学ぶとき、誰もが間違いを犯します。Claude Code では、ある間違いが非常によくあるため、それを避けることで何時間もの苛立ちを節約できます。

ここに初心者がよくする 10 の間違いと、それを避ける方法があります。

間違い #1：一度に多すぎるプロンプトを書く

問題

❌ "ユーザー認証、商品カタログ、ショッピングカート、
Stripe 決済連携、注文履歴、管理ダッシュボード、
在庫管理、メール通知、レスポンシブデザインを持つ
完全な EC サイトを作成して。React、Node.js、
PostgreSQL を使って、AWS にデプロイ。"

Claude は圧倒されます。出力は不完全または混乱します。

解決策

消化しやすいチャンクに分割：

✅ "EC サイトを作ろう。まず商品カタログから—
商品名、画像、価格を表示するシンプルなページ。
後で機能を追加する。"

そして反復：

  1. まず：商品リスト
  2. 次に：商品詳細ページ
  3. 次に：ショッピングカート
  4. 次に：チェックアウト
  5. 以下同様…

経験則

一度に一つの機能。 プロンプトが段落を超えたら、おそらく多すぎます。

間違い #2：Claude が作ったものをレビューしない

問題

あなた："ログインシステムを作って"
Claude：[ログインシステムを作成]
あなた："パスワードリセットを追加して"
Claude：[パスワードリセットを追加]
あなた："ソーシャルログインを追加して"
Claude：[ソーシャルログインを追加]
... 30分後 ...
あなた："なぜどれも動かないの？？"

小さなエラーが積み重なります。各ステップをチェックしないと、壊れた基盤の上に構築することになります。

解決策

重要な変更のたびに：

✅ "アプリを実行してログインページを見せて"
✅ "サンプルユーザーでログインをテストして"
✅ "コンソールにエラーはある？"

経験則

追加する前にテスト。 次のレイヤーを構築する前に、各レイヤーが動くことを確認。

間違い #3：曖昧すぎる

問題

❌ "もっと良くして"
❌ "直して"
❌ "壊れてる"

Claude はあなたにとっての「良い」が何を意味するか分かりません。具体性がないと、ランダムな変更が行われます。

解決策

何が問題で、何が欲しいかを具体的に：

✅ "ボタンがモバイルで小さすぎる—タッチターゲットを
良くするため少なくとも 44px の高さに"

✅ "フォームが Enter を押しても送信されない—
キーボード送信を追加して"

✅ "エラーメッセージがカード内に表示されるけど、
上部のトースト通知にしたい"

経験則

現在の問題 + 望む結果を説明する。

間違い #4：CLAUDE.md をセットアップしない

問題

毎セッション、繰り返す：

  • “TypeScript を使って”
  • “コーディング規約に従って”
  • “React と Tailwind を使ってる”
  • “変数は camelCase で”

時間の無駄で、結果も一貫しません。

解決策

プロジェクトルートに CLAUDE.md ファイルを作成：

# プロジェクト：MyApp

## 技術スタック
- React 18 と TypeScript
- スタイリングに Tailwind CSS
- バックエンドに Supabase

## コーディング規約
- functional components を使用
- named exports を好む
- すべてのファイルは kebab-case

## デザインガイドライン
- ミニマル、クリーンな美学
- モバイルファーストアプローチ
- カラーパレット：blue-600 プライマリ、gray-800 テキスト

これで Claude は自動的にあなたの好みを知ります。

経験則

CLAUDE.md に 10 分投資 = 何時間もの繰り返しを節約。

間違い #5：エラーメッセージを無視する

問題

あなた："動かない"
Claude："どんなエラーが出てる？"
あなた："分からない、赤い文字"

エラーメッセージは正確に何が問題かを教えてくれます。無視すると時間の無駄です。

解決策

常に完全なエラーを共有：

✅ "フォームを送信しようとすると、このエラーが出る：

TypeError: Cannot read properties of undefined (reading 'email')
at handleSubmit (Form.tsx:24:15)"

または単に Claude にチェックを依頼：

✅ "アプリを実行してコンソールのエラーを見せて"

経験則

エラーメッセージは手がかり、ノイズではない。 読む（または Claude に読ませる）。

間違い #6：進捗を保存しない

問題

1時間構築してきた。順調に進んでいる。そして：

  • コンピューターがクラッシュ
  • 誤って何かを壊す
  • 別の方向を試したい

すべてが失われた。

解決策

git を頻繁に使用：

✅ "基本レイアウトが動いてる。'Basic layout complete' としてコミットして"

またはチェックポイントを作成：

✅ "現在の進捗のスナップショットを作成して、
これまで何を作ったかのサマリーと一緒に"

経験則

マイルストーンごとにコミット。 無料の保険です。

間違い #7：最初から過剰エンジニアリング

問題

❌ "Kubernetes、Redis キャッシュ、メッセージキュー、
CI/CD パイプラインを使ったマイクロサービスアーキテクチャを構築"

todo アプリを作っているだけなのに。

解決策

シンプルに始める。必要な時だけ複雑さを追加：

✅ "シンプルな todo アプリを作る。基本的な HTML と 
JavaScript だけ、フレームワークなし。必要なら後でアップグレード。"

最高のアーキテクチャは、動いて理解できるもの。

経験則

まず動かす、それから良くする。 早すぎる最適化は諸悪の根源。

間違い #8：「なぜ」を聞かない

問題

Claude が何かを提案。理解せずに受け入れる：

Claude："ここに useCallback フックを追加しました"
あなた："OK"
... 後で ...
あなた：[コードをどう変更すればいいか全然分からない]

解決策

説明を求める：

✅ "なぜここで useCallback を使ったの？簡単に説明して。"

✅ "この部分が分からない。このコードが何をしていて、
なぜ必要か説明してくれる？"

✅ "これを削除したらどうなる？どんな問題を解決してる？"

経験則

理解は速さに勝る。 何が構築されているか学ぶ時間を取る。

間違い #9：指揮するのではなく Claude と戦う

問題

あなた："別のアプローチを使って"
Claude：[アプローチを変更]
あなた："いや、そうじゃない"
Claude：[別の変更]
あなた："まだ違う"
... 苛立ちが続く ...

欲しくないものは分かっているが、欲しいものを明確にしていない。

解決策

最初から要件を明確に：

✅ "こういうドロップダウンメニューが欲しい：
- ホバーではなくクリックで開く
- 外側をクリックすると閉じる
- スムーズなアニメーション
- 選択されたアイテムの横にチェックマーク

実装する前にアプローチを見せて。"

またはオプションを求める：

✅ "通知を表示する方法が必要。取れる 3 つの異なる
アプローチは何？それぞれ簡単に説明して選べるように。"

経験則

見せる、言わない。 欲しくないものではなく、欲しいものの例を与える。

間違い #10：最初から完璧を期待する

問題

あなた："ランディングページを作って"
Claude：[ランディングページを作成]
あなた："頭の中にあったものと違う。AI は役立たず。"

最初のドラフトが完璧なことは稀—人間でも AI でも。

解決策

反復を受け入れる：

✅ "良いスタート！改良しよう：
- ヒーローセクション：見出しをもっと太く
- 色：もっとコントラストを
- レイアウト：機能セクションにもっと余白を"

最初の出力は形作る粘土であって、完成した彫刻ではないと考える。

経験則

最初のバージョンはスケッチ。 改良こそ魔法が起こる場所。

ボーナス間違い

間違ったタスクに Claude を使う

Claude Code が得意なこと：

  • ✅ コードの構築と修正
  • ✅ 問題のデバッグ
  • ✅ 概念の説明
  • ✅ ドキュメントの作成

Claude Code があまり得意でないこと：

  • ⚠️ リアルタイムウェブ検索（データが古い可能性）
  • ⚠️ セットアップなしでプライベート API にアクセス
  • ⚠️ 長時間実行プロセスの実行
  • ⚠️ 人間の判断が必要なタスク（デザインセンス、ビジネス判断）

キーボードショートカットを使わない

クリックをやめる。これを覚える：

ショートカットアクション
EscapeClaude を中断
Ctrl+C現在の操作をキャンセル
上矢印最後のプロンプトを呼び出す
Tab提案を受け入れる

コストのチェックを忘れる

// 使用量をチェック
claude --cost

// 予算警告を設定
// settings.json で：
{
  "costWarning": {
    "sessionLimit": 5.00,
    "dailyLimit": 20.00
  }
}

クイックリファレンス：するべき・すべきでない

❌ しない

  • 10 機能のプロンプトを書く
  • 変更間のテストをスキップ
  • 具体性なく「良くして」と言う
  • エラーメッセージを無視
  • 理解していないコードを受け入れる
  • 指揮するのではなく戦う
  • すぐに完璧を期待

✅ する

  • 作業を小さなチャンクに分割
  • 変更ごとにテスト
  • 問題と目標を具体的に
  • CLAUDE.md をセットアップ
  • エラーメッセージを読むか共有
  • 困惑したら「なぜ」を聞く
  • 最初から明確な要件を提供
  • 反復して改良
  • 進捗を頻繁にコミット

リカバリーフレーズ

うまくいかない時、これを試す：

行き詰まった時

"一歩戻ろう。何を作ったか、どこにいるかを
まとめて。次に何をすべき？"

壊れた時

"何かが動いていない。アプリを実行して
すべてのエラーを見せて。一つずつ修正しよう。"

迷った時

"現在の状態が分からない。何のファイルが
あって、それぞれ何をするか説明してくれる？"

やり直したい時

"このコンポーネントをリセットしよう。[ファイル] を
削除して、よりシンプルなアプローチで再構築。"

黄金律

Claude を有能なジュニアデベロッパーとして扱う。

  • 明確な指示を与える
  • 仕事をレビュー
  • 質問する
  • フィードバックを提供
  • 一緒に反復

機械にコマンドを入力しているのではありません。あなたの指示を必要とする、非常に速く、非常に知識のあるアシスタントとコラボレーションしているのです。

関連記事：最初のアプリチュートリアル、Vibe Coding ガイド、Claude Code クイックスタート