Claude Codeが指示どおり動かない？起点フォルダを整える3ステップ

Claude Codeへ同じ指示を出したのに、プロジェクトによって回答や探し始める場所が違う。そんな状態に困っていませんか。

先に結論をお伝えすると、プロンプトだけでなく、どのフォルダから仕事を始めたかを確認する必要があります。

この記事は、Claude Codeを使い始めた方に向けて、起点フォルダ、CLAUDE.md、ファイル名、セッションを安全に整える方法を解説します。

フォルダ設計が変えるのは「知能」ではなく「仕事の前提」

フォルダをきれいにするだけで、Claudeのモデル性能そのものが上がるわけではありません。

変わるのは、次の3つです。

・起動時に読み込まれるCLAUDE.md

・ファイルを探すときの標準範囲

・発見されるプロジェクト設定や作業ルール

起点フォルダは、Claude Codeへ「ここが今回の仕事場です」と伝える境界線です。

会社の全資料が積み上がった机より、案件に必要な資料とルールだけが置かれた机の方が、担当者は迷わず仕事を始められます。Claude Codeでも同じように、仕事の範囲を明確にすることが重要です。

同じプロンプトでも差がつく3つの原因

起点フォルダが変えるのはClaudeの知能ではなく、仕事を始める前提です。AI生成の図解です。

1. 読み込まれるCLAUDE.mdが違う

Claude Codeは、現在の作業フォルダから上の階層へたどり、見つかったCLAUDE.mdを読み込みます。

上位に会社共通ルール、下位に案件固有ルールを置けますが、内容が矛盾していると、どの指示に従うべきか判断が不安定になります。

CLAUDE.mdは、長さよりも短さ、具体性、矛盾のなさが重要です。

2. 標準の探索範囲が違う

Claude Codeは、起動したフォルダとその配下を標準の仕事場として扱います。

別の場所は追加できますが、追加したフォルダと、最初から仕事の起点にしたフォルダは同じ扱いではありません。多くのプロジェクト設定は、元の作業フォルダとその親から発見されます。

フォルダを追加することと、そこへ仕事場を移すことは別物です。

3. 会話に残っている情報が違う

Claude Codeの会話には、指示だけでなく、読んだファイルやコマンドの結果も蓄積します。

途中から無関係な仕事へ切り替えると、古い情報が新しい判断を邪魔しやすくなります。

一つの目的には一つのセッションを使い、無関係な仕事へ移るときは会話を分けます。

誤解しやすいポイント

Claude CodeはPC全体を毎回自動で網羅検索するわけではありません。

また、ファイル名だけを見て判断するわけでもありません。ファイルのパターンを探す機能に加え、内容を検索し、本文を読む機能があります。

分かりやすい名前は検索の手掛かりになりますが、整理だけで正しい回答が保証されるわけではありません。

フォルダが深いだけで、中の全ファイルが自動的に読み込まれるわけでもありません。コンテキストを使うのは、起動時の指示、会話、実際に読んだファイル、コマンド結果などです。

整理の目的は階層数を減らすことではなく、必要な情報とルールの境界を分かりやすくすることです。

最初のCLAUDE.mdに書くこと

最初から長いマニュアルを作る必要はありません。

まずは、次の4項目に絞ります。

・このプロジェクトの目的

・重要なフォルダと役割

・変更後に実行するテストや確認

・開いてはいけない情報、上書きしてはいけないファイル

「適切にテストする」ではなく「変更後にnpm testを実行する」のように、確認できる言葉で書きます。

公式ドキュメントは、CLAUDE.mdを1ファイル200行未満にすることを目安として示しています。毎回使わない長い手順は、必要なときだけ読み込むルールやSkillへ分けます。

安全に整える3ステップ

フォルダ整理では、いきなり移動や改名を実行させないことが大切です。

1. 変更せずに現状を調べる

Claude Codeへ、フォルダ構成、役割が分かりにくい名前、重複候補、移動すると設定が壊れそうな場所を調査させます。この段階では、移動、改名、削除を禁止します。

2. 起点と指示を確認する

今回の成果物全体を見渡せる場所から始めているかを確認します。contextコマンドで、意図したCLAUDE.mdが読み込まれているか、不要に大きい指示がないかも確認します。

3. 小さな変更計画を作る

変更前、変更後、理由、影響する参照先、戻し方を一覧にしてもらいます。人間が内容を確認してから、少数のファイルで試します。

整理はファイルを動かす前の調査と計画から始めます。AI生成の図解です。

最初にClaude Codeへ任せるのは、整理作業ではなく「変更なしの調査」です。

自力で難しいと判断する境界

次の状態では、すぐに自動整理せず、開発担当者やシステム管理者へ確認してください。

・ファイルの参照先やリンク元が分からない

・Gitの未コミット変更が大量にある

・顧客データ、認証情報、社内限定資料が含まれる

・移動によってアプリや自動処理が停止する可能性がある

・原本と削除可能な一時ファイルを区別できない

フォルダ設計は、Claudeの知能を上げる裏技ではありません。

Claudeが迷わず、安全に仕事を始めるための業務設計です。

まず一つのプロジェクトを選び、ファイルを変更しない調査から始めてください。

参考資料

・Claude Code公式「How Claude remembers your project」

・Claude Code公式「Best practices for Claude Code」

・Claude Code公式「Configure permissions」