ゼロから始めるClaude Code #4 フォルダ構成編【図解】グローバルとプロジェクトの関係を理解する

Claude Codeの設定が「グローバル」と「プロジェクト」の2層に分かれている。この事実だけで、初心者は必ずモヤモヤする。「なぜ同じ名前のファイルが2箇所にあるのか」「どっちが優先されるのか」——これらの疑問は、すべてこの2層構造を理解していないせいだ。本連載の解説は、スマホの「本体設定」と「アプリごとの設定」という比喩を使う。これが効く。

AIの鬼の視点で言えば、この2層構造は「個人の自由度」と「チーム運用の安定性」のバランスを物理的に実装した設計だ。グローバル側に書いた指示（「回答は日本語で」など、全プロジェクト共通）は、全員に同じ基本方針を与える。一方、プロジェクト側の設定は「このプロジェクトだけ」に限定される。つまり、個人が勝手に全体の設定を弄って他人に被害を出す余地が物理的に減る。settings.jsonとsettings.local.jsonの使い分けも、その延長だ。共有すべき権限設定は前者に、自分だけの試し設定は後者に——こう分けておけば、Gitで管理するときの衝突も、マージ時の失敗も劇的に減る。

そもそも、なぜ会話履歴はグローバル側に保存されるのか。プロジェクトフォルダ内に履歴を散らかされれば、ファイル管理が汚れる。だが逆に、作業フォルダを他チームに渡すときも、機密の会話ログまで一緒に行かない。これも「情報資産の分離」という実務的工夫だ。初心者には「2層は複雑」に見えるが、実は逆。多層化することで、個人の自由と全体の秩序を同時に守る仕組みになっている。中小企業がClaudeを複数部門で回したいなら、まずこの2層の意味を腹に落とすこと。そこから先のトラブルの大半は、ここの理解不足が遠因になっている。