# Codex 的 Unity 官方外掛：安裝、連線、呼叫 Skill

Unity 官方 Codex 外掛在哪裡找、怎麼從外掛目錄或兩條命令安裝、如何在開啟的 Unity 6 編輯器裡通過 MCP 批准連線，以及 Unity CLI 和這個外掛的區別。

## 先說結論：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](/images/codex/codex-unity-plugin-skills.webp)

從終端裝，同樣是兩條命令：

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

倉庫是 [Unity-Technologies/unity-agent-plugin](https://github.com/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](/docs/mcp/unity-mcp/) 是獨立的服務視窗，跑在 `6594` 埠，帶 Cursor 和 Codex 的一鍵配置。兩者都在本地執行，但不是同一個面板。通道本身怎麼工作，見 [MCP 怎樣把 AI 程式設計工具接到遊戲引擎上](/docs/mcp/what-is-mcp/)。

連線批准之後，當前場景、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 詳細介紹](/exp/codex-unity-skills-overview/)。

## 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 覆蓋了什麼，又留下了什麼](/exp/unity-codex-plugin-mcp-skills-and-ui-asset-gap/)。