从一个空文件夹开始,到生成一个带物理、材质、动画和粒子特效的可玩 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):
| Skill | MCP 工具 | |
|---|---|---|
| 每次调用占用 | 约 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):
- 优先用 skills,而不是 MCP 工具——上下文开销几乎为零
- 任务之间
/clear,别带历史包袱 - 不要把上一个任务的话题带进新任务
- 关掉用不到的 MCP 工具和集成
- 批量操作用 subagent,比顺序调用快得多
- 一个 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 的圆环排列的立方体」,剩下的你会自己摸索出来的。
安装后立刻验证
跑完三条命令后,按下面几步确认环境真的就绪了:
- 检查技能列表:在 Claude Code 里输入
/,确认 57 个命令出现在列表中 - 检查 MCP 连接:输入
/mcp,确认对应的 MCP 服务器在列表里 - 做一次小操作:让 AI「在场景里放一个 Cube」,确认它真的出现在 Hierarchy 里
- 试一次 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)