Universal Modder + Claude Code：完全セットアップ

なぜ Claude Code が基準のエージェントなのか

作者は実際の Claude Code のセッションをもとにこのツールキットを作り、リポジトリには Claude 専用の設定が入っています。プラグインのマーケットプレイス（.claude-plugin/）、.claude/skills にコピーされたスキル、.mcp.json の fal MCP サーバー、そしてセッションの開始・再開のたびに um CLI を PATH に入れる SessionStart フックです。ほかのエージェントでも動きますが（マルチエージェントのインストールガイド参照）、いちばんテストされているのは Claude Code です。

1. Claude Code をインストール

claude --version がすでに動くなら飛ばしてください。

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

次に MOD 用の作業フォルダ（例：~/mods や C:\mods）を作り、その中で claude を実行してサインインします。Claude Pro・Max・Team・Enterprise プラン、または API 課金の Console アカウントが必要です。何かおかしければ claude doctor を実行してください。

ツールキットに必要な Git、Python 3.10+、ffmpeg、uv も入れておきます（1 行でインストール）。

2. Universal Modder プラグインを追加

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

• どのプロジェクトフォルダでも使えるよう user スコープを選びます。
• Claude Code に求められたら /reload-plugins を実行するか、セッションを再起動します。
• シェル派なら、claude plugin marketplace add … と claude plugin install … でも同じです。
• SSH エラーが出たらトラブルシューティングへ。

プラグインで入るもの

3. fal を接続してアート・3D・サウンドを生成

fal MCP サーバーは、Claude Code を起動した環境の FAL_KEY を読みます。fal.ai/dashboard/keys でキーを作り、設定して claude を再起動します。

export FAL_KEY="your-key"     # macOS / Linux / WSL
setx FAL_KEY "your-key"       # Windows（その後、新しいターミナルを開く）

Claude Code 内で /mcp を実行し、fal サーバーが接続済みになっていれば OK です。アセットごとの料金は費用のページへ。

スキルの呼び出し方

スキル名を指定する必要はほとんどありません。「Stardew Valley の MOD を…」のような依頼で mod-any-game が読み込まれ、必要に応じてほかのスキルも使います。特定のスキルを使わせたいときはスラッシュコマンドで：

各スキルの中身 →

効くプロンプト

良いプロンプトには、ゲーム名、具体的なゴール 1 つ、そして何をもって「完成」とするかが入っています。README の例：

Terraria の MOD を作って：追尾ミサイルランチャーと、地形に大穴をあける戦術核を追加。スプライトは fal で作って。

エイジ オブ エンパイア II に、3D からレンダリングした固有ユニットを持つ新しい文明を作って。

本物の Minecraft を GTA V のストーリーモードに入れて。Minecraft のカメラは GTA のカメラに追従し、TNT で GTA の車が爆発するように。

C:\Games\Foo はどのエンジン？ 誰かが MOD したことはある？

トークンとお金を節約するコツ：

• まず調査、次に作業。変更の前に計画を頼むと MODDING_PLAN.md を書きます。
• 1 つずつ。動く武器 1 つは、作りかけの武器 10 個に勝ります。
• fal の前に仮素材。仕組みがゲーム内で動いてから本番のアートを生成します。
• 料金を聞く。「3D モデルを作る前に um fal price で確認して」。
• テスト中は触らない。ゲーム操作や録画の間は PC を使わないでください。

長いプロジェクトとコンテキストの上限

スキルは MODLOG.md に作業記録（パス、ID、フォーマット、失敗したこと、次の一手）を残すので、Claude Code が会話を圧縮しても大事な情報は失われません。新しいセッションはこう始めます：

MODLOG.md と MODDING_PLAN.md を読んで、次のステップから続けて。

MOD が動いたら、share-field-notes スキルでフィールドノートを書かせましょう。共有ナレッジベースへの PR は、あなたが OK するまで作られません。

Claude Code がこれで作ったもの

• Age of Empires II: Definitive Edition: San Franciscans: a new civilization for Age of Empires II DE with units rendered from 3D
• Baldur's Gate 3: Act 2 never loads (hang at 50% or crash): one modded NPC on a bad level layer, found by bisecting a pak
• Baldur's Gate 3: A generated wardrobe mod: 260 clothing mods sorted by race and body type into containers summoned by reusable scrolls
• Baldur's Gate 3: Custom outfits from cloned mod and vanilla meshes: visuals, materials, body masks, cloth, LODs, icons and the Blender GR2 round trip
• Baldur's Gate 3: Gameplay and compatibility patches in stats and Osiris: level-gated armour tiers, Extra Attack on a modded cantrip, crit immunity, stacking damage reduction, feats from items, removing equipment glow, a class vs starting-equipment fix
• Baldur's Gate 3: Running a 500+ mod load order by hand: modsettings.lsx rules, recovering a wiped order from a save, mod.io re-subscribes, game-folder files and conflict diagnosis
• Baldur's Gate 3: Weapons: porting a Skyrim dagger and scabbard, fixing a modded sword's sheath height with a Dummy_Sheath bone, and visible stowed shields for modded shields
• Borderlands 2: BL3 weapons and movement in Borderlands 2 (Willow2 SDK mods)
• Darkest Dungeon: A seeded randomizer (trinkets, heroes, monsters, curios, quirks, quests) as a Darkest Dungeon data mod
• Dragon's Dogma 2: Blink Strike teleports behind the target (REFramework Lua skill rework)
• Dragon's Dogma 2: Dimension Door: aimed teleport spell with a scripted arrival camera (REFramework Lua)
• Elden Ring: CS2 conversion of Elden Ring offline: native Rust DLL via me3 (fall death, spirit springs, 3D inspect, params)

すべてのゲームを見る →