时效性提示:本文信息截至 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 配置五步

  1. 确认 Bridge 运行编辑 > 项目设置 > Unity AI > Unity MCP,确认 Unity Bridge 绿色"运行中"。停止则点开始
  2. 自动配置客户端:同页 集成 选项卡 → 选客户端(Claude Code/Cursor/Windsurf/Claude Desktop)→ 点配置,Unity 自动写 MCP 配置。
  3. 手动配置(非自动列表客户端):加指向 Unity Relay 二进制的 server 条目,参数 --mcp。Relay 在 Unity 启动时安装到 ~/.unity/relay/。各平台路径:
    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 Code 的 ~/.claude.json 示例(macOS AS):
    {
      "mcpServers": {
        "unity": {
          "command": "~/.unity/Relay/Relay_mac_arm64.app/Contents/MacOS/Relay_mac_arm64",
          "args": ["--mcp"]
        }
      }
    }
    
  4. Unity 批准连接:客户端首次连接会弹"连接待处理",去 项目设置 > Unity AI > Unity MCP 查看详情 → 接受。已批准下次自动重连。
  5. 测试:在 IDE 让 AI 跑"读取 Unity 控制台消息并汇总所有警告或错误"验证。

2.3 内置工具

官方 MCP 工具集(比社区精简但官方维护):场景管理、脚本编辑、控制台访问、GameObject 检查、构建设置。可用 C# 注册项目专属自定义工具。

2.4 四个典型用法

  1. “在坐标 (0,0,0) 处创建一个名为 PlayerSpawn 的新空 GameObject”
  2. “读取场景层次结构,并告诉我哪些对象缺少组件”
  3. “编写一个让摄像机跟随玩家移动的脚本,并附加到主摄像机”
  4. 控制台闭环修 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 配置步骤

  1. 分配 seat(admin):Unity Dashboard > Administration > Subscriptions > 选 AI/Pro/Enterprise/Industry 订阅 > Assign Seats > 选用户。项目 link 到同一 organization。

  2. Assistant 里选/装 agent:Assistant 窗口 agent selector 选 agent;找不到会有 banner 给安装链接。

  3. 加 API key:装完弹 AI Gateway installer 窗口填 key,或 Project Settings > AI > GatewayAgent Type 选 agent → CLI Path 空则 Browse 选可执行文件。

  4. 环境变量:Gateway 窗口展开 Environment Variables > Add Variable

    Agent 环境变量
    Claude Code ANTHROPIC_API_KEY
    Gemini CLI GEMINI_API_KEY
    Codex CLI OPENAI_API_KEY(文档未明列,按 Codex CLI 惯例)
  5. 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 installunity 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 evalRoslyn 在运行中的编辑器/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 runningunity projects size/closeunity editor module removeunity 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 几个坑

  1. eval 有安全令牌:能力双向,令牌必须妥善保管(密钥库),别贴公开聊天/工单/转录。生产构建永不启用 Player 运行时。
  2. pipeline 包实验性:0.4.0-exp.1,接口会变。状态变更命令默认 confirm/dry_run 门控。
  3. 编辑器版本门槛:pipeline 包要求 Unity 6.0 LTS+,Unity 2022 及以下无法安装/添加该包——低版本项目仍需团结 Codely 或社区 MCP。
  4. 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 使用流程

  1. 访问 https://codely.tuanjie.cn/download 下载对应平台客户端(可选 Canary 版接 GLM-5.2 Max)
  2. Unity ID 登录
  3. 在 Codely 中打开 Unity 2019+ 或团结引擎 1.x/2.0 项目文件夹
  4. 新建 Session,模型列表选 GLM-5.2 Max
  5. 自然语言提需求,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) │
└─────────────┘                  └──────────────────┘                  └──────────────┘

安装(一次到位):

  1. 装 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
  2. 配置 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"]
        }
      }
    }
    
  3. 验证:claude mcp list 应含 unity-mcp,且 Unity 编辑器运行中、instance-id 与编辑器内一致。

MCP设置界面

工具速查表(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 调用。

九、几个坑

  1. Muse 已死:网上 Muse 教程仍多,别按 Muse 文档配置。官方已弃用。
  2. Unity AI Beta 强依赖 Unity 6.0+ + Unity Cloud:低版本 Unity 用户用不了官方路线,只能选团结 Codely 或社区 MCP。
  3. Codely 公测期免费额度:新用户每日 1000 免费额度,认证 Unity 社区开发者可享限时免费 token;具体政策会变,建议早用早薅,公测结束会转收费。
  4. 社区 MCP 的 LLM 走 Claude/Cursor:国内用 Claude Code/Cursor 需自行解决模型访问(中转 API 或换智谱/通义等支持 MCP 的客户端)。
  5. AnkleBreaker 268 工具(历史口径 288/330+)会压垮部分 MCP 客户端,它用双层架构(Core ~70 + Advanced proxy)缓解,配置时注意 unity_list_advanced_tools 发现高级工具。想要「够用不压垮」直接选 CoplayDev 的 47 聚焦工具。
  6. AI Gateway/MCP 需要 seat 分配:和 Unity AI 积分不同,积分不需要 seat,Gateway/MCP 必须 admin 显式分配 seat,没 seat 用不了。
  7. Unity CLI 的 eval 带安全令牌:能力双向,令牌只放密钥库,别贴公开聊天/工单/agent 转录;Player 运行时默认关闭、仅 localhost,生产构建永不启用。
  8. CLI 是执行层,不是 AI 助手:无自带 LLM、无资产生成,要有 Claude/Cursor/Codex 等 agent 才有完整闭环;它取代的是 Unity MCP(免费化了),不是 Unity AI Assistant / 团结 Codely。
  9. 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
Logo

欢迎加入 MCP 技术社区!与志同道合者携手前行,一同解锁 MCP 技术的无限可能!

更多推荐