Unity AI 生态横评对比:官方 AI Beta / Unity CLI / 团结 Codely / 社区 MCP 四大阵营选型
时效性提示:本文信息截至 2026-08-20,基于 Unity 官方博客、官方文档、GitHub 等公开资料整理。Unity CLI 处于 beta(1.0.0-beta.3),com.unity.pipeline 为实验包,Unity AI Beta 处 Open Beta,团结 Codely 处公测期,功能、定价、积分政策变动较快,引用前请以官方最新公告为准。
关键认知纠正:Muse 已死
网上仍能搜到大量 Muse 教程,但 Unity Muse 已被官方弃用。Unity 官方原话:
“Unity Muse 是一款已弃用的产品,它采用的是 Unity 自研模型,而 Unity AI 则是一款采用第三方模型的新产品。”
继任者是 Unity AI Beta(Open Beta),采用第三方模型。本文不再讨论 Muse,下文"Unity 官方 AI"一律指 Unity AI Beta。
整体格局——四大阵营
| 阵营 | 产品 | 性质 | 引擎要求 |
|---|---|---|---|
| Unity 官方(全球) | Unity AI Beta(Assistant + AI Gateway + Unity MCP) | 官方闭源 SaaS,积分制 | Unity 6.0+ |
| Unity 官方(全球) | Unity CLI(2026-07-20 发布,含内置 MCP + pipeline 包) | 官方开源体验,免费,终端原生 | Unity 6.0 LTS+(pipeline 包) |
| Unity 中国 | 团结 Codely(原 Tuanjie Cowork,2026-07-28 正式发布) | Unity 中国官方 AI Agent,公测期免费 | Unity 2019+ / 团结引擎 1.x/2.0 全版本 |
| 社区开源 | CoplayDev unity-mcp / AnkleBreaker 等一批 | 开源 MCP,自托管 | 多版本兼容 |
Unity CLI 与 Unity AI Beta 的关系:CLI 是 Unity AI 的「执行层」(execution surface),Unity AI 是 CLI 的消费者之一而非替代品。Unity AI Beta 三件套里的 Unity MCP 仍在使用,但官方已把 Unity CLI 列为推荐路线——CLI 免费、无 seat 门槛、内置
unity mcp与既有 MCP 向后兼容。详见下文第四节。
一、Unity AI Beta(原 Muse 继任者,官方)
1.1 三件套
Unity AI Beta = Assistant + AI Gateway + Unity MCP:
- Unity AI Assistant:编辑器内置 Agent,可检查 GameObject/组件、执行编辑器操作、验证更改;可选 4 款模型,Unity Default 为开箱即用。
- AI Gateway:把你自己订阅的第三方 AI(已验证列表)接入编辑器,不消耗 Unity 积分。
- Unity MCP Server:官方 MCP 服务器,让 IDE 里的 Claude Code/Cursor 等访问 Unity,不消耗积分,但需 Unity AI Beta 订阅 + seat。
1.2 定价(unity.com/products,2026)
| 套餐 | 引擎订阅价 | AI 积分 | MCP 并发 | AI Gateway |
|---|---|---|---|---|
| Personal | 免费 | 14 天试用 1000 积分,之后 $10/月买 1000 积分 | 1 | 可接第三方 agent |
| Pro | $2,310/年($210/月) | 2000/月 | 3 | 含 |
| Enterprise | 定制价 | 3000/月 | 5 | 含 |
| Industry | 定制价 | 3000/月 | 5 | 含 |
积分用完可单独购买积分包。AI Gateway 和 MCP 不消耗积分,但必须有 eligible 订阅 + admin 显式分配 seat(积分不需要 seat,Gateway/MCP 必须 seat)。积分按月过期不滚存,按 action 计费(生成脚本/搭场景/产资产消耗不同)。
1.3 国内访问
最大障碍:
- Unity Cloud 强依赖:项目必须连 Unity Cloud,国内访问 unity.com 云服务稳定性一般。
- LLM 在云端:Assistant 走 Unity 代理的第三方模型,推理请求受国内网络影响。
- 版本门槛:仅 Unity 6.0+,不向后兼容。低版本项目只能选团结 Codely 或社区 MCP。
二、Unity AI Beta MCP 配置实操
权威来源:Unity 官方博客《Unity AI 公开测试版:如何开始使用 MCP》(2026-05-11)+ Assistant 2.5 文档。
2.1 前置条件
| 项 | 要求 |
|---|---|
| Unity 版本 | 6000.0 或更高,不向后兼容 |
| 插件 | AI Assistant 包(编辑器 AI 按钮安装,或 Package Manager 装 com.unity.ai.assistant,当前 2.5/2.13 pre) |
| MCP 客户端 | Claude Code / Cursor / Windsurf / Claude Desktop / VS Code Copilot 任一 |
| 云连接 | 项目关联 Unity Cloud |
| 订阅 | 有效 Unity AI 试用或订阅 + 显式分配的 seat |
2.2 配置五步
- 确认 Bridge 运行:
编辑>项目设置>Unity AI>Unity MCP,确认 Unity Bridge 绿色"运行中"。停止则点开始。 - 自动配置客户端:同页
集成选项卡 → 选客户端(Claude Code/Cursor/Windsurf/Claude Desktop)→ 点配置,Unity 自动写 MCP 配置。 - 手动配置(非自动列表客户端):加指向 Unity Relay 二进制的 server 条目,参数
--mcp。Relay 在 Unity 启动时安装到~/.unity/relay/。各平台路径:
Claude Code 的macOS Apple Silicon: ~/.unity/Relay/Relay_mac_arm64.app/Contents/MacOS/Relay_mac_arm64 macOS Intel: ~/.unity/relay/relay_mac_x64.app/Contents/MacOS/relay_mac_x64 Windows: %USERPROFILE%\.unity\Relay\Relay_win.exe Linux: ~/.unity/Relay/Relay_linux~/.claude.json示例(macOS AS):{ "mcpServers": { "unity": { "command": "~/.unity/Relay/Relay_mac_arm64.app/Contents/MacOS/Relay_mac_arm64", "args": ["--mcp"] } } } - Unity 批准连接:客户端首次连接会弹"连接待处理",去
项目设置>Unity AI>Unity MCP查看详情 →接受。已批准下次自动重连。 - 测试:在 IDE 让 AI 跑"读取 Unity 控制台消息并汇总所有警告或错误"验证。
2.3 内置工具
官方 MCP 工具集(比社区精简但官方维护):场景管理、脚本编辑、控制台访问、GameObject 检查、构建设置。可用 C# 注册项目专属自定义工具。
2.4 四个典型用法
- “在坐标 (0,0,0) 处创建一个名为 PlayerSpawn 的新空 GameObject”
- “读取场景层次结构,并告诉我哪些对象缺少组件”
- “编写一个让摄像机跟随玩家移动的脚本,并附加到主摄像机”
- 控制台闭环修 bug:AI 调
Unity_ReadConsole读错误 → 定位脚本读源码 → 写修复保存 → 再读控制台确认。全程不离开 IDE。
三、AI Gateway 配置实操
权威来源:Assistant 2.13 文档《Configure AI Gateway》。
3.1 AI Gateway vs MCP(最易混淆)
| 维度 | AI Gateway | Unity MCP |
|---|---|---|
| 谁发起 | Unity 编辑器内的 Assistant 窗口 | IDE 里的 AI 客户端 |
| 方向 | Unity → 你的 provider | IDE → Unity 编辑器 |
| 用途 | 在 Unity 里用自己的 API key 跑 AI 省 Unity 积分 | 在 IDE 里让 AI 操控 Unity 编辑器 |
| 消耗积分 | 否 | 否 |
| 需要 seat | 是 | 是 |
组合用法:Gateway + MCP 一起开,IDE 端 MCP 操编辑器,Unity 端 Gateway 省积分——两边都不耗 Unity 积分。
3.2 支持的 agent 与版本(2026-07)
| Agent | 版本要求 |
|---|---|
| Claude Code | 2.1.45 或更高 |
| Cursor CLI | 2026.02.13 或更高 |
| Codex CLI | Unity 捆绑版本,不可自选 |
| Gemini CLI | Unity 捆绑版本,不可自选 |
3.3 配置步骤
-
分配 seat(admin):Unity Dashboard >
Administration>Subscriptions> 选 AI/Pro/Enterprise/Industry 订阅 >Assign Seats> 选用户。项目 link 到同一 organization。 -
Assistant 里选/装 agent:Assistant 窗口 agent selector 选 agent;找不到会有 banner 给安装链接。
-
加 API key:装完弹 AI Gateway installer 窗口填 key,或
Project Settings>AI>Gateway→Agent Type选 agent →CLI Path空则 Browse 选可执行文件。 -
环境变量:Gateway 窗口展开
Environment Variables>Add Variable:Agent 环境变量 Claude Code ANTHROPIC_API_KEYGemini CLI GEMINI_API_KEYCodex CLI OPENAI_API_KEY(文档未明列,按 Codex CLI 惯例) -
Assistant 自动重载 agent,恢复 session。之后新 prompt 路由到选定 agent。
3.4 国内注意
- API key 门槛:Claude(Anthropic)、Gemini(Google)、Codex(OpenAI)三家国内访问均受限,需中转 API 或代理。
- 非验证 provider 不保证:Gateway 官方只验证 Claude/Codex/Gemini,用智谱/通义等兼容协议理论上可行但不保证。
- seat 分配走 Unity Dashboard:Unity Cloud 后台国内访问稳定性一般。
- Claude Code on Windows 需 Git Bash:Windows 用户先装 Git Bash。
四、Unity CLI(官方继任者,2026-07-20 发布)
权威来源:Unity 官方博客《Meet the Unity CLI: manage Unity from your terminal》(ETIENNE WHITTOM, VP Authoring Platform, 2026-07-20)+ docs.unity.com/unity-cli release notes + com.unity.pipeline 包文档。
与 Unite Seoul 2026 / Unity 7 同场发布:Unity CLI 是 Unity 7 路线图的生态支柱之一,正式版预计 2027 Q1(2026-12 开放 Beta)。但 CLI 与 pipeline 包在发布当天即可用,不依赖 Unity 7。
4.1 是什么
Unity 官方推出的终端原生 CLI:单个自包含二进制,管理 Unity 编辑器/模块/项目/认证,为脚本、CI 和 AI agent 设计。定位官方原话:
“Unity CLI and the Pipeline package are the execution surface that carries those decisions out: fast, local, and token-gated. The same surface is open to any agent, whether that’s Unity’s own tooling routing through its MCP server, a third-party assistant, or a script you write yourself. Unity’s AI is one consumer of it, not a replacement for it.”
即:Unity AI 负责「思考」,CLI + Pipeline 负责「执行」。Unity AI Beta 的 MCP 服务器是 CLI 执行面的消费者之一,CLI 不是 AI 的替代品,而是更底层的执行层。
4.2 核心特性
| 特性 | 说明 |
|---|---|
| 单二进制 | 无依赖,自加 PATH,unity upgrade 原地更新;原生启动快,对比旧 Unity Hub --headless 快很多 |
| 结构化输出 | 每命令可 --format json/tsv(--json 全局简写),stdout 结果 / stderr 错误,退出码约定 0 成功 / 1 错误 / 130 取消 |
| 非交互安装 | unity install <版本> -m android ios webgl --accept-eula --yes;CI 服务账户走环境变量认证,无浏览器无手工步骤 |
| 诊断 | unity doctor 检查环境/凭据/配置问题 |
| 编辑器管理 | unity editors / unity open / unity auth login / unity modules list <版本> |
| 交互 shell | unity shell 带命令历史、tab 补全、use project/use org 会话上下文;--protocol ndjson 机器模式供 agent 热进程跑多条命令 |
常用命令:
# 安装(一行装编辑器+模块)
unity install 6000.2.10f1 -m android ios webgl
unity editors # 已装编辑器
unity editors running # 正在运行的编辑器实例(项目/版本/PID)
unity open <项目> # 用正确编辑器打开项目
unity auth login # 登录
unity doctor # 诊断环境
unity shell --protocol ndjson # agent 友好的交互机器模式
4.3 com.unity.pipeline 包(驱动运行中的编辑器)
实验包(当前 0.4.0-exp.1,Unity 6.0 LTS+),让 CLI 通过本地 API 驱动正在运行的编辑器或开发 Player 构建:
- 项目安装一条命令:
unity pipeline install;unity pipeline list查哪些项目装了。 - 注册命令:任何静态方法加
[CliCommand](参数加[CliArg])即成为命令,自动发现无需注册。命名空间Unity.Pipeline.Commands。using Unity.Pipeline.Commands; using UnityEngine; public static class MyPipelineCommands { [CliCommand("greet", "Log a greeting and return its length")] public static int Greet( [CliArg("name", "Who to greet", Required = true)] string name) { Debug.Log($"Hello, {name}!"); return name.Length; } }unity command # 列出连接编辑器暴露的命令(编辑器自我描述,agent 运行时发现) unity command greet --name World - 内置命令覆盖面极广(按 0.4.0-exp.1 文档):资产/文件、场景、GameObject 与组件、Prefab、脚本、动画、材质/Shader、光照烘焙、导航与选择、截图(场景/游戏视图/UI Toolkit)、构建/编译/测试、项目设置、包管理、编辑器生命周期(Play/Stop/暂停/聚焦/菜单/控制台/性能)、运行时(Player 侧状态/日志/控制台/eval/热重载)。状态变更命令带
confirm/dry_run门和 Undo 分组(AuthoringUndoScope)、路径沙箱。 - Player 运行时:把运行时组件打进开发构建,运行中的游戏暴露同类 API,
unity command --runtime <player exec>指向它拉实时日志、查运行时状态、热重载代码。默认仅 localhost 且默认关闭(dev/QA 构建,生产永不)。
4.4 unity command eval(实时执行 C#)
unity command eval 用 Roslyn 在运行中的编辑器/Player 主线程上编译并执行任意 C# 表达式并返回结果,无需项目级重编译或域重载,毫秒级应答:
unity command eval "return Application.version;"
unity command eval "return UnityEditor.EditorApplication.isPlaying;"
unity command eval "var s = Application.dataPath; return s.Length;" --json
unity command eval_file "path/to/script.cs"
- 能触达项目可调用的任何引擎/编辑器 API,能力面=Unity 整个 API 面(渲染/物理/动画/资源库/编辑器本身+自己的代码)。
- 因为能力双向,eval 在账号认证令牌后门控,令牌只放密钥库,不贴公开聊天/工单/agent 转录。
- 官方演示的 AI 闭环:agent 收纯英文 bug 报告(“玩家有时会从地板上掉下来”)→
unity command eval检查实时场景 → 发现运行时被禁用的碰撞器 → 重新启用 → 重进 Play 模式确认修复。观察→行动→验证全程无复制粘贴控制台输出。
4.5 内置 MCP 模式(unity mcp)——与 Unity MCP 的核心对比
CLI 把 MCP 内建进二进制,不是外挂 server:
| 维度 | Unity MCP(Unity AI Beta 三件套之一) | Unity CLI 内置 unity mcp |
|---|---|---|
| 形态 | 独立 Relay 二进制/进程,需 Unity AI 订阅 + 显式分配 seat | 内建在 unity 二进制,unity mcp 直接起 stdio MCP server |
| 收费 | 需 Unity AI trial/订阅(Personal/Pro 套餐)+ seat 分配 | 完全免费,无订阅,MCP 并发零人为限制 |
| 配置 | 编辑器内 AI 面板点配置 / 手写 ~/.claude.json 指向 Relay |
unity mcp configure <client> 一键注册,16 个客户端(含 Claude、Claude Code、Cursor、VS Code、Codex) |
| 兼容性 | 既有客户端 | 与既有 Unity MCP 完全向后兼容,现有 agent 提示词/工具定义无需重写 |
| 性能 | 每次工具调用等编辑器重编译/域重载 | 复用运行中编辑器,不等待重编译/域重载,反馈环更紧 |
| 官方推荐 | 仍受支持 | 官方推荐路线("basically no reason to use MCP anymore"除非模型不擅生成命令/harness 限制命令行) |
| 工具暴露 | 固定官方工具集 + C# 自定义 | 编辑器通过 pipeline 自我描述,[CliCommand] 注册的命令自然映射到 agent 工具类型 |
为什么 CLI 优于 MCP(官方论点):MCP 每循环一次工具调用、完整响应耗 token 占上下文;CLI 一次 Bash(...) 调用即可,agent 可组合管道命令(如 unity command get_console_logs --format json | jq ...)一次完成复杂操作。保留 MCP 模式的场景:模型不擅生成命令行、或 harness(Claude/Cursor/opencode 等)限制执行任意命令。
4.6 版本与发布节奏(release notes 摘录)
- 0.1.0-beta.8(2026-06-25):加入
unity mcp(内置 MCP server)+unity mcp configure(16 客户端一键注册);unity editors upgrade。 - 1.0.0-beta.3(2026-07-23,当前):
unity shell交互模式(历史/补全/--protocol ndjson机器模式);unity editors running;unity projects size/close;unity editor module remove;unity run --command <name>(无头单次运行注册命令,需 pipeline 包);--json全局简写;UNITY_PROJECT_PATH/UNITY_CLOUD_ORG环境变量;统一--project-path/--cloud-org旗标。 - 修复:
eval/eval_file编译错误退出码改为 6 并输出编译器诊断;unity mcp不再把失败的 eval 工具调用报成功、脚本重编译后不再永久失效。
4.7 与 Unity 7 的关系
Unity 7(2026-12 开放 Beta,2027 Q1 正式)路线图把「新 CLI + 公开 API」作为生态支柱:美术/制作/开发在各自熟悉的环境协作,无需完整打开编辑器即可资产验证/构建部署;Unity 7 免费提供 MCP 连接外部 AI 编程代理。CLI 今天即适用于现有 Unity 6.x LTS 工作流,不依赖 Unity 7 发布。
4.8 国内可用性
无额外网络障碍:CLI 从 public-cdn.cloud.unity3d.com 安装(curl/PowerShell 一行),国内可直连;免费无订阅无 seat,绕开了 Unity AI Beta 的 Unity Cloud 依赖和订阅门槛。已装 pipeline 包的编辑器经 localhost 本地 API 驱动,无需云。潜在注意:官方下载地址若被重定向到国区 CDN,可能装到缺 pipeline/command 命令的旧 0.1.x,可指定 1.0.0-beta.3 版本安装;brew/winget/apt 支持即将到来。底层不依赖任何 LLM——它是执行层,模型走你自己接的 agent。
4.9 几个坑
- eval 有安全令牌:能力双向,令牌必须妥善保管(密钥库),别贴公开聊天/工单/转录。生产构建永不启用 Player 运行时。
- pipeline 包实验性:0.4.0-exp.1,接口会变。状态变更命令默认
confirm/dry_run门控。 - 编辑器版本门槛:pipeline 包要求 Unity 6.0 LTS+,Unity 2022 及以下无法安装/添加该包——低版本项目仍需团结 Codely 或社区 MCP。
- CLI 是执行层,不提供 LLM:需要自己接 Claude/Cursor/Codex 等 agent 才有完整 AI 闭环;国内接国外模型仍需解决访问(中转/智谱等兼容 MCP 客户端)。
五、团结 Codely(原 Tuanjie Cowork,2026-07-28 正式发布)
5.1 是什么
Unity 中国官方出品的 AI Agent 编程智能体,主打"只有 Unity 中国能打通引擎底层"(读引擎内部代码结构、资源管线、编辑器 API)。2026-06-11 公测启动;2026-07-28 在团结引擎 2.0 发布会上正式定名「团结 Codely」并官宣,定位从"编程工具"升级为"能独立执行游戏开发任务的 AI Agent"。
核心理念是 Loop Engineering(闭环工程):输入自然语言需求后,AI 自主完成 编写代码 → 搭建场景 → 运行测试 → 分析报错 → 修复问题,最终交付"可检查、经过验证的结果",而非单纯生成代码建议。
5.2 形态(codely.tuanjie.cn/download,v1.1.4 稳定 + v1.1.5-canary.1)
- 独立桌面端(macOS AS/Intel、Windows x64)
- VS Code 插件 v3.1.0、IntelliJ IDEA 插件 v3.1.0
- 引擎内嵌 CodelyBridge
- Codely CLI(Nightly v1.0.0-nightly.42)
- Canary 版含多工作区、远程控制、Unity 窗口串流
5.3 六大能力
编写代码(全工程上下文,非单文件)、理解项目(读 Hierarchy/Prefab/Inspector/资产依赖)、资产生成(文生图/3D 模型/天空盒/2D 精灵/材质/音频/序列帧,自动落盘)、代码审查、调试修复、自动化任务(自定义 Commands/Skills/Subagents/Extensions)。团结引擎 2.0 后 AI 能力进一步延伸至性能分析、动画生成、试玩广告制作、自助多渠道发行。
5.4 团结引擎 2.0 的 AI 原生底座(2026-07-28)
团结引擎 2.0 对底层做了"从为人设计到为人机协同设计"的重构,直接放大 Codely 的能力上限:
- AI 友好的新数据格式:替换传统 C# 脚本 + YAML 状态文件,AI 不仅能读当前状态,还能理解工程演变过程,更好执行"把灯变绿"这类增量修改。
- 三大创作方式打通:自然语言、可视化节点、代码三者统一,配合修改对比 / 版本追溯 / 权限控制。
- 主机平台支持:正式新增 PS5、Xbox Series X|S、Switch 2、Switch,形成 PC/移动/主机/微信及抖音小游戏/开源鸿蒙/车机座舱完整矩阵。
- 图形升级:Virtual Geometry 虚拟几何体(高精度模型免手工多套 LOD)、实时动态全局光照、升级阴影/动画/粒子/并行渲染。
- 生态合作:与 Arm(AI 图形技术)、清华大学(游戏行业私有化垂类 Coding 大模型)、腾讯营销(自助投放)等共建"芯片—模型—引擎—Agent—工程—发行"链路。
5.5 五大优势
Unity 官方知识库背书、多 Agent 并行、Unity+团结引擎多版本兼容、Tuanjie AI Generator 量产美术、远程工作室(多主机协同)。
5.6 模型与付费
- 模型:主力 Coding 模型为智谱 GLM 系列,保持"发布即接入"节奏(GLM-4.7 → 5.1 → 5.2)。2026-06-17 Day-0 接入 GLM-5.2 Max。同时内置 Hunyuan Tripo3D 等 3D 生成模型;CEO 张俊波称正逐步部署多模态 Kimi-3 补视觉短板。
- 付费:公测期间提供免费额度(官方原话:“公测期间我们提供免费额度,方便你零成本…”);新用户每日 1000 免费额度,认证 Unity 社区开发者可享限时免费 token。正式定价未公开,预计公测结束后推套餐。
5.7 使用流程
- 访问 https://codely.tuanjie.cn/download 下载对应平台客户端(可选 Canary 版接 GLM-5.2 Max)
- Unity ID 登录
- 在 Codely 中打开 Unity 2019+ 或团结引擎 1.x/2.0 项目文件夹
- 新建 Session,模型列表选 GLM-5.2 Max
- 自然语言提需求,AI 直接生成代码/资产并落盘工程目录,走 Loop Engineering 闭环交付验证结果
5.8 国内可用性
完全无障碍——Unity 中国出品,codely.tuanjie.cn 国内直连,模型走智谱 GLM,支持私有化部署(官方 Agent 路线里唯一能私有化的)。
5.9 报道与评测
- GameLook《Unity 中国"独门绝技"!AI 工具 Cowork 公测》 http://www.gamelook.com.cn/2026/06/595313/
- GameLook《对话 Unity 中国 CEO:"团结 Codely"AI 智能体来了》 http://www.gamelook.com.cn/2026/07/598617/
- 极客公园《团结引擎 2.0 重磅发布,Unity 中国以 AI 智能体重构游戏开发工作流》 https://www.geekpark.net/news/368103
- 17173 / IT之家《Unity 中国发布团结引擎 2.0:底层架构全面重构,支持主机平台,深度整合 AI》 https://news.17173.com/content/07282026/180604059.shtml
- 知乎实测 https://zhuanlan.zhihu.com/p/2050969137871065648
- 介绍页 https://ai-bot.cn/tuanjie-cowork/
- 第三方评测 https://navxd.com/navigation/tool/tuanjie-cowork/
- CSDN 官方博客(GLM-5.2 Max 接入) https://blog.csdn.net/unityofficial/article/details/162068175
六、社区开源 Unity MCP——实战首选 CoplayDev
6.1 格局:CoplayDev 已是最火
社区开源路线里,CoplayDev/unity-mcp 是当前星数最高、更新最活跃的项目(~12k stars,MIT,v10.0.0,2026-06-30),也是本人在实际项目里落地验证过的那个。相比 AnkleBreaker 的 268 工具「全家桶」,CoplayDev 走「47 个聚焦工具」路线,够用且不压垮 MCP 客户端。
| 仓库 | Stars | 语言 | 状态 | 特点 |
|---|---|---|---|---|
| CoplayDev/unity-mcp | ~12k | C# + Python | 活跃(v10.0.0,2026-06-30) | 47 个聚焦工具,MIT,Unity 2021.3 LTS~Unity 6;支持 Claude Code/Desktop、Cursor、Copilot、Windsurf、Cline、Gemini CLI |
| AnkleBreaker-Studio/unity-mcp-server | ~362 | JS | 活跃 | 268 工具/30+ 类别,最全但需双层懒加载避免压垮客户端 |
| FunplayAI/funplay-unity-mcp | 170 | C# | 活跃 | execute_code、输入模拟、截图、Play Mode 自动化 |
| notargs/UnityNaturalMCP | 163 | C# | 已归档 | 主打"自然体验" |
| isuzu-shiranui/UnityMCP | 139 | C#/TS | 活跃 | Claude ↔ Unity 集成 |
| IvanMurzak/Unity-MCP | — | C# | 活跃 | AI Skills + MCP Tools |
| swax/UnityMCP-VRC | 51 | C# | 活跃 | 专做 VRChat 世界 |
6.2 CoplayDev/unity-mcp 详解(本机实测)
架构(双层桥接,与官方 Relay 思路一致):
┌─────────────┐ MCP 协议 ┌──────────────────┐ WebSocket ┌──────────────┐
│ Claude Code │ ──────────────→ │ Relay 服务器 │ ──────────────→ │ Unity 编辑器 │
│ (AI 助手) │ │ (本地原生进程) │ │ (C# Package) │
└─────────────┘ └──────────────────┘ └──────────────┘
安装(一次到位):
- 装 Unity 包:
Window → Package Manager → + → Add package from git URL,粘贴https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
(或用openupm add com.coplaydev.unity-mcp) - 配置 Claude Code MCP(macOS AS 示例):
或手动编辑claude mcp add unity-mcp -- /path/to/relay_mac_arm64.app/Contents/MacOS/relay_mac_arm64 --mcp --instance-id 45397.claude/settings.json:{ "mcpServers": { "unity-mcp": { "command": "/Users/你的用户名/.unity/relay/relay_mac_arm64.app/Contents/MacOS/relay_mac_arm64", "args": ["--mcp", "--instance-id", "45397"] } } } - 验证:
claude mcp list应含 unity-mcp,且 Unity 编辑器运行中、instance-id 与编辑器内一致。

工具速查表(47 个工具里最常用的):
| 场景 | 工具 | 说明 |
|---|---|---|
| 执行编辑器代码 | execute_code |
最灵活,能做几乎任何事 |
| 查看编辑器状态 | get_editor_state |
选中对象 / 打开场景 |
| 创建/修改/删除对象 | manage_game_object |
GameObject 操作 |
| 加/移除组件 | manage_component |
组件操作 |
| 写新脚本 | modify_script |
创建/修改脚本文件 |
| 读脚本源码 | get_script |
查看脚本内容 |
| 场景操作 | manage_scene |
创建/切换场景 |
| 读 Console 报错 | read_console |
调试必备 |
| 搜资源 | search_assets |
按类型/名称搜索 |
| 装 Package | manage_package |
包管理 |
6.3 实战案例(本机 Claude Code + CoplayDev)
基于一个真实 Unity C# 小游戏项目,已配置 unity-mcp 连接。
案例一:AI 创建游戏对象
“在当前场景中创建一个玩家角色对象,加上 SpriteRenderer 和 Rigidbody2D”
Claude Code 依次调用 manage_game_object(创建)→ manage_component(加 SpriteRenderer)→ manage_component(加 Rigidbody2D),Unity 编辑器实时出现新对象和组件,全程无手动操作。

案例二:AI 诊断运行时错误
“游戏运行报错了,帮我看看 Console”
Claude Code 调用 read_console(取错误日志)→ get_script(定位出错脚本)→ modify_script(修复代码),从发现到修复全程 AI 完成。
6.4 付费与使用
全部免费、开源(MIT),自托管。但底层 LLM 要自己出——需一个 Claude/Cursor 等 MCP 客户端的订阅。
6.5 国内可用性
GitHub 开源无障碍。底层 AI 模型要走 Claude/Cursor 等,国内需自行解决 LLM 访问(中转/智谱/通义等支持 MCP 的客户端)。Unity 编辑器版本兼容性(2021.3~6)比官方(仅 6.0+)宽。
仓库:https://github.com/CoplayDev/unity-mcp
七、四方横向对比大表
| 维度 | Unity AI Beta(官方) | Unity CLI(官方) | 团结 Codely(原 Cowork) | 社区开源 MCP(CoplayDev) |
|---|---|---|---|---|
| 出品方 | Unity 全球 | Unity 全球(2026-07-20 发布) | Unity 中国(2026-07-28 正式发布) | 社区个人/小团队 |
| 引擎版本 | 仅 Unity 6.0+ | pipeline 包需 Unity 6.0 LTS+;CLI 本体管理任意版本编辑器 | Unity 2019+ / 团结引擎 1.x/2.0 全版本 | Unity 2021.3~6,多版本兼容 |
| 引擎底层打通 | 官方 API | 执行层:unity command eval 直触全部引擎/编辑器 API + [CliCommand] 注册命令 |
独家读引擎内部代码+资源管线;团结 2.0 AI 原生数据格式 | 双层桥接(Relay + WebSocket)调编辑器 API |
| 形态 | 编辑器内 Assistant + MCP + Gateway | 终端原生 CLI(单二进制,内置 MCP + pipeline 包) | 桌面/IDE 插件/CodelyBridge/CLI | MCP server + 编辑器 Package |
| 资产生成 | 有(设计稿→资产) | 无(执行层,不生成资产) | 有,且自动落盘工程目录(模型/音频/3D/2D/材质)+ 动画生成/试玩广告 | 无(专注代码/编辑器操作) |
| 底层模型 | 第三方模型(Unity 代理) | 无自带 LLM,接任意 agent(Claude/Cursor/Codex 等) | GLM-5.2 Max(智谱),可私有化,逐步接 Kimi-3 | 自带 LLM(Claude/Cursor 等) |
| 付费 | Personal 免费 14 天→$10/月;Pro $2,310/年含 2000 积分 | 完全免费,无订阅无 seat | 公测期免费额度(新用户日 1000),正式价未公布 | 开源免费(MIT),LLM 自费 |
| 国内可用 | 一般(需 Unity Cloud) | 良(免费直连,本地执行无云依赖) | 极佳,直连+可私有化 | GitHub 无障碍,LLM 需自理 |
| 私有化部署 | 否 | 是(全本地执行层) | 是 | 是(全本地) |
| MCP 连接数限制 | 1/3/5(按套餐,需 seat) | 零人为限制(免费),unity mcp configure 16 客户端 |
未公布 | 无限制(自托管) |
| 适合谁 | 国际版 Unity 6+ 用户、需官方背书 | Unity 6 LTS+ 用户、脚本/CI/AI agent 自动化、想白嫖官方免费 MCP | 国内 Unity/团结引擎团队、微信小游戏/HMI/主机 | 自由开发者、想用 Claude/Cursor 深度操作 Unity、非 Unity 6 |
八、国内选型建议
- 团结引擎 2.0 / 1.x 或 Unity 2019+,做微信小游戏/HMI/主机 → 首选 团结 Codely:国内直连、公测免费、能私有化、Unity 中国独家引擎底层打通 + 团结 2.0 AI 原生数据格式、GLM-5.2 Max——综合最优。
- 国际版 Unity 6+,能稳定连 Unity Cloud,且要「AI 帮你思考」 → 用 Unity AI Beta:官方路线,和 Unity Cloud/Asset Manager 深度集成,Assistant 开箱即用。
- Unity 6.0 LTS+,主攻脚本/CI/AI agent 自动化,或不想付 Unity AI 订阅 → 首选 Unity CLI:免费无 seat,
unity mcp configure一行接 Claude Code,eval毫秒级实时改游戏状态,pipeline 命令映射 agent 工具。注意它无自带 LLM、无资产生成,是执行层不是助手。 - 要最大自由度、想用 Claude/Cursor 当 Agent 操作 Unity,且版本低于 Unity 6 → 用 CoplayDev unity-mcp(本人正在用,~12k stars,47 工具够用不压垮客户端);要 268 全工具再考虑 AnkleBreaker。模型能力上限取决于接的 LLM。
- 组合用法:Unity CLI + Claude Code 做代码/场景/构建闭环(免费);需要资产生成时叠 团结 Codely(日常编码+文生资产);非 Unity 6 老项目再用 CoplayDev。三者不冲突——CLI 本身就是执行层,可被任何 agent 调用。
九、几个坑
- Muse 已死:网上 Muse 教程仍多,别按 Muse 文档配置。官方已弃用。
- Unity AI Beta 强依赖 Unity 6.0+ + Unity Cloud:低版本 Unity 用户用不了官方路线,只能选团结 Codely 或社区 MCP。
- Codely 公测期免费额度:新用户每日 1000 免费额度,认证 Unity 社区开发者可享限时免费 token;具体政策会变,建议早用早薅,公测结束会转收费。
- 社区 MCP 的 LLM 走 Claude/Cursor:国内用 Claude Code/Cursor 需自行解决模型访问(中转 API 或换智谱/通义等支持 MCP 的客户端)。
- AnkleBreaker 268 工具(历史口径 288/330+)会压垮部分 MCP 客户端,它用双层架构(Core ~70 + Advanced proxy)缓解,配置时注意
unity_list_advanced_tools发现高级工具。想要「够用不压垮」直接选 CoplayDev 的 47 聚焦工具。 - AI Gateway/MCP 需要 seat 分配:和 Unity AI 积分不同,积分不需要 seat,Gateway/MCP 必须 admin 显式分配 seat,没 seat 用不了。
- Unity CLI 的 eval 带安全令牌:能力双向,令牌只放密钥库,别贴公开聊天/工单/agent 转录;Player 运行时默认关闭、仅 localhost,生产构建永不启用。
- CLI 是执行层,不是 AI 助手:无自带 LLM、无资产生成,要有 Claude/Cursor/Codex 等 agent 才有完整闭环;它取代的是 Unity MCP(免费化了),不是 Unity AI Assistant / 团结 Codely。
- pipeline 包有版本门槛和实验性:仅 Unity 6.0 LTS+;0.4.0-exp.1 接口会变;国内 CDN 可能装到缺 pipeline/command 的旧 0.1.x,建议装
1.0.0-beta.3。
十、官方文档与链接清单
Unity AI Beta
- 介绍页:https://unity.com/cn/features/ai
- 定价:https://unity.com/products
- MCP 博客(中文,2026-05-11):https://unity.com/cn/blog/unity-ai-mcp-how-to-get-started
- MCP 概览文档(2.0):https://docs.unity3d.com/Packages/com.unity.ai.assistant@2.0/manual/unity-mcp-overview.html
- MCP Get started(2.5):https://docs.unity3d.com/Packages/com.unity.ai.assistant@2.5/manual/integration/unity-mcp-get-started.html
- AI Gateway Configure(2.13):https://docs.unity3d.com/Packages/com.unity.ai.assistant@2.13/manual/integration/ai-gateway-get-started.html
- What is Unity AI(2026-04-26):https://unity.com/resources/what-is-unity-ai
- 第三方 Windows 配置教程(CSDN):https://blog.csdn.net/m0_57836225/article/details/149651451
Unity CLI(2026-07-20 发布)
- 官方博客《Meet the Unity CLI》(英文):https://gw-prd.hexagon.unity.com/blog/meet-the-unity-cli
- 官方博客(中文):https://unity.com/cn/blog/meet-the-unity-cli
- CLI 文档:https://docs.unity.com/unity-cli/
- CLI 参考:https://docs.unity.com/unity-cli/reference
- CLI release notes(1.0.0-beta.3,2026-07-23):https://docs.unity.com/unity-cli/release-notes
- Pipeline 包文档(0.4.0-exp.1):https://docs.unity3d.com/Packages/com.unity.pipeline@0.4/manual/index.html
- Unity 7 路线图(Unite Seoul 2026):https://unity.com/news/unity-7-roadmap-revealed-at-unite-seoul
- Unity 官方 Keynote Recap(Announcing Unity 7):https://gw-prd.hexagon.unity.com/blog/unite-seoul-keynote-2026-recap
- GamesIndustry.biz(Unity 7 Q1 2027 / CoreCLR / 免费 MCP):https://www.gamesindustry.biz/unity-7-to-launch-in-q1-2027-new-engine-is-a-direct-continuation-of-unity-6
- Unity 官方讨论(Announcing the Unity CLI):https://discussions.unity.com/t/announcing-the-unity-cli-a-new-way-to-connect-your-tools-and-agents/1731104
- 第三方评测(GameFromScratch):https://gamefromscratch.com/unity-cli-unity-pipeline-game-changers/
- 第三方评测(Techiexpert):https://techiexpert.com/unity-unveils-terminal-native-unity-cli-to-power-ai-agents-and-ci-cd-automation/
团结 Codely(原 Tuanjie Cowork)
- 官网:https://codely.tuanjie.cn/
- 下载页:https://codely.tuanjie.cn/download
- 文档:https://codely-docs.tuanjie.cn/using-codely/codely-cowork/
- 介绍页:https://ai-bot.cn/tuanjie-cowork/
- 第三方评测:https://navxd.com/navigation/tool/tuanjie-cowork/
- GameLook 公测报道(2026-06):http://www.gamelook.com.cn/2026/06/595313/
- GameLook 对话 CEO(团结 Codely 正式发布,2026-07):http://www.gamelook.com.cn/2026/07/598617/
- 极客公园(团结引擎 2.0 发布):https://www.geekpark.net/news/368103
- 17173(团结引擎 2.0 底层重构 + 主机平台 + 深度整合 AI):https://news.17173.com/content/07282026/180604059.shtml
- IT之家(同上):https://m.ithome.com/html/982616.htm
- CSDN 官方博客(GLM-5.2 Max):https://blog.csdn.net/unityofficial/article/details/162068175
社区开源 MCP
- GitHub 搜索:https://github.com/search?q=unity+mcp+server&type=repositories&s=stars&o=desc
- CoplayDev/unity-mcp(本机实测,~12k stars,47 工具):https://github.com/CoplayDev/unity-mcp
- AnkleBreaker(最全 268 工具,历史口径 288/330+):https://github.com/AnkleBreaker-Studio/unity-mcp-server
- FunplayAI(execute_code + Play Mode):https://github.com/FunplayAI/funplay-unity-mcp
- IvanMurzak/Unity-MCP(AI Skills + MCP Tools):https://github.com/IvanMurzak/Unity-MCP
- isuzu-shiranui/UnityMCP:https://github.com/isuzu-shiranui/UnityMCP
更多推荐


所有评论(0)