先说结论:3个步骤

Codex 的 Unity 插件适合这样的 Unity 6 工程:希望 Codex 按当前的 API 写代码,而不是按十年积累下来的论坛答案写。插件由 Unity 以自己的名义发布,里面 31 个 Skill 都由负责对应功能的 Unity 团队编写。从 Codex 的插件目录安装,或者用两条命令安装,然后在编辑器里批准 MCP 连接,之后提需求时指定 Skill 的名字。需要 Unity 6 或更高版本。

步骤 1:找到插件并安装

两条路径,装到的是同一个插件。

在 Codex 的侧边栏打开 Plugins(插件),搜索 Unity,从 Unity Technologies 名义发布的目录条目安装。

Codex 的 Unity 插件页面,列出 31 个 Skill,包括 2d Pixel Perfect、Audio Setup Mixers、Build Live Game

从终端装,同样是两条命令:

codex plugin marketplace add Unity-Technologies/unity-agent-plugin
codex plugin add unity@unity-agent-plugin

仓库是 Unity-Technologies/unity-agent-plugin,许可证为 Unity Companion License。Claude Code 从同一个仓库安装,命令是 /plugin install unity@unity-agent-plugin。

它不是 Asset Store 的资源包,编辑器里的 Package Manager(包管理器)找不到它。当前版本是 0.1.6-beta,后续更新通过 codex plugin marketplace upgrade unity-agent-plugin 获取,不需要在机器之间复制文件,也不需要为每个工程单独配置。

新开一个 Codex 会话,输入 /unity:,可以确认 Skill 列表是否已经加载。

步骤 2:在编辑器里批准 MCP 连接

先把 Unity 6 工程打开。下面这些操作都发生在正在运行的编辑器上。

在 Unity 里打开 Edit(编辑)→ Project Settings(项目设置)→ AI → Unity MCP,确认 Bridge 显示为 Running。Codex 发来的第一个请求会落在 Pending Connections 里,一直等到在编辑器里点 Accept 才会放行。传输走本地 IPC,工程源码不会离开本机。

有两个面板容易混。官方插件用的是 Unity 编辑器内置的 MCP Bridge。这个站点另外介绍的 Unity MCP 是独立的服务窗口,跑在 6594 端口,带 Cursor 和 Codex 的一键配置。两者都在本地运行,但不是同一个面板。通道本身怎么工作,见 MCP 怎样把 AI 编程工具接到游戏引擎上。

连接批准之后,当前场景、GameObject 和 Console 日志都可以在会话里读取和修改。

步骤 3:提需求时指定 Skill

Skill 以斜杠命令的形式按名字调用。如果只说「做一个设置界面」而不指定 Skill,用哪套 UI 框架就没有定下来。uGUI 的工程里被写进 UI Toolkit 的代码、后面还要拆掉重来,多半是这么来的。

先交给路由,让它判断工程的情况:

/ui 做一个设置界面,带音量滑块和返回按钮

/ui 会先读这个工程在用哪套 UI 系统,再转给 /ui-uitk、/ui-ugui 或 /ui-imgui。其他领域同理:从 Built-in 迁移到 URP 用 /migrate-birp-to-urp,图集打包用 /manage-sprite-atlas,CJK 文字显示成方块用 /optimize-text-mesh-pro,Unity IAP 用 /implement-in-app-purchases。

31 个 Skill 按用途分组的完整介绍:Codex 中的 Unity Skills 详细介绍。

Unity CLI 和这个插件不是一回事

这个问题被问得够多,直接写清楚。

Unity CLI 是一个接口。它从终端触达引擎,负责安装 Editor、创建和打开工程、管理包和许可证、执行构建与测试、读取日志。AI 也好,人也好,都可以调用它。Unity 在 Unite Seoul 就发布了 CLI,比两个插件都早。

插件给出的是一套指引。每个 Skill 描述的是「这件 Unity 的活本来该怎么做」,所以 Codex 会先看工程、用当前的 API、验证结果之后再返回。没有这套指引时,通用编程工具只能按网上关于 Unity 的所有内容取一个平均值来回答,而那里面很大一部分是针对早就不再发布的引擎版本写的。

两者在插件内部交汇:unity-cli 本身就是 31 个 Skill 中的一个,专门教 Codex 怎么使用 CLI。装了插件不等于可以不用 CLI,用了 CLI 也不等于 AI 就拿到了 Unity 对这件活的指引。

两者之外还剩什么

Skill 覆盖的是工程打开之后代码怎么写。批量化处理生成出来的 UI 美术资源——把一张合成图按检测到的边缘切开,导出有意义命名的图片文件,写进 Assets/Textures 和 Assets/Prefabs,并且保留和同步原图层的上下文信息——发生在这之前,不在 Skill 列表里。见 Unity 的 Codex 插件:31 个 Skill 覆盖了什么,又留下了什么。