AI コーディングエージェント設定ガイド（日本語）

主要なコーディングエージェントには 2 つの手段があります。完全な自動承認スイッチ（Cursor の Run Everything、Claude Code の --dangerously-skip-permissions、Codex・Gemini CLI・Copilot CLI の --yolo、Cline の YOLO Mode）と、信頼するコマンドだけを事前承認するスコープ付き allowlist です。安全なデフォルトは allowlist です。完全スイッチはコンテナ、VM、使い捨てプロジェクトに限って使いましょう。

Cursor は .cursor/rules 内の .mdc ファイルと AGENTS.md を読み込みます。Claude Code は CLAUDE.md を読み込み、CLAUDE.md がない場合は AGENTS.md にフォールバックします。Codex、Amp、Kiro、Junie は AGENTS.md をネイティブに読み込みます。Gemini CLI は GEMINI.md を読み込み、context.fileName で AGENTS.md を指定できます。GitHub Copilot は .github/copilot-instructions.md、.github/instructions/*.instructions.md、AGENTS.md を読み込みます。Cline は .clinerules/ を読み込み、.cursorrules、.windsurfrules、AGENTS.md も検出します。リポジトリのルートに AGENTS.md を 1 つ置けば、ほとんどのエージェントをカバーできます。

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 に保存します。どのツールでも、プロジェクトのファイルがユーザーのファイルより優先されます。

ほとんどのエージェントは mcpServers オブジェクトを持つ JSON ファイルを読み込みます。Cursor は .cursor/mcp.json、Claude Code は .mcp.json、Kiro は .kiro/settings/mcp.json、Factory Droid は .factory/mcp.json、Junie は .junie/mcp/mcp.json です。例外は VS Code（.vscode/mcp.json の servers キー）、Codex（~/.codex/config.toml の [mcp_servers.NAME] テーブル）、OpenCode（opencode.json の mcp キー）、Zed（設定の context_servers）、goose（config.yaml の extensions）です。Claude Code、Codex、Gemini CLI、Amp、Factory Droid には mcp add コマンドもあります。

Claude Code は .claude/settings.json の hooks ブロック、Gemini CLI は .gemini/settings.json の hooks ブロックを読み込みます。Cursor は .cursor/hooks.json、Factory Droid は .factory/hooks.json、GitHub Copilot は .github/hooks/*.json、Kiro は .kiro/hooks/ 内の任意の JSON ファイルを読み込みます。どれもイベントを JSON として stdin 経由でスクリプトに渡します。ツール呼び出しをブロックするには、Claude Code、Cursor、Gemini CLI、Factory Droid、Kiro CLI では終了コード 2 で終了するか、deny の判定を JSON で出力します（Copilot は permissionDecision、Cursor は permission を使います）。

これらのエージェントはすべて、name と description を含む YAML frontmatter を持つ SKILL.md ファイルのフォルダを読み込みます。Claude Code は .claude/skills/ と ~/.claude/skills/ を使います。Codex、Amp、OpenHands はリポジトリの .agents/skills/ と個人用の ~/.agents/skills/ を使います。Cline は .cline/skills/ と ~/.cline/skills/ を使い、.claude/skills/ も読み込みます。Amp も .claude/skills/ を読み込みます。つまり、.agents/skills/ の skill で Codex、Amp、OpenHands を、.claude/skills/ のコピーで Claude Code、Cline、Amp をカバーできます。

Claude Code はすべてのツール呼び出しを settings ファイル内の権限ルールと照合します。ルールは permissions.allow、permissions.ask、permissions.deny に記述し、Tool または Tool(specifier) の形式を使います。評価順は deny、ask、allow の順です。/permissions を使うと、すべてのルールとその定義元ファイルを確認できます。1 セッションだけなら --allowedTools と --disallowedTools を渡します。

Shift+Tab で権限モードを切り替えるか、claude --permission-mode <mode> で起動するか、.claude/settings.json に Bash(npm run *) のような permissions.allow ルールを書いて特定のコマンドを事前承認します。Auto モードは、分類器がアクションをレビューする間、通常の確認なしで実行します。--dangerously-skip-permissions はコンテナや VM 専用です。

Settings > Agents > Approvals & Execution を開き、Run Mode を選びます。Run Everything は sandbox もレビューもなしで、すべてのツール呼び出しを自動実行します。Allowlist は列挙したコマンドだけを実行します。Auto-review は allowlist にある呼び出しを即座に実行し、その他のシェルコマンドは可能な場合 sandbox に送ります。

リポジトリの .cursor/rules フォルダに .mdc ファイルを作成し、それぞれの frontmatter で description、globs、alwaysApply を設定します。最も手早いのは、Agent チャットで /create-rule と入力する方法です。メタデータなしのプレーンな Markdown を使う場合は、代わりに AGENTS.md ファイルを使います。

リモートサーバーには claude mcp add --transport http NAME URL を、ローカルの stdio サーバーには claude mcp add [options] NAME -- COMMAND [args] を実行します。サーバーはデフォルトで local スコープに保存されるため、自分だけが現在のプロジェクトでのみ使えます。共有の .mcp.json に書き込むには --scope project を、すべてのプロジェクトで使えるようにするには --scope user を使います。

5 つのツールはいずれも、ファイルでカスタムエージェントを定義できます。Claude Code、Cursor、Gemini CLI、Copilot は YAML frontmatter 付きの Markdown を使い、Codex は単独の TOML ファイルを使います。各ツールには組み込みのサブエージェントがあります。例えば Claude Code の Explore、Codex の explorer、Cursor と Copilot の explore、Gemini CLI の codebase_investigator です。Claude Code、Cursor、Gemini CLI、Copilot は description をもとに自らエージェントを選べます。Codex では直接サブエージェントを依頼するか、AGENTS.md やスキルの指示で要求します。ツール間の違いが最も大きいのは、ツール制限、モデル選択、バックグラウンド・並列実行の仕組みです。