Claude Codeでコードを読ませる方法｜まず理解させると怖くなくなる

こんにちは、かっぺいです。

Claude Codeを使うとき、いきなりコードを書かせたくなる。わかる。せっかくAIなんだから、ドーンと作ってほしい。

でも、最初にやるべきことはそこではない。まず読ませる。まず説明させる。まず全体像をつかませる。

ここを飛ばすと、AIと一緒に迷子になります。しかも迷子のくせに、めちゃくちゃ足が速い。怖い。

コードを書かせる前に、読ませる

Claude Codeは、プロジェクト全体を読める。これが強い。

普通のチャットAIなら、こちらがコードを貼る必要があります。でもClaude Codeなら、フォルダの中を見て、関連ファイルを探して、全体像をつかめる。

公式のCommon workflowsでも、まず高レベルな概要を聞き、そこからアーキテクチャ、主要なデータモデル、関連ファイルへ掘っていく流れが紹介されています。つまり、最初にやるべきことは「書いて」ではない。「読んで」なのだ。

まず聞くべきこと

最初の質問はこれでいい。

このプロジェクトの全体像を説明してください。
主要なフォルダ、重要そうなファイル、アプリの入口を初心者向けに整理してください。
まだ編集はしないでください。

これだけで、Claude Codeはプロジェクトを案内してくれます。自分で全部読む必要はない。もちろん、最終的には自分でも見る。でも最初に地図があるだけで全然違う。

地図なしで山に入るのは怖い。コードも同じ。

見るべきポイントは3つ

初心者が全部を理解する必要はありません。最初に見るべきポイントは3つです。

この3つがわかると、急に怖くなくなります。「このアプリ、何がどこにあるかわからない」状態が一番怖い。逆に、入口と画面とデータの場所がわかれば、かなり落ち着く。

家で言えば、玄関、リビング、キッチンがわかった状態です。あとはトイレを探せばいい。

コードのトイレとは何か。それは私にもわからない。でも、たぶん設定ファイルあたりです。

変更前に聞くと良い質問

何かを直したいときも、いきなり編集ではない。まず聞く。

この機能を変更する場合、どのファイルを触ることになりそうですか？
変更方針を3行で説明してください。
まだ編集はしないでください。

これが強い。触るファイルが先にわかる。変更方針もわかる。自分が「それは違う」と思えば止められる。

自作アプリ記事にも使える

この「読ませる」作業は、ブログ記事にも使えます。自分が作っているアプリを紹介するとき、

• 何をするアプリなのか
• どこが便利なのか
• どこをClaude Codeに手伝ってもらったのか
• どこで詰まったのか

を整理しやすくなる。開発ログを書く前に、Claude Codeにこう聞けばいい。

このアプリの特徴を、ブログ読者向けに説明できるよう整理してください。
技術的な話と、ユーザーにとって便利な話を分けてください。

これ、かなり使える。開発しながら記事の材料も貯まる。一石二鳥。

いや、一石二鳥どころではない。石を投げたら、鳥と記事とアプリ改善案が落ちてくる。すごい時代だ。

まとめ：まず読ませる。話はそれからだ

Claude Codeで怖いのは、何をしているかわからないまま進むことです。だから、まず読ませる。説明させる。方針を出させる。そこから編集に入る。この順番が大事です。

Claude Codeは、コードを書く前にコードを読む相棒として使うと、急に扱いやすくなる。

まずは聞いてみてください。「このプロジェクト、何をしているの？」

そこから始めよう。

参考

• Claude Code Overview：https://code.claude.com/docs/en/overview
• Claude Code Common workflows：https://code.claude.com/docs/en/common-workflows
• Claude Code Best practices：https://code.claude.com/docs/en/best-practices