AIアシスタントと Modoki を使う

Modoki は手作業だけでなく、AIコーディングアシスタントによる操作も前提に設計されています。 ゲームロジックは注入可能なクロック、シード付きRNG、そしてティック単位でタイムスタンプが付く イベントジャーナルの上で動作するため、AIエージェントはスクリーンショットではなくデータによって、 ロジックを ヘッドレスかつ決定論的に 検証できます。これは特定のアシスタントに限った話では ありません。Modoki のプロジェクトには、Claude Code・Cursor・Codex CLI・ Antigravity CLI のいずれもが自動的に読み込む指示ファイルが、あらかじめ同梱されています。 実行中のエディタへのライブな MCP（Model Context Protocol）ツールアクセス — シーンの検査・ 変更・スクリーンショット取得 — はまた別の話です。今日の時点で何が自動化されていて、何を 自分で配線する必要があるかは、下記のツールごとの説明を参照してください。

Claude Desktop には3つのタブがあり、どれを使うかで得られるものが変わります。Code タブは Claude Code そのものです — 同じ CLAUDE.md、同じ .mcp.json の接続フロー、modoki_* ツールへの フルアクセスまで揃っており、ターミナルの代わりに GUI（チャット・差分・ターミナル・ファイルの 各ペイン）を使うだけです。Claude Desktop を持っているなら、ターミナルを開く必要はありません。 Cowork（プロジェクトフォルダ機能）もプロジェクトの CLAUDE.md を自動的に読み込みますが、 実行中のエディタの MCP ツールには届きません。素の Chat はどちらも読み込まず、ツールアクセス には MCP サーバーを自分で配線する必要があります。3つすべての詳細は下記の Claude Desktop を参照してください。

プロジェクトに同梱されるもの、されないもの

ファイル	読み込むツール	いつ手に入るか
CLAUDE.md	Claude Code	新規プロジェクトに最初から同梱
AGENTS.md	Cursor、Codex CLI、Antigravity CLI	新規プロジェクトに最初から同梱
.mcp.json	Claude Code	エディタの AI → Connect Claude Code がプロジェクトに書き出す — 最初から入っているわけではない
.cursor/mcp.json	Cursor	自動接続の仕組みはまだなし — 自分で作成する（下記参照）
.codex/config.toml	Codex CLI	自動接続の仕組みはまだなし — 自分で作成する（下記参照）
mcp_config.json	Antigravity CLI	自動接続の仕組みはまだなし — 自分で作成する（下記参照）
.mcp.json / CLAUDE.md	Claude Desktop の Code タブ	Claude Code と同じ（実体が Claude Code のため）— 上記参照
CLAUDE.md	Claude Desktop の Cowork タブ	Cowork プロジェクトをそのフォルダに向けると自動的に読み込まれる — 何も書く必要なし
claude_desktop_config.json	Claude Desktop の Chat タブ	自動接続の仕組みはなく、プロジェクトごとではなく端末に1つの グローバル な設定ファイル — 自分で作成する（下記参照）

CLAUDE.md と AGENTS.md には同じプロジェクト指示が書かれており、すべてのツールが自動的に 手に入れられるのはこの2つだけです — 新規作成した File → New Project には最初から両方 含まれています。MCP ツールへのアクセス（シーンの検査・変更・スクリーンショット取得）は 別の話です。 現時点でワンクリックの「Connect」フローがあるのは Claude Code だけで （エディタの AI パネルにある AI → Connect Claude Code）、これが開いているプロジェクトに 機種固有の正しい .mcp.json を書き出します。Cursor・Codex CLI・Antigravity CLI には まだ同等の仕組みがありません — コードや指示ファイルまわりは問題なく使えます（実際 Antigravity は MCP 設定なしで AGENTS.md だけから動く 3D ゲームを構築できました）が、 MCP ツールへのアクセスも使いたい場合は、現状では自分で配線する必要があります。

Claude Code

プロジェクトフォルダを Claude Code で開き、エディタの AI パネルで AI → Connect Claude Code を実行してください — .mcp.json が書き出されます。CLAUDE.md はどちらにせよ自動的に 読み込まれます。

Claude Desktop を持っているなら、これはその Code タブでも同じです — ターミナルは不要 です。プロジェクトフォルダをそこで開けば、このページの内容（Connect Claude Code、CLAUDE.md、 modoki_* ツール）はすべて同じように動きます。Code タブは GUI をまとった Claude Code そのもの だからです。

Cursor

プロジェクトフォルダを Cursor で開いてください。プロジェクトの指示として AGENTS.md を 自動的に読み込みます。MCP ツールについては .cursor/mcp.json を自分で作成してください — 上記の手順で一度 Claude Code を接続したあと、その .mcp.json の内容を .cursor/mcp.json にコピーすればOKです（同じ mcpServers の JSON 形式です）。すべてのプロジェクトで一度だけ 設定したい場合は、グローバルな ~/.cursor/mcp.json も利用できます。

Codex CLI

プロジェクトのルートで codex を実行してください。指示としての AGENTS.md は自動的に 読み込まれます。MCP ツールについては、プロジェクト側の .codex/config.toml を自分で作成し、 .mcp.json の command・args・env を [mcp_servers.modoki] テーブルの下にそのまま 書き写してください（Codex はグローバルな ~/.codex/config.toml にも対応しています）。

Codex は信頼していないプロジェクトのMCPを黙って読み込まない

Codex CLI はプロジェクト側の .codex/config.toml を初めて見つけたとき、そのディレクトリを 信頼するかどうかの確認が必要です — このプロンプトに答えるまで、そこに定義された MCP サーバーは エラーも出さずにただ読み込まれません。Codex から MCP ツールが「見えない」ときは、まずこれを 疑ってください。

Antigravity CLI

Antigravity CLI（Google の Gemini CLI の後継）は、Cursor や Codex と同様に、プロジェクトの 指示として AGENTS.md を自動的に読み込みます。MCP サーバー設定の形式（mcp_config.json）は まだ新しく仕様が固まりきっていないため、自動接続もコピー元となるテンプレートもまだありません。 .mcp.json 内のサーバー定義（コマンド・引数・環境変数）を参考にしながら、Claude Code が 使っているものと同じサーバーを手動で設定してください。

Claude Desktop

Claude Desktop には3つのタブがあり、どれを使うかで得られるものが変わります。Claude Desktop を 持っているなら、まず Code タブを使ってください — ターミナルなしで完全なループに入れる、 いちばん簡単な方法です。

Code（推奨）

Code タブの実体は Claude Code で、ターミナルの代わりに GUI（チャット・差分・ターミナル・ ファイルの各ペイン）で動いています。上の Claude Code セクションと何も変わりません — Code タブでプロジェクトフォルダを開き、エディタ側で一度 AI → Connect Claude Code を実行 すれば、CLAUDE.md の自動読み込み、.mcp.json の書き出し、実行中のエディタに対する modoki_* ツールへのフルアクセス（シーンの検査・変更・スクリーンショット取得）がすべて手に入り ます。Claude Desktop を持っていてターミナルを開きたくない人には、これが推奨ルートです。

Cowork

Cowork は、より長く広い範囲のエージェント作業向けの、Claude Desktop のプロジェクトフォルダ 機能です。Cowork プロジェクトを作成して Use an existing folder（既存のフォルダを使う）を 選び、Modoki のプロジェクトを指定してください — Cowork は作業を始める前に、そのフォルダの CLAUDE.md を自動的に読み込みます。Modoki が最初から同梱しているのと同じファイルなので、 新たに書くものはありません。ただしギャップがあります。Cowork は実行中のエディタには届きません。 対応しているのは Claude アカウント経由でブローカーされるリモートコネクタのみで、ローカルの MCP サーバーには対応していないため、modoki_* ツール（シーンの状態・変更・スクリーンショット）は そこでは使えません — プロジェクトファイル（ゲームコード、シーン JSON、設定）の読み書きはできますが、 Claude Code や Code タブのように、実行中のエディタに対して検証することはできません。

Chat

素の Chat にはプロジェクトフォルダという概念がなく、CLAUDE.md/AGENTS.md も読み込まず、 ディスク上のファイルを編集することもできません。できるのは、他のツールと同じ modoki MCP サーバーと会話し、実行中のエディタをチャット経由で検査・操作することです。

1. Modoki でプロジェクトを開き、一度 AI → Connect Claude Code を実行します — これで プロジェクトに機種固有の正しい .mcp.json（エディタのポート、環境によってはトークンも 含む）が書き出されます。ここからコピーします。
2. Claude Desktop の設定ファイルを開きます。
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. プロジェクトの .mcp.json にある mcpServers.modoki の内容を、Claude Desktop の設定の mcpServers の下にコピーします（これはグローバルなファイルなので、この方法で接続した すべてのプロジェクトがこの1つの設定を共有し、最後にコピーしたものが有効になります）。
4. Claude Desktop を再起動します。modoki_* ツールが使えるようになります。接続を保つには Modoki エディタを開いたまま実行しておく必要があります。

プロジェクトごとではなくグローバル

プロジェクトフォルダの .mcp.json とは異なり、claude_desktop_config.json は端末全体で 1つのファイルです。別のプロジェクトの .mcp.json から内容をコピーし直すと、Chat タブは そのプロジェクトのエディタを指すようになります。

指示ファイルを自分で編集したい場合

AGENTS.md は CLAUDE.md から生成されるファイルです。次回の再生成で上書きされてしまうため、 AGENTS.md を直接編集しないでください。編集する際は CLAUDE.md の方を変更してください。