# Unity — AI Game Developer

為 Unity 6 安裝 AI Game Developer 外掛。兩種安裝方式 — unity-mcp-cli 與 .unitypackage 安裝程式 — 以及如何連接你的 AI 用戶端並執行第一個提示詞。

本頁面由英文機器翻譯而成。[閱讀英文原文](https://ai-game.dev/engines/unity)。

引擎 · Unity

將 AI Game Developer 外掛放進你的 Unity 專案，就能用 AI 操作編輯器。

Unity 2022.3 LTS Unity 2023 Unity 6 (6000.x) 任何 2022.3+ 版本

01

## 安裝外掛

有兩種方式可將外掛加入你的專案 — 挑選最適合你工作流程的一種。

推薦

### CLI

透過 unity-mcp-cli 工具安裝。不必手動下載任何東西——在終端機執行這些命令即可。

1 安裝 CLI

從 npm 全域安裝 unity-mcp-cli。

`npm install -g unity-mcp-cli`

2 安裝 Unity （選填）

使用 CLI 安裝 Unity 編輯器。若已安裝則可略過。

`unity-mcp-cli install-unity 6000.3.9f1`

3 建立 Unity 專案 （選填）

建立新的 Unity 專案，或使用現有專案。

`unity-mcp-cli create-project ./MyUnityProject`

4 安裝外掛

將 Unity MCP 套件安裝到你的專案中。

`unity-mcp-cli install-plugin ./MyUnityProject`

5 開啟 Unity 專案

在 Unity 編輯器中開啟專案。

`unity-mcp-cli open ./MyUnityProject`

### 安裝程式

下載 .unitypackage 安裝程式並直接匯入你的 Unity 專案——一次性完成安裝。

[下載 .unitypackage](https://github.com/IvanMurzak/Unity-MCP/releases/latest/download/AI-Game-Dev-Installer.unitypackage)

1 安裝 Unity （選填）

下載 [Unity Hub](https://unity.com/download)，並安裝任何 Unity 2022.3 LTS 或更新版本的編輯器。若已安裝則可略過。

2 建立 Unity 專案 （選填）

使用 Unity Hub 建立新的 Unity 專案，或使用現有專案。

3 下載安裝程式

使用上方的 **下載 .unitypackage** 按鈕取得 `AI-Game-Dev-Installer.unitypackage`。

4 匯入套件

在 Unity 中：**Assets → Import Package → Custom Package…**，然後選擇已下載的檔案。

偏好使用套件註冊表嗎？改透過 OpenUPM 加入：`openupm add com.ivanmurzak.unity.mcp`。如需完整深入說明，請參閱[Unity 外掛設定指南](https://ai-game.dev/docs/unity-plugin-setup)。

02

## 連接

透過託管的雲端端點執行，或指向你自己的伺服器。

### 雲端

預設

使用裝置碼 OAuth 流程透過 **ai-game.dev** 連接 — 不必手動複製權杖。在 AI Game Developer 視窗中選擇 **Cloud**，點擊 **Authorize**，並在瀏覽器中核准裝置碼。可穿越防火牆運作，並提供使用情形分析。這是預設方式，也是我們對大多數使用者的建議。

### 自訂

想全部在本機執行？將外掛指向你自己的 `gamedev-mcp-server` 執行個體，而非託管端點。你的 AI 用戶端便會直接與你的機器通訊。各用戶端的設定片段請見 [MCP 端點頁面](https://ai-game.dev/mcp-endpoint-info)。

需要用戶端設定片段（Claude、Cursor、Copilot、Gemini 等）？[參閱 MCP 端點頁面 →](https://ai-game.dev/mcp-endpoint-info)

03

## 設定你的 AI 代理

選擇你使用的 AI 代理，並複製可將其連接至 Unity MCP 伺服器的 `unity-mcp-cli` 指令。

你的 AI 代理

**Claude Code**

在專案中執行以下指令，為 Unity 設定 **Claude Code**：

`unity-mcp-cli setup-mcp claude-code ./MyUnityProject`

**Claude Desktop**

在專案中執行以下指令，為 Unity 設定 **Claude Desktop**：

`unity-mcp-cli setup-mcp claude-desktop ./MyUnityProject`

**Cursor**

在專案中執行以下指令，為 Unity 設定 **Cursor**：

`unity-mcp-cli setup-mcp cursor ./MyUnityProject`

**VS Code (Copilot)**

在專案中執行以下指令，為 Unity 設定 **VS Code (Copilot)**：

`unity-mcp-cli setup-mcp vscode-copilot ./MyUnityProject`

**Visual Studio (Copilot)**

在專案中執行以下指令，為 Unity 設定 **Visual Studio (Copilot)**：

`unity-mcp-cli setup-mcp vs-copilot ./MyUnityProject`

**GitHub Copilot CLI**

在專案中執行以下指令，為 Unity 設定 **GitHub Copilot CLI**：

`unity-mcp-cli setup-mcp github-copilot-cli ./MyUnityProject`

**Codex**

在專案中執行以下指令，為 Unity 設定 **Codex**：

`unity-mcp-cli setup-mcp codex ./MyUnityProject`

**Gemini**

在專案中執行以下指令，為 Unity 設定 **Gemini**：

`unity-mcp-cli setup-mcp gemini ./MyUnityProject`

**Cline**

在專案中執行以下指令，為 Unity 設定 **Cline**：

`unity-mcp-cli setup-mcp cline ./MyUnityProject`

**Rider (Junie)**

在專案中執行以下指令，為 Unity 設定 **Rider (Junie)**：

`unity-mcp-cli setup-mcp rider-junie ./MyUnityProject`

**Kilo Code**

在專案中執行以下指令，為 Unity 設定 **Kilo Code**：

`unity-mcp-cli setup-mcp kilo-code ./MyUnityProject`

**Open Code**

在專案中執行以下指令，為 Unity 設定 **Open Code**：

`unity-mcp-cli setup-mcp open-code ./MyUnityProject`

**Antigravity**

在專案中執行以下指令，為 Unity 設定 **Antigravity**：

`unity-mcp-cli setup-mcp antigravity ./MyUnityProject`

**Unity AI**

在專案中執行以下指令，為 Unity 設定 **Unity AI**：

`unity-mcp-cli setup-mcp unity-ai ./MyUnityProject`

**設定完成後請重新啟動你的代理。**新的 MCP 伺服器只有在代理完全重新啟動後才會被載入 — 請完全結束再重新開啟（不只是重新載入視窗）。

04

## 首次執行

開啟視窗、完成授權，然後試試你的第一個提示詞。

1. 在 Unity 編輯器中開啟專案，然後前往 **Window → AI Game Developer**。
2. 在面板中選擇 **Cloud**，並點選 **Authorize** 以完成裝置代碼流程。
3. 等待狀態標籤顯示 **Ready**（綠色），然後連線你的 AI 用戶端。
4. 從你的 AI 用戶端試試下方這樣的提示詞，看看它在編輯器中如何動作。

範例提示詞

```text
建立一個包含方向光與旋轉立方體的新場景，然後進入 Play 模式。
```

想要更多範例提示詞，以及有效 AI 請求的模式嗎？[查看 Unity 最佳實務 →](https://ai-game.dev/docs/best-practices/unity)

[Unity 外掛會為你的 AI 用戶端提供 **72 項功能（21 個 MCP 工具 + RQL）**。](https://ai-game.dev/docs/tools/unity)

瀏覽 Unity 工具目錄 →

想要更多工具嗎？[瀏覽 Unity 擴充功能 →](https://ai-game.dev/docs/extensions/unity)

---

Source (HTML): https://ai-game.dev/zh-hant/engines/unity

Machine-translated (zh-Hant) from the English page: https://ai-game.dev/engines/unity