10 月 18 日,Epic 那個能讓 Claude Code 直接操作 Unreal 編輯器的外掛在 X 上洗版,不少貼文說它是剛發布的。其實不是。Epic 6 月就把這個外掛放上 GitHub,Anthropic 官方的 Claude Code 外掛市集在北京時間 6 月 27 日收錄了它,最近一次更新在 9 月。下面的步驟都依 Epic 的 README 和文件撰寫,我們自己沒有實際裝過。
這個外掛把 Claude Code 連到 Unreal MCP,Unreal MCP 是跑在 Unreal 編輯器裡的一個服務。依 Epic 的說法,它提供 30 多個工具集、幾百個編輯器工具,涵蓋 Actor、藍圖、材質、Niagara、Sequencer、State Tree、UMG 元件、Gameplay Ability System 和自動化測試等。Epic 的文件把 Unreal MCP 標為實驗性功能,提醒很多部分還不完整,之後也可能會變。
第一步:在 Claude Code 裡裝外掛
外掛在 claude-plugins-official 這個市集裡,Claude Code 啟動時會自動載入它。在 Claude Code 裡執行「/plugin install unreal-engine-skills-for-claude-code@claude-plugins-official」。如果看不到官方市集,先執行「/plugin marketplace add anthropics/claude-plugins-official」把它加上,再執行一次安裝指令。也可以在 /plugin 面板的 Discover 分頁裡找到它。
團隊一起用的話,Epic 建議把外掛加進專案 .claude/settings.json 裡的 enabledPlugins。誰信任了這個專案資料夾,就會收到安裝提示。
第二步:在編輯器裡開啟 Unreal MCP
在 Unreal 編輯器裡打開 Edit 選單下的 Plugins,把 Unreal MCP 和 All Toolsets 都勾起來,依提示重新啟動編輯器。兩個都要開。Unreal MCP 是服務本身,實際的工具由 All Toolsets 提供,不開它的話服務裡什麼工具都沒有。
第三步:啟動服務
打開編輯器的主控台(預設按反引號鍵打開),輸入「ModelContextProtocol.StartServer」。服務會在本機的 8000 埠、/mcp 路徑上監聽。埠被占用的話,在指令後面加一個別的埠號。想讓它每次自動啟動,就到 Editor Preferences 的 General 裡找到 Model Context Protocol,打開 Auto Start Server。
第四步:產生連線檔案
外掛本身不附 MCP 設定檔。在編輯器主控台輸入「ModelContextProtocol.GenerateClientConfig ClaudeCode」,它會在專案根目錄寫一個 .mcp.json,指向正在執行的服務。之後改了埠或路徑,再執行一次就好。
第五步:在專案根目錄啟動 Claude Code,確認連上了
等編輯器和服務都跑起來,再從寫了 .mcp.json 的那個資料夾啟動 Claude Code。Epic 建議確認三件事:編輯器的 Output Log 裡有 MCP 服務啟動的訊息;Claude Code 裡 /plugin 的 Installed 分頁顯示外掛已啟用;/mcp 裡看得到 unreal-mcp。然後試一句簡單的,例如「List all actors in the current level」。
如果 Claude Code 找不到服務,Epic 的文件建議先確認是不是在有 .mcp.json 的資料夾裡啟動的,再試試先開編輯器後開 Claude Code,或者重新連線 MCP 服務。
Windows 要裝 Git Bash 或 WSL
外掛附了一個啟動鉤子,是個 bash 腳本,作用是告訴 Claude 這個資料夾是 Unreal 專案,照 Unreal 的規矩來。macOS 和 Linux 直接就能用。Windows 上要裝 Git for Windows(內含 Git Bash),或者在 WSL 裡跑 Claude Code。只用 PowerShell 的話這個鉤子跑不起來。依 README 的說法,這種情況下編輯器工具照樣能用,只是每次開工作階段時少了那段專案說明。
注意 Claude 能碰到什麼
Epic 的 README 把風險寫得很直白。裝上外掛,Claude 就能大範圍、即時地操作正在執行的編輯器,其中一個工具還能在編輯器裡執行任意 Python 腳本,對專案有完整的存取權限。Epic 建議載入這個外掛時不要用 Claude Code 的 --dangerously-skip-permissions 參數,長時間操作前先存檔並提交,出了意外改動也能退回去。服務只接受本機的連線,但 Epic 提醒它沒有自己的登入驗證,同一個使用者下執行的任何程式都能連上,所以別在共用或不信任的電腦上開。
