# 如何將 Claude Code 與 Unity 引擎搭配使用 — AI Game Dev

用 AI Game Developer 把 Claude Code 連接到 Unity 引擎。逐步說明：安裝、設定，以及第一次用 AI 檢視場景。

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

[部落格](https://ai-game.dev/zh-hant/blog)

用 AI Game Developer 把 Claude Code 連接到 Unity 引擎。逐步說明：安裝、設定，以及第一次用 AI 檢視場景。

Ivan Murzak · 2026年1月12日 · 閱讀時間 5 分鐘 ·

**更新於 2026年10月17日。** 從 Unity-MCP 1.0.0 起，代理程式改為透過 RQL（rql-query、rql-mutate、rql-schema）讀取與編輯場景、GameObjects、元件與資源，不再為每種操作各提供一個工具。下方的設定步驟維持不變，CLI 範例使用的是目前的工具名稱。詳見 ai-game.dev/docs/rql。

Claude Code 是目前最出色的 AI 代理程式之一，由 Opus 4.5 等模型驅動。在本教學中，我們將它直接連接到 Unity 引擎，讓它能讀取你的場景、呼叫 Unity API，並修改你的專案——全部都在終端機中完成。

## 你需要準備什麼

- Unity 2021.3 或更新版本
- Node.js ^20.19.0 或 >=22.12.0（供 CLI 使用）
- 已安裝 Claude Code（終端機形式的 AI 代理程式）
- AI Game Developer — AI 代理程式與 Unity 之間的橋樑：[github.com/IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP)

## 安裝 AI Game Developer

AI Game Developer 扮演先進 AI 代理程式與模型和 Unity 引擎之間的橋樑。你可以透過 Unity Editor 手動安裝，或使用 CLI 進行全自動設定。

### 選項 A：手動安裝（Unity Editor）

1. 從 AI Game Developer 的 GitHub 頁面下載安裝檔
2. 雙擊安裝檔，在 Unity 中開啟
3. 在 Unity 匯入視窗中點選「Import」
4. 等待 Unity 完成編譯

### 選項 B：CLI 安裝（建議）

unity-mcp-cli 工具可從命令列自動完成整個設定流程——完全不需要手動點擊。全域安裝後，就能用它把外掛加入任何 Unity 專案。

Bash 終端機

```bash
# Install the CLI globally
npm install -g unity-mcp-cli

# Install the AI Game Developer plugin into your Unity project
unity-mcp-cli install-plugin ./MyUnityProject
```

install-plugin 命令會直接修改專案的 Packages/manifest.json——它會加入 OpenUPM 範圍註冊表與此外掛相依性，且絕不會降級既有的安裝。執行完畢後，請在 Unity 中開啟該專案以完成套件安裝。

## 設定連線

套件匯入後，會出現 AI Game Developer 視窗。向下捲動找到 Claude Code 區段並點選「Configure」——這就是全部所需的設定。接著點選「Connect」開始連線流程。一開始你會看到錯誤，因為 Claude Code 還沒啟動——這是預期中的現象。

### CLI：為 Claude Code 設定 MCP

CLI 可以自動為 Claude Code 設定 MCP 整合——不需要 Unity Editor 介面。它會寫入正確的設定檔，讓 Claude Code 在啟動時找到 AI Game Developer 伺服器。

Bash 終端機

```bash
# Configure Claude Code MCP integration
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

# Generate skill files so Claude Code knows about available tools
unity-mcp-cli setup-skills claude-code ./MyUnityProject
```

## 啟動 Claude Code

你可以從 Visual Studio Code 啟動 Claude Code，或直接從終端機啟動。本教學採用終端機方式。請在 Unity 專案資料夾中開啟終端機——你可以在 Unity 的 Assets 資料夾上按右鍵，選擇「Show in Explorer」，接著再按右鍵並選擇「Open in Terminal」。

Bash 終端機

```bash
# Navigate to your Unity project folder and start Claude Code
cd /path/to/your/unity/project
claude
```

Claude Code 啟動後，AI Game Developer 視窗中的狀態會切換為「Connected」。若要確認一切正常，請在 Claude Code 中輸入 /mcp——你應該會看到「AI Game Developer」被列出且已連線。

## 在 Unity 場景中測試 AI

連線建立後，試著問 AI 像是「你在這個 Unity 專案的場景中看到什麼？」之類的問題。AI 會使用 AI Game Developer 提供的 MCP 工具讀取你的場景階層、檢視 GameObjects，並回報它的發現。它會一步步反覆進行——讀取場景資料、檢查巢狀物件，逐步拼湊出你專案的完整樣貌。

當 Claude Code 詢問是否允許使用某個工具時，你可以選擇選項 2 來允許，並略過之後對同一工具的重複詢問。接著 AI 會讀取你的場景，辨識出網格、燈光與巢狀階層等物件，並詳細描述它找到的所有內容。

## 最佳化上下文

AI Game Developer 會向 AI 揭露許多 MCP 工具。一個關鍵技巧：停用你不需要的工具。每個啟用的工具都會佔用 AI 上下文，讓上下文保持乾淨能讓 AI 更有效率地運作並產出更好的結果。你可以在 AI Game Developer 視窗中開關工具——或使用 CLI。

Bash 終端機

```bash
# List current tool/prompt/resource configuration
unity-mcp-cli configure ./MyUnityProject --list

# Enable only the tools you need
unity-mcp-cli configure ./MyUnityProject \
  --enable-tools rql-query,rql-mutate,rql-schema,script-update-or-create \
  --disable-all-prompts

# Or enable everything at once
unity-mcp-cli configure ./MyUnityProject \
  --enable-all-tools \
  --enable-all-prompts
```

- 停用你不使用的工具，讓 AI 上下文保持精簡
- 如果不需要 Resources，可以考慮將它停用
- Prompts 就是斜線命令——在 Claude Code 中輸入 / 即可看到可用命令，例如「設定動畫」或「新增元件」
- 查看 Connected 狀態指示器，確認連線仍在作用中

## 接下來你可以做什麼

當 Claude Code 連上 Unity 後，你可以要求 AI 執行 MCP 工具支援的任何事情——檢視場景、建立 GameObjects、修改元件、產生動畫、建立 UI 等等。AI 能存取一整套完整的工具，並可依據你的自然語言提示呼叫其中任何一個。

你也可以不經過 AI，直接從命令列執行 MCP 工具，這對腳本化與 CI 流程很有用。

Bash 終端機

```bash
# Check connection status at a glance
unity-mcp-cli status ./MyUnityProject

# Run an MCP tool directly from the CLI
unity-mcp-cli run-tool rql-query ./MyUnityProject --input '{"query":"objects | where name == \"Player\" | select $ref name transform.position"}'

# Run Unity tests via MCP
unity-mcp-cli run-tool tests-run ./MyUnityProject --input '{"testMode":"EditMode"}'
```

### 全自動化：從零到連線完成

CLI 可以自動化整個工作流程——建立專案、安裝外掛、設定 Claude Code、開啟 Unity、等待連線，然後執行工具。以下是一個從零開始完成所有設定的完整腳本。

Bash full-setup.sh

```bash
# 1. Create a new Unity project
unity-mcp-cli create-project ./MyAIGame --unity 6000.3.1f1

# 2. Install the AI Game Developer plugin
unity-mcp-cli install-plugin ./MyAIGame

# 3. Enable all MCP tools
unity-mcp-cli configure ./MyAIGame --enable-all-tools

# 4. Configure Claude Code MCP integration
unity-mcp-cli setup-mcp claude-code ./MyAIGame

# 5. Open the project with MCP connection
unity-mcp-cli open ./MyAIGame --keep-connected

# 6. Wait for Unity and MCP server to be ready
unity-mcp-cli wait-for-ready ./MyAIGame

# 7. Generate Claude Code skills
unity-mcp-cli setup-skills claude-code ./MyAIGame

# 8. Verify by running a tool
unity-mcp-cli run-tool tests-run ./MyAIGame --input '{"testMode":"EditMode"}'
```

## 開始使用

AI Game Developer 是開放原始碼專案。安裝 Unity 套件、設定 Claude Code，就能開始下提示詞。CLI 工具可在 npm 上取得，適合自動化工作流程。詳細的設定說明請參閱快速入門指南 [ai-game.dev/docs/quickstart](https://ai-game.dev/docs/quickstart)。

- AI Game Developer（Unity-MCP）：[github.com/IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP)
- AI 動畫擴充功能：[github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md](https://github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md)
- CLI 工具：[npmjs.com/package/unity-mcp-cli](https://npmjs.com/package/unity-mcp-cli)
- 下載：[ai-game.dev/download](https://ai-game.dev/download)
- 下一步：用 AI 產生動畫 — [ai-game.dev/blog/generating-unity-animations-with-ai](https://ai-game.dev/blog/generating-unity-animations-with-ai)

## 更多部落格文章

[所有文章](https://ai-game.dev/zh-hant/blog)

### [從參考圖到可直接用於遊戲的 3D 模型 — AI Game Developer 內建的 Tripo AI](https://ai-game.dev/zh-hant/blog/tripo-ai-3d-models-from-reference-images)

2026年10月26日

在 AI Game Developer 中用 Tripo 把二到四張參考視圖變成一個 3D 模型，再於同一段對話中貼圖、整理、綁骨架與製作動畫。

Ivan Murzak 閱讀時間 7 分鐘

### [先計畫，再動手 —— 遊戲開發中 AI 代理的計畫模式](https://ai-game.dev/zh-hant/blog/plan-mode-ai-agent-game-development)

2026年10月26日

在 AI Game Developer 裡用計畫模式、釐清問題、訊息佇列與程式碼審查卡片，讓你在大型遊戲任務中掌控 AI 代理。

Ivan Murzak 閱讀時間 6 分鐘

---

Source (HTML): https://ai-game.dev/zh-hant/blog/claude-code-unity-tutorial

Machine-translated (zh-Hant) from the English page: https://ai-game.dev/blog/claude-code-unity-tutorial