从语音指令到可玩游戏:AI 特工驱动的 Unity 开发全流程

Smart AI Code2026-10-03阅读约 10 分钟

从一个空文件夹开始,到生成一个带物理、材质、动画和粒子特效的可玩 Unity 游戏——全程没有手写任何代码,全部由自然语言和语音指令驱动。本文拆解了完整的实战流程,你可以照着做,也可当作后续排错的参考。

背景:MCP(Model Context Protocol)由 Anthropic 于 2024 年 11 月 25 日开源,是连接 AI 助手与外部工具的统一开放标准。本文中的开发环境正是基于这一协议搭建。

你会学到什么

  • 用三条命令搭建 Claude Code + Unity 的 AI 开发环境
  • 理解 Skills 和 MCP 工具的差别,知道什么时候该用哪个
  • 用语音模式 + 多终端并行,让多个 AI 特工同时干活
  • 掌握省上下文的六个技巧,避免 AI 越干越笨
  • 知道装好插件后怎么验证、遇到问题怎么排查

三条命令,搭建 AI 开发环境

整个环境搭建只需要三步(来源:cnblogs.com、m.sohu.com):

# 1. 创建 Unity 工程
unity-mcp-cli create-project ./MyUnityProject --unity 6000.3.1f1

# 2. 安装 AI Game Developer 插件
unity-mcp-cli install-plugin ./MyUnityProject

# 3. 打开工程并保持连接
unity-mcp-cli open ./MyUnityProject --keep-connected

Unity 加载期间,在项目目录里启动 Claude Code。打开插件窗口里的 Generate Skills 开关,它会自动生成一批技能文件供 Claude Code 自动发现——开箱就有 57 个命令可用(来源:cnblogs.com)。重启 Claude Code 后,输入 / 即可看到完整命令列表。

Skills 和 MCP 工具:差别比你想的大

项目同时支持两种能力暴露方式,两者的开销差距很大(来源:cnblogs.com、m.sohu.com):

SkillMCP 工具
每次调用占用约 8 个 token重得多
加载方式按需加载,平时不占上下文始终挂在 prompt 里,不管用不用
适用场景单个任务需要持续访问编辑器状态

判断标准很直接:用 AI 干活,瓶颈从来不是执行速度,而是上下文窗口。上下文装得太多,AI 的表现会肉眼可见地下降。因此建议——把你用不上的 MCP 工具(比如 Gmail、Calendar 之类)禁掉,任务之间记得 /clear,别让上一次的对话残渣拖住这次的发挥(来源:cnblogs.com)。

技能可以随便装几千个,几乎不花代价。这个设计思路,值得所有想把 AI 接进自己工具链的人抄作业。

语音驱动 + 并行 AI 特工

打开 Claude Code 的语音模式(/voice 或按住空格),就能直接说话了。第一步任务很简单:「给我在场景里放三个排成一排的球。」几秒钟后,球就出现在场景里(来源:cnblogs.com)。

更好玩的是下一步——并行 AI 特工。在同一个项目目录里多开几个 Claude Code 终端,每个终端就是一个独立的 AI agent,各自管自己的上下文,互不干扰(来源:cnblogs.com、m.sohu.com)。实际操作中,一个 agent 在做金、银、玻璃三种材质,另一个同时在铺地板和围墙。做到后面,常常是两三个 agent 同时跑:一个在写 WASD 旋转控制器,一个在修球的位置,还有一个在调相机角度。

出错不用你管

AI 干活不可能一次全对。插件的做法是把 Unity 的报错信息原样、详细地反馈给 Claude Code——哪个工具调用失败了、哪段 C# 编译不过,agent 拿到反馈自己改,自己重试(来源:cnblogs.com、m.sohu.com)。

有个细节很能说明问题:做粒子特效时材质显示成粉色(Unity 里粉色 = 丢了 shader),作者只需补一句「这材质是粉的」,AI 自己就定位到原因并修好了。后面觉得粒子不够亮、不够多,也是一句话的事:「亮一点,数量翻三倍。」

中途装扩展,不用重启

插件有个扩展系统,专门做垂直能力。开发做到一半才装了两个扩展包:AI Particle System 和 AI Animation。装完新技能直接冒出来,从 57 个变成 59+ 个,当场就能用(来源:cnblogs.com、m.sohu.com)。

levitation 动画那段也很真实:所有装饰物体上下漂浮、循环缩放,动画片段、Animator Controller 全是 AI 自己建的。物体被动画拽回原点这种经典坑,AI 用「包一层父 GameObject」的常规手法就解决了——这说明它用的不是花架子,是游戏开发的日常套路。

省上下文的六条实操经验

这是整篇文章最值钱的部分。原文作者原样搬过来的六条经验(来源:cnblogs.com):

  1. 优先用 skills,而不是 MCP 工具——上下文开销几乎为零
  2. 任务之间 /clear,别带历史包袱
  3. 不要把上一个任务的话题带进新任务
  4. 关掉用不到的 MCP 工具和集成
  5. 批量操作用 subagent,比顺序调用快得多
  6. 一个 agent 只专注一件事

实测效果:每个任务只占上下文窗口的 3%–5%。这就是为什么整个流程跑下来 AI 没有「变傻」。

架构拆解:GameDev-MCP-Server 是什么

可能有人会好奇这套东西底下是怎么连的。这里要分清两个仓库(来源:cnblogs.com):

  • Unity-MCP(也就是 AI Game Developer 插件):跑在 Unity Editor 里的那一半,提供 70+ 工具,覆盖场景、资源、脚本、编辑器控制、测试、Profiler 全套
  • GameDev-MCP-Server:一个独立的 .NET 服务,跑在中间当「传话筒」

GameDev-MCP-Server 这个仓库最有意思的设计是:它一份代码同时服务三个引擎——Unity-MCP、Godot-MCP、Unreal-MCP 共用它。仓库里没有任何引擎特定的代码,真正干活的工具是由连上来的引擎插件动态提供的(来源:cnblogs.com)。拓扑很清晰:

MCP 客户端 ⇄ gamedev-mcp-server ⇄ (SignalR) ⇄ 引擎插件 (Unity / Godot / Unreal)

启动方式也很随意:dotnet tool 一键装、源码跑、Docker 一条命令,或者直接用 Release 里预编译好的跨平台二进制(Windows/macOS/Linux,x86/ARM 全有)。

这个「薄服务器 + 动态注册」的思路意味着:不管你团队用什么引擎,AI 接入层是同一套。引擎换了,客户端那边的配置几乎不用动。

成品长什么样

最终的游戏(来源:cnblogs.com、m.sohu.com):

  • WASD 控制旋转的地板
  • 三个带物理的金属球(金、银、玻璃)在上面滚动
  • 彩色装饰物带着循环动画漂浮
  • 场景里还有一层尘埃粒子烘托氛围

而这一切,从一个空文件夹开始,只靠自然语言指令堆出来。

不只 Claude Code 能用

虽然这篇文章用的是 Claude Code,但插件本身对客户端没有执念——Cursor、Gemini、GitHub Copilot、VS Code,任何支持 MCP 的客户端都能接。整个项目免费开源,采用 Apache-2.0 协议(来源:cnblogs.com)。

下一步:现在就去试

如果你想上手,下面是具体的验证路径(来源:cnblogs.com):

快速上手文档:ai-game.dev/docs/quickstart
下载页:ai-game.dev/download

不想看文档也行,把那三条命令跑一遍,然后对 AI 说「给我建三个半径 2 的圆环排列的立方体」,剩下的你会自己摸索出来的。

安装后立刻验证

跑完三条命令后,按下面几步确认环境真的就绪了:

  1. 检查技能列表:在 Claude Code 里输入 /,确认 57 个命令出现在列表中
  2. 检查 MCP 连接:输入 /mcp,确认对应的 MCP 服务器在列表里
  3. 做一次小操作:让 AI「在场景里放一个 Cube」,确认它真的出现在 Hierarchy 里
  4. 试一次 Play Mode 闭环:让 AI「进入 Play Mode,跑 3 秒,截一张 Game 视图的图」

常见问题排查

如果第三步失败了,按顺序检查:

  • Unity Editor 是否开着:MCP 需要 Editor 处于运行状态才能连上
  • 端口是否被占用:默认端口 8765,如果被占用可以在面板里改(来源:mcp.csdn.net)
  • 客户端配置是否正确:检查 .mcp.json 或对应客户端的 MCP 配置文件,确认 URL 是 http://127.0.0.1:8765/
  • 网络监听范围:插件仅监听 127.0.0.1,不会暴露到外网,确保你是在本机操作(来源:mcp.csdn.net)
  • Unity 版本兼容性:Funplay MCP 要求 Unity 2022.3 或更高版本(已在 6000.x 上验证);CoplayDev unity-mcp 支持 Unity 2021.3 LTS 到 6.x(来源:github.com、mcp.csdn.net)

重要提醒

有几件事需要在动手前想清楚:

  • bypass permissions 模式可以关掉每次执行的确认框,但意味着任何指令都会不经确认直接执行,包括被恶意 prompt 注入诱导出来的危险操作。只在可信环境里用,别在重要机器上开(来源:cnblogs.com)
  • Unity 官方 Claude Code 插件目前是 beta,第三方工具条款归 Anthropic,Unity 不给担保。能用,但别把生产构建全托付给它(来源:xuyi.dev)
  • AI 不会替你做玩法设计。它擅长的是执行已知模式、批量操作、机械重构,不擅长 novel creative work 和 gut-check 判断(来源:strayspark.studio)
  • 上下文窗口是瓶颈,不是执行速度。保持 AI 高效的关键是合理利用上下文,而不是指望模型「更聪明 5%」(来源:cnblogs.com)