#Claude Code#CLAUDE.md#AI副業#プログラミング#CLI
【AI副業】Claude Codeは親フォルダのCLAUDE.mdも自動読み込み!Codexとの違い&事前確認スクリプトで開発効率を爆上げする方法

【AI副業】Claude Codeは親フォルダのCLAUDE.mdも自動読み込み!Codexとの違い&事前確認スクリプトで開発効率を爆上げする方法

📅

💡 この記事のまとめ

Claude Codeが起動フォルダより上の階層にあるCLAUDE.mdも読み込む仕様を徹底解説!Codexとの比較や誤動作を防ぐ事前確認スクリプトを導入し、AI受託開発・副業で爆速で稼ぐ方法を紹介します。

はじめに:AIプログラミング副業で抜け出すための「ツールの真の仕様」理解

「AIを使ってプログラミング副業で稼ぎたい」「受託開発のスピードを10倍にしたい」と考えている方にとって、Anthropicが提供するCLIツール「Claude Code」は最強の武器です。

しかし、Claude Codeを使いこなして高単価案件を効率よくこなすプロのAIエンジニアと、指示通りに動かず悩んでいる初心者には大きな壁が存在します。その一つが**「プロジェクト階層とルールファイル(CLAUDE.md)の読み込み挙動」**に関する深い理解です。

実は、Claude Codeはカレントディレクトリ(起動したフォルダ)だけでなく、それより上の親フォルダにある CLAUDE.md もすべて自動で遡って読み込む仕様を持っています。

この記事では、この仕様がCodex等の他のAIツールとどう違うのか、意図しないルールの混入を防ぎ開発効率を最大化する「事前確認スクリプト」、そしてこれらを活用して月10万円以上のAI副業収入を得るロードマップをわかりやすく解説します。


Claude Codeの隠れた仕様と「CLAUDE.md」継承メカニズム

1. CLAUDE.mdとは?

CLAUDE.md は、Claude Codeに対して「このプロジェクトではどんな設計思想・コードスタイル・ビルドコマンドを使うか」を伝える指示書(プロンプトファイル)です。プロジェクトのルートに置いておくことで、AIが自動的にそのルールに従ってコードを生成・修正してくれます。

2. 「起動フォルダの上も全部読む」仕様とは?

一般的なCLIツールやAIエディタ(例:OpenAI Codexや従来のコピペ型プロンプト)は、指定されたフォルダ内のみを参照するのが基本です。

しかし、Claude Codeは実行したディレクトリからルートディレクトリ(/)に向かって親フォルダを遡り、存在するすべての CLAUDE.md を統合して読み込みます。

  • ~/projects/CLAUDE.md (共通ルール:日本語で回答すること、テストはPytestを使うこと)
  • ~/projects/client-A/CLAUDE.md (案件固有ルール:TypeScript、Strictモード必修)
  • ~/projects/client-A/app/ (★ここで claude を起動)

この場合、Claude Codeは ~/projects/CLAUDE.md と ~/projects/client-A/CLAUDE.md の両方のルールを適用します。

3. Codexとの違いと注意点

OpenAI Codexなどのツールでは、個別の実行コンテキストごとに完結することが多く、親階層の設定が干渉することは稀でした。

Claude Codeの「親階層も読む」仕様は、共通設定を上位に置けるメリットがある反面、**「過去の別案件のルールが残っていて、予期せぬ挙動を起こす」「トークン数を無駄に消費する」**というデメリット(落とし穴)にもなり得ます。


起動前に有効な指示ファイルを一括出力する便利スクリプト

「今起動したら、どの CLAUDE.md が読み込まれるのか?」を瞬時に把握するためのシンプルなシェルスクリプトを作成しました。これを実行してからClaude Codeを立ち上げることで、誤作動や予期せぬルール適用を100%防ぐことができます。

指示ファイル確認スクリプト (check-claude-md.sh)

bash #!/bin/bash

現在のディレクトリからルートフォルダまで遡って CLAUDE.md を探すスクリプト

current_dir=$(pwd) found_files=()

while [ "$current_dir" != "/" ]; do if [ -f "$current_dir/CLAUDE.md" ]; then found_files+=("$current_dir/CLAUDE.md") fi current_dir=$(dirname "$current_dir") done

ルート(/)のチェック

if [ -f "/CLAUDE.md" ]; then found_files+=("/CLAUDE.md") fi

echo "=====================================" echo "[Claude Code] 読み込まれる指示ファイル一覧:" echo "====================================="

if [ ${#found_files[@]} -eq 0 ]; then echo "適用される CLAUDE.md は見つかりませんでした。" else # 読み込み順序(親→子)に合わせて逆順表示 for (( i=${#found_files[@]}-1; i>=0; i-- )); do echo "- ${found_files[$i]}" done fi echo "====================================="

このスクリプトを ~/.zshrc や ~/.bashrc にエイリアス登録しておけば、claude を叩く前に一発で適用範囲を可視化できます。


この知識を活用してAI副業で収益化する4ステップ

Claude Codeの高度な仕様理解と環境構築力は、そのまま「AI副業での稼ぎやすさ」に直結します。

ステップ1:ココナラやクラウドワークスで「Python/Web制作受託」を開始する

まずはスクレイピング、Webツール作成、API連携などの小規模な開発案件を受注します(相場:1件1万〜5万円)。

ステップ2:階層別 CLAUDE.md テンプレートで開発を高速化

親フォルダに「コーディング規約・セキュリティルール」、案件フォルダに「仕様書・納品条件」を配置します。プロンプトを毎回打ち込む手間がゼロになり、通常3日かかる案件を3時間で完了できるようになります。

ステップ3:誤動作ゼロの高品質納品で高評価を獲得

事前に上記スクリプトで環境を確認しておくことで、AIによくある「指示の無視」や「余計なコード生成」を回避。納品クオリティが上がり、リピーターを獲得しやすくなります。

ステップ4:独自の「CLAUDE.md 設定+自動化パッケージ」をデジタル教材やコンサルとして販売

開発だけでなく、「Claude Codeを使った爆速開発環境の構築ノウハウ」自体をNoteやBrainで販売したり、企業向けにAI導入コンサルティング(時給5,000円〜)を提供して収入の柱を増やします。


Claude Code階層管理のメリット・デメリット

| メリット | デメリット | | :--- | :--- | | 全体ルールの共通化:上位フォルダに置けば全プロジェクトで統一ルールが適用可能 | 予期せぬルールの競合:古い親フォルダの設定が意図せず反映されるリスク | | 設定の手間削減:案件ごとに同じ指示を書く必要がなくなる | トークン消費:不要な CLAUDE.md が多いとコンテキスト領域を圧迫 | | モジュール化:大枠ルールと個別ルールを分けて綺麗に管理できる | デバッグの難易度:指示がどこから来ているか把握しづらくなる(スクリプトで解決可能) |


まとめ:ツールの深い理解がAI副業での圧倒的アドバンテージになる

Claude Codeは単なる自動コード生成ツールではなく、適切な指示ファイル構造をつくることで真価を発揮する強力な相棒です。

「起動フォルダの上の CLAUDE.md も読む」という仕様を理解し、今回紹介した確認スクリプトを活用すれば、AIの誤動作に悩まされることなく、安全かつ超高速で案件を消化できるようになります。

まずは自分のPC環境にスクリプトを導入し、小さな副業案件からAI開発の圧倒的なスピード感を体験してみてください!