LLM 設定ファイルガイド

Claude Code と Codex CLI のオーケストレーションに関する設定ファイルの解説。各ツールがどのファイルを読み、どう優先されるかをここにまとめる。

全体マップ

~/.claude/                          ← ユーザーグローバル（全プロジェクト共通）
├── CLAUDE.md                       ← Claude Code: グローバル指示
├── settings.json                   ← Claude Code: 権限・Hook・プラグイン・言語設定
├── skills/                         ← Claude Code: グローバルスキル
│   ├── codex-review/SKILL.md       ←   Codex連携レビューループ
│   └── create-pr/SKILL.md          ←   PR自動作成
└── projects/<hash>/memory/         ← Claude Code: プロジェクト別の永続メモリ
    └── MEMORY.md                   ←   メモリインデックス

<root>/                             ← ワークスペースルート
├── CLAUDE.md                       ← Claude Code: プロジェクト指示
├── AGENTS.md                       ← Codex CLI / OpenAI: エージェント指示
├── .mcp.json                       ← Claude Code: MCP サーバー定義
├── .claude/
│   ├── settings.json               ← Claude Code: プロジェクト設定（共有用）
│   ├── settings.local.json         ← Claude Code: ローカル設定（個人用）
│   └── agents/code-reviewer.yml    ← Claude Code: カスタムエージェント定義
└── skills/
    └── strict-regression-review/   ← Codex CLI: リグレッションレビュースキル
        ├── SKILL.md
        ├── references/checklist.md
        └── agents/openai.yaml

ツール別: どのファイルを読むか

Claude Code

ファイル	スコープ	用途
`~/.claude/CLAUDE.md`	グローバル	全プロジェクト共通の指示（Git安全ルール等）
`~/.claude/settings.json`	グローバル	権限許可リスト、Hook、プラグイン、言語設定
`~/.claude/skills/*/SKILL.md`	グローバル	`/codex-review`, `/create-pr` 等のスラッシュコマンド
`<root>/CLAUDE.md`	プロジェクト	リポジトリ構成、ビルドコマンド、アーキテクチャ、コーディング規約
`<root>/.claude/settings.json`	プロジェクト（共有）	チーム共有のプロジェクト設定
`<root>/.claude/settings.local.json`	プロジェクト（個人）	個人のローカル設定（gitignore推奨）
`<root>/.claude/agents/*.yml`	プロジェクト	カスタムサブエージェント定義
`<root>/.mcp.json`	プロジェクト	MCP サーバー接続先
`~/.claude/projects/<hash>/memory/`	プロジェクト（個人）	会話を跨ぐ永続メモリ

優先順位（高い順）:

ユーザーの直接指示（会話中の発言）
~/.claude/CLAUDE.md（グローバル指示）
<root>/CLAUDE.md（プロジェクト指示）
superpowers 等のプラグインスキル
Claude Code のデフォルト動作

グローバルとプロジェクトの CLAUDE.md は両方読み込まれてマージされる。矛盾がある場合はグローバル側が優先。settings.json も同様に、グローバル → プロジェクト共有 → プロジェクトローカルの順でマージされる。

Codex CLI (OpenAI)

ファイル	スコープ	用途
`<root>/AGENTS.md`	プロジェクト	エージェント指示、スキル一覧、ビルドコマンド
`<root>/skills/*/SKILL.md`	プロジェクト	スキル定義（レビュー手順等）
`<root>/skills/*/agents/openai.yaml`	プロジェクト	OpenAI インターフェース設定
`<root>/skills//references/.md`	プロジェクト	スキル参照資料（チェックリスト等）

Codex は ~/.claude/ 配下は一切読まない。AGENTS.md がエントリポイント。

ファイル別: 詳細解説

`CLAUDE.md` — Claude Code への指示書

Claude Code がセッション開始時に自動で読み込む Markdown ファイル。

グローバル (~/.claude/CLAUDE.md): 全プロジェクトに適用。Git操作の安全ルール、自己チェック機能などを定義
プロジェクト (<root>/CLAUDE.md): ワークスペース固有。リポジトリ構成、ビルドコマンド、アーキテクチャ、コーディング規約を定義

CLAUDE.md に書くべきもの:

ビルド・テストコマンド
アーキテクチャの概要
コーディング規約
ワークフロー（スキーマ変更手順、コード生成手順等）
Git ルール

`AGENTS.md` — Codex CLI への指示書

OpenAI の Codex CLI が読み込むファイル。CLAUDE.md の Codex 版と考えてよい。

プロジェクト構成、ビルドコマンド、コーディングスタイルに加え、利用可能なスキルへの参照を含む
codex review コマンド実行時、カレントディレクトリまたは親ディレクトリの AGENTS.md を探す
Claude Code は読むが指示としては使わない（Codex に渡すプロンプト内で参照させる）

`~/.claude/settings.json` — Claude Code のグローバル設定

{
  "hooks": { ... },           // イベント駆動の自動実行（セッション終了時の通知音等）
  "enabledPlugins": { ... },  // プラグイン有効化
  "language": "...",           // 応答言語
  "permissions": { "allow": [...] }  // 自動許可するツール・コマンド
}

ここで許可したコマンドは確認なしで実行される。セキュリティ上、許可範囲は最小限に。

`~/.claude/skills/` — Claude Code のグローバルスキル

スラッシュコマンド（/codex-review, /create-pr）として呼び出せる手順書。

codex-review: Codex CLI でレビュー → トリアージ → 修正 → 再レビューのループ
create-pr: git差分とコミット履歴からPRテンプレートを自動で埋めてPR作成

グローバルに置いているため、どのプロジェクトでも使える。

`<root>/skills/` — Codex CLI のプロジェクトスキル

AGENTS.md から参照されるスキル定義。

strict-regression-review: リグレッション特化のレビュー手順。スタイルではなく破壊リスクに集中
- references/checklist.md: 具体的な検証コマンド集
- agents/openai.yaml: OpenAI インターフェース定義

プロジェクト固有のチェック項目を含むため、ここに置くのが正解。

`.mcp.json` — MCP サーバー設定

Model Context Protocol でツールを拡張する設定。

<root>/.mcp.json: プロジェクトルートの MCP サーバー定義。Claude Code が読む

`.claude/agents/*.yml` — カスタムサブエージェント

Claude Code の Agent ツールで呼び出せる特化型エージェント。

code-reviewer.yml: 軽量モデルで動くコードレビュー専門エージェント。Read/Grep/Glob のみ使用可

`~/.claude/projects/<hash>/memory/` — 永続メモリ

Claude Code が会話を跨いで記憶する情報の保存先。

MEMORY.md: メモリのインデックス（200行以内）
個別メモリファイル: ユーザー情報、フィードバック、プロジェクト状況等

自動で管理されるため、手動編集は基本不要。

クロスレビューサイクル: Claude Code ↔ Codex

開発者
  │
  │ /codex-review を実行
  ▼
Claude Code ──codex review──→ Codex CLI
  │                              │
  │                              │ AGENTS.md + strict-regression-review
  │                              │ を読んでレビュー
  │         ←── findings ────────┘
  │
  │ トリアージ（Agree / Disagree / Escalate）
  │ → 修正
  │ → コミット
  │
  │ ──codex review --base──→ 再レビュー
  │         ←── findings ────────┘
  │
  │ (最大3ループ)
  ▼
完了 or ユーザー判断

異なる AI モデル（Claude と GPT）にクロスレビューさせることで、単一モデルの盲点を補完する。

優先順位まとめ

Claude Code の指示優先順位（高→低）

ユーザーの直接指示（会話中）
~/.claude/CLAUDE.md（グローバル）
<root>/CLAUDE.md（プロジェクト）
superpowers 等のプラグインスキル
Claude Code のデフォルト動作

Claude Code の settings マージ順（後勝ち）

~/.claude/settings.json（グローバル）
<root>/.claude/settings.json（プロジェクト共有・git管理）
<root>/.claude/settings.local.json（プロジェクトローカル・gitignore）

permissions は和集合（どこかで許可されていれば許可）。hooks は全レベルのものが実行される。

各ツールの読み取り範囲

ツール	グローバル設定	プロジェクトルート
Claude Code	`~/.claude/*`	`CLAUDE.md`, `.mcp.json`, `.claude/`
Codex CLI	—	`AGENTS.md`, `skills/`

HOME (`~/.claude/`) vs プロジェクト配下の使い分け

置き場所	いつ使う	例
`~/.claude/CLAUDE.md`	全プロジェクト共通のルール	Git安全ルール、自己チェック
`~/.claude/settings.json`	全プロジェクト共通の権限・Hook	コマンド許可、通知音
`~/.claude/skills/`	プロジェクトに依存しないスキル	`/create-pr`, `/codex-review`
`<root>/CLAUDE.md`	このプロジェクト固有の指示	ビルドコマンド、アーキテクチャ
`<root>/.claude/settings.json`	チーム共有のプロジェクト設定	git管理してチームで揃える
`<root>/.claude/settings.local.json`	個人のプロジェクト設定	IDE固有設定等、gitignore
`<root>/skills/`	プロジェクト固有のCodexスキル	リグレッションチェックリスト
`<root>/.claude/agents/`	プロジェクト固有のサブエージェント	code-reviewer

グローバル設定の注意点

~/.claude/CLAUDE.md の指示はプロジェクトの CLAUDE.md より優先される
ここに書きすぎると、プロジェクト固有の事情と衝突するリスクがある
書くべきもの: どのプロジェクトでも守るべき普遍的なルール（安全策、コミット規約等）
書くべきでないもの: 特定の技術スタック・フレームワーク・ビルドツールに依存する指示

グローバルスキルの注意点

~/.claude/skills/ に置いたスキルは全プロジェクトで /skill-name として使える
プロジェクト固有のチェック（特定のスキーマ変更手順等）を含むスキルはプロジェクト配下に置く
Codex 用スキル（AGENTS.md から参照されるもの）は <root>/skills/ に置く。Codex は ~/.claude/ を読まないため

hisasann/how-to-llm-orchestration.md

Select an option

No results found

Select an option

No results found

LLM 設定ファイルガイド

全体マップ

ツール別: どのファイルを読むか

Claude Code

Codex CLI (OpenAI)

ファイル別: 詳細解説

`CLAUDE.md` — Claude Code への指示書

`AGENTS.md` — Codex CLI への指示書

`~/.claude/settings.json` — Claude Code のグローバル設定

`~/.claude/skills/` — Claude Code のグローバルスキル

`<root>/skills/` — Codex CLI のプロジェクトスキル

`.mcp.json` — MCP サーバー設定

`.claude/agents/*.yml` — カスタムサブエージェント

`~/.claude/projects/<hash>/memory/` — 永続メモリ

クロスレビューサイクル: Claude Code ↔ Codex

優先順位まとめ

Claude Code の指示優先順位（高→低）

Claude Code の settings マージ順（後勝ち）

各ツールの読み取り範囲

HOME (`~/.claude/`) vs プロジェクト配下の使い分け

グローバル設定の注意点

グローバルスキルの注意点

hisasann/how-to-llm-orchestration.md

LLM 設定ファイルガイド

全体マップ

ツール別: どのファイルを読むか

Claude Code

Codex CLI (OpenAI)

ファイル別: 詳細解説

CLAUDE.md — Claude Code への指示書

AGENTS.md — Codex CLI への指示書

~/.claude/settings.json — Claude Code のグローバル設定

~/.claude/skills/ — Claude Code のグローバルスキル

<root>/skills/ — Codex CLI のプロジェクトスキル

.mcp.json — MCP サーバー設定

.claude/agents/*.yml — カスタムサブエージェント

~/.claude/projects/<hash>/memory/ — 永続メモリ

クロスレビューサイクル: Claude Code ↔ Codex

優先順位まとめ

Claude Code の指示優先順位（高→低）

Claude Code の settings マージ順（後勝ち）

各ツールの読み取り範囲

HOME (~/.claude/) vs プロジェクト配下の使い分け

グローバル設定の注意点

グローバルスキルの注意点

`CLAUDE.md` — Claude Code への指示書

`AGENTS.md` — Codex CLI への指示書

`~/.claude/settings.json` — Claude Code のグローバル設定

`~/.claude/skills/` — Claude Code のグローバルスキル

`<root>/skills/` — Codex CLI のプロジェクトスキル

`.mcp.json` — MCP サーバー設定

`.claude/agents/*.yml` — カスタムサブエージェント

`~/.claude/projects/<hash>/memory/` — 永続メモリ

HOME (`~/.claude/`) vs プロジェクト配下の使い分け