Claude Code をインストールして、コードを書かせてみた。便利だった。でも、しばらく使っていると「なんか微妙な回答が返ってくる」「長いセッションになると精度が落ちる」と感じることがありませんか？
それ、使い方に改善の余地があるかもしれません。
Claude Code はチャットボットではなく、自律的に動くエージェントです。ファイルを読み、コマンドを実行し、コードを書く。この自律性をうまく引き出すには、いくつかのコツがあります。
この記事では、Claude Code を日常的に使う中で「これをやると明らかに結果が良くなる」というベストプラクティスを、カテゴリ別にまとめました。
最も大切なこと：コンテキストウィンドウを意識する
ベストプラクティスの話をする前に、1 つだけ理解しておいてほしいことがあります。
Claude のコンテキストウィンドウは有限で、いっぱいになると精度が落ちる。
コンテキストウィンドウには、あなたのメッセージ、Claude が読んだファイル、実行したコマンドの出力——すべてが詰め込まれます。デバッグセッション 1 回でも数万トークンを消費することがあります。
コンテキストが埋まるにつれて、Claude は以前の指示を「忘れる」ことがあります。つまり、コンテキストウィンドウは最も大切なリソースです。このあと紹介するベストプラクティスの多くは、このリソースを効率的に使うための工夫でもあります。
Claude に「答え合わせ」の手段を渡す
Claude の出力精度を上げるために、最もインパクトがある方法がこれです。
テストコマンド、期待される出力、スクリーンショットなど、Claude が自分で結果を検証できる手段を渡してあげてください。
検証手段がないと、Claude は「正しそうに見えるけど実は動かないコード」を生成することがあります。あなたが毎回チェックしなければならず、結局手間が増えます。
悪い例と良い例
悪い例：
メールアドレスを検証する関数を書いて
良い例：
validateEmail 関数を書いて。
テストケース：user@example.com → true、invalid → false、user@.com → false。
書いたらテストを実行して、全部通ることを確認して。
UI の変更も同じです。
悪い例：
ダッシュボードのデザインを改善して
良い例：
[スクリーンショットを貼り付け]
このデザインを再現して。完成したらスクリーンショットを撮って元のものと比較して。
違いがあれば修正して。
Tip： 「修正して」だけでなく「根本原因に対処して。エラーを握りつぶさないで」と伝えると、表面的な修正ではなく本質的な解決に向かいます。
いきなりコードを書かせない
Claude に「これ作って」と言えば、すぐにコードを書き始めます。でも、いきなりコーディングに入ると間違った方向に突き進むことがあります。
おすすめは、探索 → 計画 → 実装の 3 ステップです。
ステップ 1：探索（プランモード）
Shift+Tab でプランモードに入ります。このモードでは Claude はファイルを読むだけで、変更を加えません。
src/lib/auth/ を読んで、今のセッション管理と認証の仕組みを教えて。
環境変数でシークレットをどう管理しているかも確認して。
ステップ 2：計画
現状を理解したら、計画を立てさせます。
Google OAuth を追加したい。どのファイルを変更する必要がある？
セッションのフローはどうなる？計画を作って。
Ctrl+G を押すと、計画をテキストエディタで直接編集できます。
ステップ 3：実装
計画に納得したら、通常モードに戻して実装を始めます。
さっきの計画に沿って OAuth フローを実装して。
コールバックハンドラのテストを書いて、実行して、失敗したら直して。
Tip： 差分を 1 文で説明できるくらい小さな変更なら、計画は不要です。「タイポを直して」「ログを追加して」のようなタスクは直接実行させましょう。計画が活きるのは、複数ファイルにまたがる変更や、アプローチに迷うタスクです。