基于 UnityMCP、Claude 与 VSCode 的 AI 游戏开发工作流
如何在 VSCode 中配置 UnityMCP 与 Claude 协作进行游戏开发。主要步骤包括安装 Git、Python、Unity Hub 及编辑器,在 Unity 中启动 MCP Server,在 VSCode 中安装相关插件并配置 .mcp.json 文件连接本地服务。通过自然语言指令,开发者可利用 AI 辅助创建场景、生成脚本及调试功能,实现高效的游戏开发工作流。

如何在 VSCode 中配置 UnityMCP 与 Claude 协作进行游戏开发。主要步骤包括安装 Git、Python、Unity Hub 及编辑器,在 Unity 中启动 MCP Server,在 VSCode 中安装相关插件并配置 .mcp.json 文件连接本地服务。通过自然语言指令,开发者可利用 AI 辅助创建场景、生成脚本及调试功能,实现高效的游戏开发工作流。


在配置 UnityMCP 之前,需要完成基础环境的安装和配置。以下组件为必须安装的依赖:
pip install uv本文重点介绍如何在 VSCode 中接入 Claude 和 UnityMCP 进行游戏开发。
除了 CoplayDev UnityMCP 之外,还有其他 UnityMCP 项目可供选择,例如 IvanMurzak/Unity-MCP 等。
| 工具 | 地址 | 介绍 |
|---|---|---|
| unity-mcp(本文使用) | https://github.com/CoplayDev/unity-mcp | star:7.2k,持续更新中 |
| Unity-MCP | https://github.com/IvanMurzak/Unity-MCP | star:1.4k |
| CoderGamester - mcp-unity | https://github.com/CoderGamester/mcp-unity | star:1.5k |
| zoucdr - unity3d-mcp | https://github.com/zoucdr/unity3d-mcp/tree/master | star:44 |
在 Unity 中通过 Window → MCP For Unity 打开相关面板,Client 选择 VSCode 然后点击 Start Server 开启连接。

然后在 VSCode 中会出现一个 MCP 服务器 (unityMCP),点击启动服务器,查看控制台输出一切正常。


此时跟 VSCode 内置的 AI 聊天可以看到 UnityMCP 已连接完成。

如果不打算连接 Claude,那此时就可以通过 VSCode 进行 Unity 的 AI 开发了,后面来接入 Claude 进行使用。
在 VSCode 中添加 Unity 和 Claude Code For VS Code 插件,如下所示:

此时在 VSCode 中会出现 Claude 的对话按钮,点击这个按钮即可打开 ClaudeAI 对话框。

如果 Claude 没安装的话应该不能使用 Claude 对话,下面简单介绍下 Claude 的安装。
# 1. 检测 npm 的版本(需要安装 node.js)
npm -v
# 2. 查看 npm 的全局安装路径(可选)
npm config get prefix
# 3. 返回的 npm 全局安装路径(不同的用户不一样)
# D:\mywork\node-v23.8.0\node_global
# 4.修改全局安装路径(可选)
npm config set prefix "D:\npm-global"
# 5. 将 npm 的全局安装路径配置到系统的 PATH 变量。(可选)
# 如果已经配置则忽略,如有不懂的可自行查找资料。
# 为什么需要配置到 PATH 变量,这是因为 npm 会将 claude 命令安装到全局安全环境路径下
# 配置了 PATH 之后,则可以在系统的任意控制台执行 claude 命令
# 6. 执行 npm 命令安装 claude code cli。(关键)
npm install -g @anthropic-ai/claude-code
# 7.验证安装
claude --version
claude --help

为了方便地在不同 API Key 之间切换,这里推荐下载一个 cc-switch 使用。
GitHub 安装地址:https://github.com/farion1231/cc-switch/releases
安装完成之后,在 cc-switch 中配置好自己购买的模型即可。
在自己的 Unity 工程目录下创建一个 .mcp.json 文件,文件内容如下:
{"mcpServers":{"unityMCP":{"type":"http", "url":"http://localhost:8080/mcp"}}}

这一步必须创建这个文件,不然 Claude 检测不到 UnityMCP,就没办法使用了。
第一次使用 Claude 时,在 Claude 对话窗口中先执行 /init,这样 AI 就会输出更符合自己项目的功能。
可以在对话框中输入 /mcp 选择 MCP server 查看 UnityMCP 是否连接正常。
如下图所示即可正常使用:

在对话框中尝试输入这样的提示词:Create a red, blue and yellow cube


或者尝试这样说:帮我在 AIScene 中创建一个平面和一个角色,角色支持 WASD 移动,移动速度为 5


这样角色就创建好了,运行之后按 WASD 就会按指定速度进行前后左右移动。
这样就算跑通了 UnityMCP+Claude+VSCode 开发游戏的整个流程,后面就可以直接在对话框通过自然语言让 AI 来开发游戏了。
而 Claude 强大的地方在于我们可以添加各种 Skill 和 MCP,定制化开发自己的游戏项目。
Claude+MCP 把 AI 从'聊天机器人'变成了能操作电脑上各种工具的智能体,让我们可以把 AI 当做自己的同事,让其帮自己干活~
在第一次使用时遇到的问题可能是 MCP 和 Claude 的配置问题,导致使用 Claude 对话时没办法正确调用 unityMcp 的功能,可能会显示 MCP 未连接。
{"mcpServers":{"unityMCP":{"type":"http","url":"http://localhost:8080/mcp"}}}
C:\Users\Administrator\AppData\Roaming\Code\User 下配置一个 mcp.json 文件,这样所有的项目工程都能读到这个 mcp 工具的配置。{"mcpServers":{"unityMCP":{"url":"http://localhost:8080/mcp","type":"http"}},"servers":{"unityMCP":{"url":"http://localhost:8080/mcp","type":"http"}}}
如果 Claude 一直检测不到 UnityMCP 的连接,可以直接在对话框中跟它对话,问 AI 为什么没有连接,然后一步步引导 AI 去排查原因即可。
Claude 关于 MCP 连接的文档。通过 MCP 将 Claude Code 连接到工具:https://code.claude.com/docs/zh-CN/mcp
Python 和 uv 没办法正常使用。在 Unity 中点击 StartServer 时不能弹出正确的弹窗,而是提示无法打开指定的文件之类的内容,则需要看下 python 的环境变量有没有配置,或者把报错内容直接发给 AI 进行诊断排查即可。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online