先說結論:3個步驟

Codex 的 Unity 外掛適合這樣的 Unity 6 工程:希望 Codex 按當前的 API 寫程式碼,而不是按十年積累下來的論壇答案寫。外掛由 Unity 以自己的名義釋出,裡面 31 個 Skill 都由負責對應功能的 Unity 團隊編寫。從 Codex 的外掛目錄安裝,或者用兩條命令安裝,然後在編輯器裡批准 MCP 連線,之後提需求時指定 Skill 的名字。需要 Unity 6 或更高版本。

步驟 1:找到外掛並安裝

兩條路徑,裝到的是同一個外掛。

在 Codex 的側邊欄開啟 Plugins(外掛),搜尋 Unity,從 Unity Technologies 名義釋出的目錄條目安裝。

Codex 的 Unity 外掛頁面,列出 31 個 Skill,包括 2d Pixel Perfect、Audio Setup Mixers、Build Live Game

從終端裝,同樣是兩條命令:

codex plugin marketplace add Unity-Technologies/unity-agent-plugin
codex plugin add unity@unity-agent-plugin

倉庫是 Unity-Technologies/unity-agent-plugin,許可證為 Unity Companion License。Claude Code 從同一個倉庫安裝,命令是 /plugin install unity@unity-agent-plugin。

它不是 Asset Store 的資源包,編輯器裡的 Package Manager(包管理器)找不到它。當前版本是 0.1.6-beta,後續更新通過 codex plugin marketplace upgrade unity-agent-plugin 獲取,不需要在機器之間複製檔案,也不需要為每個工程單獨配置。

新開一個 Codex 會話,輸入 /unity:,可以確認 Skill 列表是否已經載入。

步驟 2:在編輯器裡批准 MCP 連線

先把 Unity 6 工程開啟。下面這些操作都發生在正在執行的編輯器上。

在 Unity 裡開啟 Edit(編輯)→ Project Settings(專案設定)→ AI → Unity MCP,確認 Bridge 顯示為 Running。Codex 發來的第一個請求會落在 Pending Connections 裡,一直等到在編輯器裡點 Accept 才會放行。傳輸走本地 IPC,工程原始碼不會離開本機。

有兩個面板容易混。官方外掛用的是 Unity 編輯器內建的 MCP Bridge。這個站點另外介紹的 Unity MCP 是獨立的服務視窗,跑在 6594 埠,帶 Cursor 和 Codex 的一鍵配置。兩者都在本地執行,但不是同一個面板。通道本身怎麼工作,見 MCP 怎樣把 AI 程式設計工具接到遊戲引擎上。

連線批准之後,當前場景、GameObject 和 Console 日誌都可以在會話裡讀取和修改。

步驟 3:提需求時指定 Skill

Skill 以斜槓命令的形式按名字呼叫。如果只說「做一個設定介面」而不指定 Skill,用哪套 UI 框架就沒有定下來。uGUI 的工程裡被寫進 UI Toolkit 的程式碼、後面還要拆掉重來,多半是這麼來的。

先交給路由,讓它判斷工程的情況:

/ui 做一個設定介面,帶音量滑塊和返回按鈕

/ui 會先讀這個工程在用哪套 UI 系統,再轉給 /ui-uitk、/ui-ugui 或 /ui-imgui。其他領域同理:從 Built-in 遷移到 URP 用 /migrate-birp-to-urp,圖集打包用 /manage-sprite-atlas,CJK 文字顯示成方塊用 /optimize-text-mesh-pro,Unity IAP 用 /implement-in-app-purchases。

31 個 Skill 按用途分組的完整介紹:Codex 中的 Unity Skills 詳細介紹。

Unity CLI 和這個外掛不是一回事

這個問題被問得夠多,直接寫清楚。

Unity CLI 是一個介面。它從終端觸達引擎,負責安裝 Editor、建立和開啟工程、管理包和許可證、執行構建與測試、讀取日誌。AI 也好,人也好,都可以呼叫它。Unity 在 Unite Seoul 就釋出了 CLI,比兩個外掛都早。

外掛給出的是一套指引。每個 Skill 描述的是「這件 Unity 的活本來該怎麼做」,所以 Codex 會先看工程、用當前的 API、驗證結果之後再返回。沒有這套指引時,通用程式設計工具只能按網上關於 Unity 的所有內容取一個平均值來回答,而那裡面很大一部分是針對早就不再釋出的引擎版本寫的。

兩者在外掛內部交匯:unity-cli 本身就是 31 個 Skill 中的一個,專門教 Codex 怎麼使用 CLI。裝了外掛不等於可以不用 CLI,用了 CLI 也不等於 AI 就拿到了 Unity 對這件活的指引。

兩者之外還剩什麼

Skill 覆蓋的是工程開啟之後程式碼怎麼寫。批次化處理生成出來的 UI 美術資源——把一張合成圖按檢測到的邊緣切開,匯出有意義命名的圖片檔案,寫進 Assets/Textures 和 Assets/Prefabs,並且保留和同步原圖層的上下文資訊——發生在這之前,不在 Skill 列表裡。見 Unity 的 Codex 外掛:31 個 Skill 覆蓋了什麼,又留下了什麼。