Unity 插件设置，分步完成

从空的 Unity 项目到 AI 代理在编辑器中工作，你需要的一切都在这里：安装插件、登录、连接 AI 客户端，并添加所需扩展。Unity 安装页面提供了简版说明。

开始之前

Unity 2022.3 或更高版本、一个 ai-game.dev 账号，以及一个 AI 客户端。

Unity 2022.3 或更高版本 — 支持 Unity 6。
一个 ai-game.dev 账号，用于默认云端连接；如果没有，请创建一个。
一个 AI 客户端 — AI Game Dev 应用、Claude Code、Cursor、Copilot、Gemini、Codex，或 14 个受支持的 MCP 客户端中的任意一个。
首次打开时需联网：插件会从 NuGet 下载 .NET 包。

安装插件

可通过应用、CLI、OpenUPM 或安装包完成——任选一种。

添加插件有四种方式，从最简单的开始：

在AI Game Dev 应用中打开 Unity 项目，点击 安装包。应用会从 OpenUPM 安装最新插件、完成登录并配置你的代理。

从 npm 安装 CLI，然后把插件添加到项目（它会替你修改 Packages/manifest.json）：

npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject

使用 OpenUPM CLI 时，在项目文件夹中运行：

openupm add com.ivanmurzak.unity.mcp

没有 OpenUPM CLI？先将作用域注册表添加到 Packages/manifest.json，然后在窗口 → 包管理器中添加包：

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": ["com.ivanmurzak", "extensions.unity"]
    }
  ]
}

打开窗口并登录

打开 AI Game Developer 窗口，并用你的账号登录一次。

在 Unity 中选择 Window → AI Game Developer — MCP（Ctrl+Alt+A，macOS 上为 Cmd+Option+A）。
让连接开关保持在云端，然后点击授权。
浏览器会打开 ai-game.dev 登录页并显示一个短代码。确认代码一致后批准即可。
Unity 状态会变为已连接。

登录状态会保存在整台电脑上：如果你已通过应用或 unity-mcp-cli login 登录，编辑器会直接使用该登录状态，你可以跳过这一步。

连接 AI 客户端

一条命令，或在窗口中点一下，即可写入客户端配置。

在窗口中点击 AI 代理旁的配置，或在终端运行 setup-mcp。两者都会把项目固定的 URL 和项目密钥写入客户端配置，因此可以立即连接：

# Claude Code — use your agent's id (cursor, codex, gemini, vscode-copilot, …)
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

配置更改后请重启 AI 客户端。其他客户端和手动配置请参阅连接 AI 客户端及MCP 端点页面。

添加扩展（可选）

动画、Cinemachine、地形、时间轴等，只安装你需要的即可。

每个扩展都是独立的 Unity 包。安装后，它会通过 RQL 让 agent 掌握 Unity 的某个领域。几个常用的扩展：

AI Animation3 项能力

openupm add com.ivanmurzak.unity.mcp.animation

AI Cinemachine4 项能力

openupm add com.ivanmurzak.unity.mcp.cinemachine

AI Terrain4 项能力

openupm add com.ivanmurzak.unity.mcp.terrain

AI Timeline5 项能力

openupm add com.ivanmurzak.unity.mcp.timeline

全部 10 个 Unity 扩展 →

故障排查

常见问题的解决办法。更多内容见Unity 故障排查指南。

下一步

Unity 维基 →配置、工具与 RQL、自定义工具、CLI 参考等。Unity 工具 →agent 在 Unity 中能做的所有事情，附示例。最佳实践 →如何让 agent 做它擅长的工作。