AIが自分で考えてパソコン内の作業を進めてくれる、最先端のツールツール「Claude Code（クロードコード）」。非常に便利で注目されていますが、「AIへの指示はどのファイルに書けばいいの？」「自動で作られたフォルダには何が入っているの？」と疑問に思っていませんか？
Claude Codeを快適に使いこなすための最大のカギは、AIが情報を整理しているフォルダの仕組みを理解することにあります。この仕組みさえ分かれば、AIにあなただけの専用ルールを覚えさせたり、過去のやり取りをもとに作業をスムーズに進めさせたりできるようになります。今回は、専門知識がなくてもすぐに分かる情報の整理術を丁寧に解説しますね。
- 作業ごとの専用ルールと自分好みの個人設定を賢く分ける方法
- AIに作業の方向性を最優先で守らせるための指示書の書き方
- タスクや目的に合わせてAIのルールを自動で切り替えるコツ
- 過去のデータや修正内容をAIに自動で記憶させて育てる仕組み
Claude Codeのディレクトリ構成の基本
まずは、Claude Codeがパソコンの中でどのようにデータを整理し、どのような役割のフォルダを使って動いているのか、基本の形から見ていきましょう。
ターミナルで動くAIの特徴
多くのAIツールは、ブラウザの画面上でチャットをしながら動かしますよね。しかし、Claude Codeは文字を入力するだけの画面（ターミナル）で動く、自律型のアシスタントツールです。一般的なチャットAIだと、人間が「このコードを書いて」「次にこのエラーを修正して」「それをファイルに保存して」と、付きっきりで1ステップずつ指示を出さなければいけませんよね。これが結構、手間で面倒に感じてしまうことも多いかなと思います。
その点、Claude Codeの最大の特徴は、人間が細かく指示をしなくても「このデータを調べて、整理して、そのままファイルに保存しておいて」と頼むだけで、一連の作業をAIが自分で考えて最後まで終わらせてくれる点にあります。例えば、プログラムのバグを見つけて直すタスクなら、AI自らが関連するファイルを読み込み、原因を突き止め、コードを書き換えて、さらに正しく動くかどうかのテストまで一気に自動で実行してくれるんです。まさに「自分の代わりにパソコンを操作してくれる優秀な部下」がターミナルの中に常駐しているような感覚ですね。この非常に賢くて自律的な動きを裏側で支えるために、Claude Codeはプロジェクト内に専用の隠しフォルダを自動で作成し、そこに様々な情報を整理・保存しているわけです。コマンドライン上で動くからこそ、余計な画面の読み込み待ちもなく、パソコンの処理能力を最大限に活かして爆速でタスクを片付けてくれるのが、このツールの本当に頼もしいところだなと感じます。
プロジェクト用のフォルダの役割
あなたが作業を行うフォルダの中に作られる.claudeというフォルダは、その作業スペース専用のルールブックを保管しておく場所です。このフォルダは特定のプロジェクトやディレクトリごとに個別に生成されるもので、その中身はその作業スペース内だけで有効な設定になります。プロジェクトごとに求められる成果物のルールや、プログラミングの言語、デザインのガイドラインって全然違いますよね。そういった「このプロジェクトだけで守ってほしい独自のローカルルール」を詰め込んでおくのがこのフォルダの主な役割かなと思います。
このフォルダの中に「データの形式はこうする」「この作業手順を守る」「テストコードは必ず同時に書く」といった具体的なルールをファイルとして入れておきます。そうすると、Claude Codeはそのプロジェクトで作業を開始する際、自動的にこのフォルダの中身を読み込んで、そのルールに完璧に従った行動をとるようになります。さらに素晴らしいのは、チームで同じ作業を行う場合ですね。このフォルダをGitなどのバージョン管理システムに含めてそのままメンバーに共有するだけで、全員がまったく同じ品質のAIを使って作業できるようになるのでとても便利ですよ。新しくチームに入ったメンバーでも、環境構築をしてClaude Codeを立ち上げるだけで、プロジェクトの文脈やルールを100%理解したAIアシスタントのサポートを受けられるようになるので、教育の手間も大幅に減らせるのが嬉しいポイントですね。
全体で共有するグローバルフォルダ
作業ごとのフォルダとは別に、あなたのパソコンの個人領域には~/.claudeという全体の管理フォルダが作られます。こちらは先ほどのプロジェクト用フォルダとは違い、パソコン全体、つまりすべての作業において共通して適用される「グローバルな設定」を司る場所になっています。macOSやLinuxであればホームディレクトリの直下、Windowsであればユーザーフォルダの直下に隠しフォルダとして自動生成される仕組みですね。
ここには、特定の作業やプロジェクトに縛られないあなた個人の好みや、AIに安全にログインするための認証情報、エディタの表示設定、そしてこれまでのすべての作業を通じてAIが学んだ汎用的な記憶などが蓄積されます。例えば、「自分は普段こういうエディタを使っている」「英語のドキュメントも基本的には日本語で解説してほしい」といった、どのプロジェクトでも変わらないあなた自身のパーソナルな設定は、ここに一括管理されるイメージです。ここはチームの他の人には関係のない、あなただけの秘密の保管庫のような場所なので、他の人と共有するリポジトリに誤ってアップロードしてしまう心配もありません。このグローバルフォルダがしっかりとあなたのPC内に存在しているおかげで、異なるプロジェクトの作業へと切り替えたときでも、Claude Codeは「あなたというユーザーの特性」を忘れることなく、常にあなたに最適化された一貫性のあるサポートを提供し続けてくれるわけですね。
2つのフォルダの役割まとめ
- .claude（作業ごと）：その場所専用のルールや設定をチームで共有する場所。
- ~/.claude（全体・個人用）：あなた個人の好みや、すべての作業の記憶をためておく場所。
最優先で読み込まれる指示書
Claude Codeが仕事を始めるときに、一番最初に必ず読み込む超重要な指示書がCLAUDE.mdというファイルです。これはフォルダのルート（一番上の階層）に配置するマークダウン形式のファイルで、Claude Codeにとっての「絶対的な憲法」のような存在かなと思います。AIと長い時間チャットをしながら複雑な作業を続けていると、AIが会話のラリーに気を取られてしまい、最初のほうに人間が口頭で伝えた指示や前提条件をうっかり忘れてしまうことってありますよね。これはAIの「文脈の限界」によって起こる現象なのですが、Claude Codeはこの問題を非常にスマートに解決しています。
このCLAUDE.mdというファイルに書いた内容だけは、AIがタスクを実行するたびに毎回、最優先で必ず読み直すため、どれだけ会話が長くなっても絶対に忘れない仕組みになっているんです。ここへ「今回の作業の基本方針」や「使用する技術スタック」「ビルドやテストを実行するための具体的なコマンド」、そして「絶対にやってはいけない禁止事項」などを整理して書いておきます。すると、AIは常にこのファイルをカンペ書きのように見ながら作業を進めるため、指示からブレたり、勝手な思い込みで間違ったコードを書いたりすることがなくなります。新しくプロジェクトを始めるときは、まずこのファイルを1枚用意して、そこにプロジェクトの概要を箇条書きでシンプルにまとめておくだけで、Claude Codeの賢さが何倍にも跳ね上がるのを実感できるはずですよ。
特定のルールを分けるフォルダ
すべての指示やルールを先ほどのCLAUDE.mdという1つのファイルだけに詰め込んでしまうと、どうしてもファイルが長くなりすぎて人間が見にくくなりますし、AIにとっても読む量が増えて情報がごちゃ混ぜになってしまう原因になります。そこで、目的や役割に応じてルールを細かく小分けにして保存するために用意されているのが、.claude/rules/という専用のフォルダです。ここに「○○のときはこのルールを見てね」という個別ファイルを複数格納していくスタイルがおすすめですね。
例えば、「データ集計用のルール.md」「ブログ記事執筆用のルール.md」「フロントエンドの装飾ルール.md」のように、タスクのジャンルごとにファイルを分けておきます。すると、Claude Codeは今から人間が依頼しようとしている作業の内容（文脈）を自分で判断して、その瞬間に必要なルールファイルだけを自動でピックアップして読み込んでくれるようになります。これによって、AIのメモリを無駄に消費することなく、その時々のタスクに特化した超高精度な指示をピンポイントで適用できるようになるわけです。ルールが増えてきてもフォルダ内を綺麗に整理整頓しておけば、メンテナンスもすごく楽になりますし、何よりAIが指示を誤認して迷子になってしまう確率をグッと減らすことができるので、作業の正確性とスピードが同時に上がる素晴らしい仕組みだなと思います。
便利なスキルを保存する場所
Claude Codeには、何度も繰り返す面倒な決まりきった作業や、複雑な手順をワンコマンドで一発で片付けられるようにする「スキル（Skills）」という非常に強力な機能が備わっています。そして、その自動化された手順の定義やスクリプトを保存しておくのが、.claude/skills/というフォルダになります。定定型業務をAIに完全に自動化させるための、秘密のレシピ集のようなイメージですね。
例えば、「特定のログファイルからエラーが出ている行だけを自動で抜き出して、見やすい一覧表の形にマークダウンでまとめる」とか、「新しく記事を書くときに必要な初期フォルダと空のファイルを一瞬で自動生成する」といった、人間の手でやると地味に時間がかかる一連の流れをスキルとして覚えさせることができます。一度このフォルダの中にスキルとして登録してしまえば、次からはあなたがターミナルで「いつものデータ抽出のスキルを実行して」と伝えるか、あるいは事前に設定した短いコマンドを打ち込むだけで、AIが裏側で全ての処理を自動的かつ正確無比に進めてくれるようになります。自分の作業スタイルに合わせてこのスキルフォルダに便利な自動化レシピをどんどん貯めていくことで、自分だけの最強の高速開発・作業環境を構築していくことができるのが、Claude Codeを使いこなす上での大きな醍醐味ですね。
賢いサブエージェントの定義
非常に高度で規模の大きいタスクをこなさなければいけないとき、1人のAIアシスタントだけにすべての役割や判断を丸投げしてしまうと、どうしても処理の精度が落ちたり、視野の狭い回答になってしまったりすることがあります。そこでClaude Codeには、特定の専門知識や役割に特化した別の得意分野を持ったAIアシスタントを内部で一時的に呼び出して、仕事を賢く分担させることができる「サブエージェント」という機能があります。その役割や設定を定義しておく場所が、.claude/agents/フォルダです。
具体的には、「データ分析と統計の専門家」「セキュリティの脆弱性がないかをチェックする専門家」「日本語の表現や誤字脱字を厳しく見直す校正の専門家」のように、それぞれ異なるプロンプトを与えた個性豊かなアシスタントをこのフォルダ内にファイルとして用意しておくことができます。メインのClaude Codeは、人間から大きなタスクを受け取ると、このフォルダを見て「よし、この部分はデータ分析のエージェントに任せて、仕上がったものは校正のエージェントにチェックしてもらおう」といった具合に、まるで小さなプロフェッショナルチームをあなたが指揮しているかのような、高度な自律的ワークフローを勝手に組み立てて実行してくれます。これにより、複雑な問題も多角的な視点で検証され、クオリティが劇的に高まる仕組みになっています。
Claude Codeのディレクトリ構成を応用する
ここからは、AIが勝手にあなたの好みを学習する仕組みや、過去のデータを上手に使って作業の質を高める応用テクニックについてお話ししますね。
過去の作業を覚える自動メモリ
Claude Codeを触っていて特に驚かされるのが、人間がわざわざ指示書やマニュアルを細かく手書きで更新しなくても、日々のチャットや作業の形跡から「あなたの好み、プロジェクトの固有の癖、よく遭遇するエラーの解決策」などをAIが勝手に学んで記憶をアップデートしてくれる自動メモリ（Automatic Memory）機能です。この賢い記憶データは、全体を管理するグローバルフォルダの中にある~/.claude/projects/<プロジェクト名>/memory/という深い階層に大切に保管されるようになっています。
このフォルダの中には主にMEMORY.mdというファイルが自動で生成され、そこには「このユーザーは、インデントにスペース4つではなく2つを好む」「以前、この環境でライブラリの衝突エラーが起きたときは、このコマンドを使って対処した」といった、実際の作業を通じて得られた貴重な教訓やナレッジが、AI自身の手によって自動でどんどん追記・蓄積されていきます。つまり、人間が「前にも言ったよね？」とストレスを感じる必要がなくなるわけです。次にClaude Codeを立ち上げて作業をはじめるときは、前回の作業の終わりまでに経験したすべての文脈を引き継いだ状態からスタートできるため、使えば使うほど、あなたの阿吽の呼吸を理解してくれる世界に一つだけの優秀な相棒へと勝手に育っていってくれますよ。この育成型の仕組みこそが、従来の単なるチャットAIとは一線を画す、自律型AIならではの超強力なメリットかなと思います。
編集前の状態に戻せる履歴システム
AIにパソコン内のファイルを直接触らせたり、コードを自動で書き換えてもらったりするとき、いくら便利だと分かっていても「もしAIが勘違いして、大切な元のデータをめちゃくちゃに書き換えて消してしまったらどうしよう…」と、最初は誰でも不安になってしまいますよね。ですが安心してください、Claude Codeに備わっている超強力な履歴システムが、その恐怖や不安をきれいに解消してくれます。AIが何かしらの変更を加えるときは、常に安全弁が働くようになっています。
Claude Codeが行ったすべての作業内容や会話のログはセッションごとに厳重に保存されているほか、実際にファイルの内容をパッと書き換えるその直前の生データが、file-history/というフォルダの中にバックアップとして自動的に退避され、保存される仕組みになっているんです。もしAIが吐き出した作業結果やコードが自分の理想と違っていたり、予期せぬバグを生み出してしまったりしたとしても、専用のロールバックコマンド（巻き戻し指示）を出すだけで、いつでもファイルをAIが触る前の綺麗なオリジナル状態へと一瞬で完全に復元することができます。この強力なセーフティネットがあるおかげで、人間側も「失敗したらどうしよう」と萎縮することなく、実験的な大量のコード変更や大規模な文章の書き換えなどの重たい作業も、すべて安心してAIに丸投げして任せることができるわけですね。
| フォルダ・ファイル名 | 作業での使い道・安心の理由 |
|---|---|
| <session>.jsonl | 会話の完全なバックアップ。途中で止まった作業をそのまま再開できます。 |
| file-history/ | 書き換え前のオリジナルデータが残る場所。いつでも元の状態に戻せます。 |
| history.jsonl | 過去にAIに出した指示（プロンプト）の履歴。同じ指示を何度も使い回せます。 |
チームで使う設定ファイルの優先順位
Claude Codeの細かな挙動や動作モードをカスタマイズするための設定ファイル（settings.json）は、実は目的に応じていくつかの異なる場所に配置することができるようになっています。しかし、あちこちに設定ファイルがあると「結局どれが一番優先されてAIが動くの？」と混乱してしまいますよね。そこはしっかりと考えられていて、どこに書いた指示が一番最初に守られるかという「絶対的な優先順位」があらかじめ厳密に決まっています。
設定の優先順位（上が一番強い）
- システム全体で決められた絶対ルール
- 今その場で、コマンドと一緒に直接だした指示
- 自分のパソコンだけに適用するローカル設定（settings.local.json）
- 作業フォルダ共通の設定（settings.json）
- すべての作業で共通して使う個人設定（~/.claude/settings.json）
この仕組みを理解しておくと、チームでの共同開発や複数人での作業のときにめちゃくちゃ役に立ちます。例えば、チーム全員で共有するリポジトリには4番目のプロジェクト共通設定（settings.json）を配置して「このプロジェクト共通のコード規約や共通ツール設定」を書いておきます。そして、自分だけの画面の色の好みや、他の人には見せられない個人のアクセスパスワード、デバッグ用の設定などは3番目の（settings.local.json）に書いておけば、チーム全体の共有ルールを汚したり壊したりすることなく、自分だけの快適なこだわりカスタマイズを100%両立させて楽しむことができるようになりますよ。
外部ツールと連携する設定のコツ
Claude Codeのフォルダの中に、外部のシステムやツールと繋がるための拡張設定（一般にMCP：Model Context Protocol設定などと呼ばれます）をうまく読み込ませてあげると、AIができることの範囲が信じられないくらい一気に広がります。標準の状態のAIは、基本的には自分のパソコンの中にあるファイルしか見ることができませんが、この連携設定を施してあげることで、AIに強力な「外の世界を見る目と手」を授けることができるようになるかなと思います。
例えば、インターネットに自動でアクセスして最新のトレンド情報や公式ドキュメントのエラー解決策を勝手に検索して調べさせたり、SlackやGitHub、Googleドライブといった外部のクラウドサービスに保存してあるデータを直接AIに読み込ませて処理させたりすることができるようになります。この連携用のアカウント情報や接続ルールを書いた設定ファイル（.mcp.jsonなど）を作業フォルダのルートに1つポイッと入れておくだけで、そのプロジェクトに関わるチームのメンバー全員のClaude Codeが、一斉に同じ外部資料やネット検索機能を使いこなせるようになります。人間がいちいちブラウザを開いてコピペで情報を取ってくるという不毛な手間が劇的に減るので、チーム全体の生産性を極限まで高めるための必須の裏ワザですね。
効率化を導くClaude Codeのディレクトリ構成
ここまで色々と詳しくご紹介してきたように、Claude Codeのフォルダ構造や各種設定ファイルの役割を綺麗に整理整頓して、AIに対して「今どんな目的の作業を、どんなルールと制約で行っているのか」を迷わせずに100%明確に伝えてあげることが、日々の作業や開発を圧倒的に効率化するための一番の近道になります。AIの能力を最大限に引き出せるかどうかは、実はこのディレクトリの整理度合いにかかっていると言っても過言ではありません。
最後に、Claude Codeを取り入れた作業において、どれくらい業務が爆速になるかを表すシンプルな方程式を分かりやすくご紹介しますね。
効率の良さ ＝ フォルダの整理度 × AIの賢さ ／ 人間の手作業の手間
つまり、どれだけAI自体が天才的に賢かったとしても、フォルダの中身が散らかっていてルールがバラバラだとAIは実力を発揮できません。逆に「設定ファイルやフォルダをきれいに整理してAIが次に何をするべきか迷わないようにしてあげれば、AIは自分で考えて水を得た魚のようにどんどん作業を先回りで進めてくれるようになり、人間が何度も同じ指示をキーボードで打ち直す手間や修正の手間は最小限で済むようになる」ということです。ぜひこの記事を参考にClaude Codeのディレクトリ構成を美しく整えて、あなただけの最高に快適な爆速AI作業環境を作ってみてくださいね！
