Claude Code：開発の常識を変える「基本原則」と「魔法のワークフロー」

1. イントロダクション：Claude Codeは「ただのチャット」ではない

Claude Codeの世界へようこそ。このツールを手に取ったあなたに、まず伝えておきたい「核心」があります。それは、Claude Codeを「ただの便利なチャットボット」だと思わないことです。

従来のAIツールが「指示に対してテキストを返す」だけの存在だったのに対し、Claude Codeはあなたの代わりにコードを読み、ターミナルでコマンドを叩き、テストを走らせる「自律的なエージェント（行動する代理人）」です。

このツールがあなたの生産性を「10倍」に変え得るのは、単にコードを書くのが速いからではありません。Boris Cherny氏（Claude Codeの生みの親）が提唱するように、複数の作業を並列で進める「git worktree」運用など、AIに「手足」を預ける新しい開発スタイルが可能になるからです。

「対話するツール」から「自律的に動く相棒」へ。この意識の切り替えこそが、最高の結果を引き出す第一歩となります。では、この有能な相棒を使いこなすための「3つの役割」を学んでいきましょう。

--------------------------------------------------------------------------------

2. 核心の教え：なぜ「いきなりコードを書かせない」のが重要なのか

開発における最初のステップは、「設計者（The Architect）」としてのClaudeを呼び出すことです。

初心者が陥りやすい罠は、いきなり「この機能を実装して」と頼んでしまうこと。しかし、Boris氏は断言します。「Almost always use Plan mode（ほぼ常にPlan modeを使え）」と。

なぜ「Plan Mode」が重要なのか。それは「コンテキスト（Context Window）」を守るためです。コンテキストとは、いわばClaudeの「短期記憶の作業スペース」のこと。いきなり実装を始めると、試行錯誤の過程でこの限られた記憶スペースが「ゴミ」で埋まってしまいます。先に計画を立てることで、記憶をクリーンに保ち、正解への最短ルートを通ることができるのです。

「いきなり実装」vs「Plan Modeでの計画」

「src/auth フォルダを読んで、OAuth導入の影響範囲を調べて」といった調査・計画のステップを挟むだけで、AIの「知能」は最大限に発揮されます。

完璧な設計図ができたら、次はそれを形にし、正しさを証明する「検証」のステップへ進みましょう。

--------------------------------------------------------------------------------

3. 最高のリレバレッジ：AIに「自分のミス」を検証させる魔法

実装を依頼する際、Claudeを「検査官（The Inspector）」として機能させてください。

Boris氏が「最もレバレッジ（投資対効果）が効く」と述べているのが、この「自己検証（Verification）」です。Claudeは単にコードを「書く」だけでなく、ターミナルに「手」を伸ばしてコマンドを実行できます。

自己検証を依頼する3つのメリット

• 「動かないコード」を未然に防ぐ： あなたが確認する前に、Claudeが自分でバグを見つけて修正します。
• レビューコストの最小化： 「テストをパスした状態」で成果物が届くため、人間は本質的な設計確認に集中できます。
• 視覚的な確認も可能： Chrome拡張機能と連携すれば、Claudeは「スクリーンショット」を見てUIの崩れを自分で検知できます。

具体的な検証の指示例（Claudeの「手」を動かす）

AIには、以下のように「実行して確認して」とセットで依頼しましょう。

// ターミナルでテストを実行させる
「修正が終わったら npm test を実行し、すべてパスしたことを確認してから報告して」

// UIの整合性をチェックさせる
「実装後、ブラウザで表示を確認して。スクリーンショットを撮ってボタンの配置がズレていないか確かめて」

// 実行ログをチェックさせる
「CLIの出力を監視して、エラーログが1行も出ていないことを自分の目で確認して」

Claudeは「願望」でコードを書くのではなく、「実行結果」を見てコードを完成させます。この検証サイクルが、プロジェクト全体を賢くしていく仕組みへと繋がります。

--------------------------------------------------------------------------------

4. 共に成長する：CLAUDE.mdでプロジェクトの「知恵」を蓄積する

最後に、Claudeを「記録係（The Archivist）」に任命しましょう。そのための場所が CLAUDE.md です。

これは単なるドキュメントではなく、「プロジェクト固有の長期記憶」です。AIは優秀ですが、あなたの好みの命名規則や、そのプロジェクト独自のビルド手順を最初から知っているわけではありません。

Boris氏の運用哲学は非常にシンプルです。

1. 「同じミスを2回したら追記しろ」
2. 「Ruthlessly edit（容赦なく、常に最新の状態へ編集し続けろ）」

古いルールや不要になったメモを削ることも重要です。記憶が肥大化しすぎると、かえって「コンテキスト（作業スペース）」を圧迫してしまうからです。

CLAUDE.md に蓄積すべき情報のチェックリスト

• [ ] ビルド・起動手順： npm run dev なのか docker-compose up なのか
• [ ] テスト規約： どのコマンドを叩き、どこにテストを書くべきか
• [ ] コーディングの好み： 「型定義は必ずinterfaceを使う」「関数の命名は動詞から始める」など
• [ ] 「地雷」の記録： 「このライブラリを更新すると〇〇が壊れるので注意」といった過去の教訓

ルールを磨き続けることで、Claude Codeは世界で一人、あなたのプロジェクトを最も深く理解するパートナーへと育ちます。

概念が理解できたら、さっそく明日から実践できる「3つのステップ」を確認しましょう。

--------------------------------------------------------------------------------

5. 初心者のための「最小限の3ステップ」スタートガイド

今日から実践できる、最もシンプルで強力なワークフローがこちらです。

Step 1: Plan Modeで相談する

いきなり書かせず、まずは「設計者」として意見を聞きます。

• 魔法のフレーズ： 「Plan Modeで src/components 周りを読んで。Googleログイン機能を追加したいんだけど、影響範囲とテストの観点を整理して。準備ができたら教えて。」

Step 2: 自己検証を含めて依頼する

実装を頼むときは、「検査官」としての役割をセットにします。

• 魔法のフレーズ： 「整理してくれた計画に従って実装を進めて。終わったら自分で npm run test を実行して、エラーがないことを確認してから報告して。」

Step 3: CLAUDE.mdを育てる

AIが間違えたり、新しい発見があったりしたら、その場で「長期記憶」に書き込ませます。

• 魔法のフレーズ： 「今の指摘（または修正内容）を CLAUDE.md に追記して。次からはこのルールを前提に動いて。古い不要なルールがあれば削除して整理しておいて。」

--------------------------------------------------------------------------------

6. まとめ：Claude Codeと歩む新しい開発体験

Claude Codeを使いこなすための旅は、始まったばかりです。本ドキュメントのポイントを3つに凝縮します。

1. Plan（計画）： Plan Modeを使い、コンテキスト（短期記憶）を節約しながら最良の設計を導き出す。
2. Verify（検証）： AI自身にターミナルを操作させ、テストやUI確認を「代行」させることでレバレッジをかける。
3. Persist（蓄積）： 同じミスを繰り返さないよう、CLAUDE.md を「容赦なく」更新し、プロジェクトの知恵を育てる。

この「Plan → Verify → Persist（計画・検証・蓄積）」のサイクルを回し続けることで、開発は驚くほど楽に、そして速くなります。

最初は「指示を出す」ことに慣れないかもしれませんが、心配いりません。もしClaudeが間違えたら、それを CLAUDE.md に書き込めばいいのです。失敗すらも資産に変えていける。それこそが、Claude Codeという最強の相棒と歩む新しいエンジニアリングの醍醐味なのです。

さあ、あなたのターミナルで、新しい開発の常識を動かし始めましょう！