結論
最初にやること：OSのターミナルでmkdir -p .claudeを実行します。
Claude Codeの設定は一つのファイルではなく、挙動を制御するsettings.json、CLAUDE.md、共有MCPの.mcp.jsonなどに分かれます。
CLAUDE.mdはシステム設定JSONではなく、ビルド手順や独自規約を毎セッションへ渡すメモリファイルです。
Skillsやサブエージェントも.claude/配下へ分離できます。
実行場所：OSのターミナルで実行します。
# ターミナルで実行：必要なフォルダを作成
mkdir -p .claude
# ターミナルで実行：空のファイルを作成
touch CLAUDE.md
# ターミナルで実行：空のファイルを作成
touch .claude/settings.json
# 必要な場合だけMCPを追加
# ターミナルで実行：MCPサーバーを登録
claude mcp add --scope project --transport http shared-server https://example.com/mcp具体的な手順
プロジェクト共通の権限とHooksは
.claude/settings.jsonへ置きます。個人上書きは
.claude/settings.local.jsonへ置きます。実行コマンドや独自ルールは短い
CLAUDE.mdへ記述し、/contextで読み込みを確認します。
ユーザー設定と共通メモリは~/.claude/へ置きます。
共有MCPは.mcp.json、サブエージェントは.claude/agents/へ保存されます。
実践プロンプト
役割の混同を検出する監査プロンプトを使います。
入力場所：Claude Codeの対話画面へ貼り付けます。
このリポジトリのClaude Code設定を監査
各内容を次へ分類:
- settings.jsonへ置く設定
- CLAUDE.mdへ置く継続指示
- Skillへ分離する手順
- .mcp.jsonへ置く外部接続
移動案だけを提示し、まだファイルは編集しない注意点
.claudeignoreを必須設定として新規作成する旧記事は使用しません。長い仕様は常時読み込まず、Skillや参照ファイルへ分けます。
手動作成した
settings.local.jsonは自動除外されない場合があるため、Gitの追跡状態を確認します。