# 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
创建一个新场景，包含一盏平行光和一个旋转的立方体，然后进入播放模式。
```

想要更多示例提示词和高效 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-hans/engines/unity

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