ガイド

あらゆる AI コーディングエージェントの設定ファイルの場所：Claude Code、Cursor、Codex、Gemini CLI、OpenCode、Qwen Code、Amp、Factory Droid（2026）

各 AI コーディングエージェントの設定ファイルはどこにあり、同じキーが 2 回設定された場合はどのファイルが優先されますか？

Claude Code は ~/.claude/settings.json に加え、プロジェクト内の .claude/settings.json と .claude/settings.local.json を使います。Codex は ~/.codex/config.toml に加え、信頼済みプロジェクトの .codex/config.toml を使います。Gemini CLI と Qwen Code は ~/.gemini/settings.json と ~/.qwen/settings.json を使い、プロジェクトごとに .gemini または .qwen フォルダを置きます。OpenCode は ~/.config/opencode/opencode.json と opencode.json、Amp は ~/.config/amp/settings.json と .amp/settings.json、Factory Droid は ~/.factory/settings.json を使います。Cursor は AI 設定を Cursor Settings パネルに、permissions.json などのエージェントファイルを ~/.cursor と .cursor に保存します。どのツールでも、プロジェクトのファイルがユーザーのファイルより優先されます。

このページは英語版ガイドの翻訳です。コマンド、設定キー、コードは原文のままです。内容に差異がある場合は英語版が優先されます。英語版を読む → · 他の言語: 简体中文 · 한국어 · Español · Português (Brasil)

設定の変更をいち早くチェック

これらのツールの設定、フラグ、権限ルールが変わったときに、週 1 回メール（英語）でお知らせします。内容は公式ドキュメントで確認済みです。

クイックアンサー：ユーザー設定とプロジェクト設定のファイル

Claude Code：~/.claude/settings.json（ユーザー）、.claude/settings.json（共有プロジェクト）、.claude/settings.local.json（自分だけ、1 プロジェクト）。よく使うオプションは /config で変更できます。
Cursor：AI 機能は Cursor Settings パネル（Ctrl/Cmd + Shift + J）、エディタのキーは VS Code 形式の settings.json、エージェントファイルは ~/.cursor と .cursor の mcp.json、permissions.json、hooks.json、sandbox.json です。Cursor CLI は ~/.cursor/cli-config.json を使います。
OpenAI Codex：~/.codex/config.toml（ユーザー）とリポジトリ内の .codex/config.toml。後者はプロジェクトを信頼した場合にのみ読み込まれます。
Gemini CLI：~/.gemini/settings.json（ユーザー）とプロジェクトルートの .gemini/settings.json。
Qwen Code：~/.qwen/settings.json（ユーザー）とプロジェクトルートの .qwen/settings.json。
OpenCode：~/.config/opencode/opencode.json（グローバル）とプロジェクトルートの opencode.json。JSONC も使えます。
Amp：~/.config/amp/settings.json（ユーザー）と最も近い .amp/settings.json（ワークスペース）。すべてのキーは amp. で始まります。
Factory Droid：~/.factory/settings.json。/settings コマンドで編集します。同じ場所の settings.local.json が上にマージされます。

どのファイルが優先されるか

Claude Code（優先度の高い順）：managed settings、コマンドライン引数、.claude/settings.local.json、.claude/settings.json、~/.claude/settings.json。permissions.allow などのリスト型キーはファイル間でマージされます。
Codex（優先度の高い順）：CLI フラグと -c による上書き、プロジェクトの .codex/config.toml ファイル（作業ディレクトリに最も近いものが優先）、--profile ファイル、~/.codex/config.toml、最後にシステムと組み込みのデフォルト。
Gemini CLI と Qwen Code：プロジェクトのファイルがユーザーのファイルより優先され、システム設定ファイルは両方より優先されます。環境変数とコマンドライン引数はすべてのファイルより優先されます。
OpenCode：ファイルは置き換えではなくマージされます。後のソースが前のソースを上書きするのは競合するキーだけで、プロジェクト設定はグローバル設定の後に読み込まれます。
Amp：ワークスペース設定がユーザー設定より優先されます。
Cursor の permissions.json：ユーザーとプロジェクトのファイルは結合され、配列は連結されます。
Factory Droid：同じ階層の settings.json の上に settings.local.json がマージされます。

考え方は同じ、構文は異なる

Claude Code：.claude/settings.json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": ["Bash(npm run test *)"],
    "deny": ["Read(./.env)"]
  }
}

Codex：~/.codex/config.toml

model_reasoning_effort = "medium"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

Gemini CLI：.gemini/settings.json

{
  "general": {
    "defaultApprovalMode": "auto_edit"
  },
  "tools": {
    "sandbox": "docker"
  }
}

OpenCode：opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "ask",
    "bash": { "*": "ask", "git *": "allow" }
  }
}

Cursor：.cursor/permissions.json

{
  "terminalAllowlist": ["git", "npm", "pnpm"],
  "mcpAllowlist": ["github:*"]
}

注意点

Claude Code の設定ファイルは厳密な JSON です。コメントや末尾のカンマは構文エラーになります。
プロジェクトの .codex/config.toml では、provider、auth、notification、profile、telemetry のキーを設定できません。これらは ~/.codex/config.toml に書きます。
Gemini CLI の設定は、general、ui、model、tools などのカテゴリオブジェクトの中に置く必要があります。YOLO mode はファイルでは設定できず、--yolo または --approval-mode=yolo でのみ有効にできます。
共有ファイル（.claude/settings.json、.cursor/permissions.json、opencode.json）はコミットし、個人用ファイル（.claude/settings.local.json、Droid の settings.local.json）は git に含めないでください。

エージェント別の完全な設定ガイド

出典

このガイドで確認した公式ドキュメント（英語）です。英語版の確認日: 2026-10-18

Claude Code: Settings files and precedence Cursor Docs: Permissions reference Cursor Docs: CLI configuration OpenAI: Codex config basics Gemini CLI: Configuration Qwen Code: Settings OpenCode: Config Amp: CLI settings Factory: Droid CLI settings

クイックアンサー：ユーザー設定とプロジェクト設定のファイル

どのファイルが優先されるか

考え方は同じ、構文は異なる

注意点

エージェント別の完全な設定ガイド

出典

その他の日本語ガイド