如何將 Claude Code 與 Unity 引擎搭配使用

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

安裝 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 專案。

# 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 伺服器。

# 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」。

# 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。

# 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 流程很有用。

# 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、等待連線，然後執行工具。以下是一個從零開始完成所有設定的完整腳本。

# 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。

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