# Codex 的 Unity 官方插件：安装、连接、调用 Skill

Unity 官方 Codex 插件在哪里找、怎么从插件目录或两条命令安装、如何在打开的 Unity 6 编辑器里通过 MCP 批准连接，以及 Unity CLI 和这个插件的区别。

## 先说结论：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](/images/codex/codex-unity-plugin-skills.webp)

从终端装，同样是两条命令：

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

仓库是 [Unity-Technologies/unity-agent-plugin](https://github.com/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](/docs/mcp/unity-mcp/) 是独立的服务窗口，跑在 `6594` 端口，带 Cursor 和 Codex 的一键配置。两者都在本地运行，但不是同一个面板。通道本身怎么工作，见 [MCP 怎样把 AI 编程工具接到游戏引擎上](/docs/mcp/what-is-mcp/)。

连接批准之后，当前场景、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 详细介绍](/exp/codex-unity-skills-overview/)。

## 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 覆盖了什么，又留下了什么](/exp/unity-codex-plugin-mcp-skills-and-ui-asset-gap/)。