10 月 18 日,Epic 那个能让 Claude Code 直接操作 Unreal 编辑器的插件在 X 上刷屏了,不少帖子说它是刚发布的。其实不是。Epic 6 月就把这个插件放上了 GitHub,Anthropic 官方的 Claude Code 插件市场在北京时间 6 月 27 日收录了它,最近一次更新在 9 月。下面的步骤都按 Epic 的 README 和文档写,我们自己没有实际装过。
这个插件把 Claude Code 连到 Unreal MCP 上,Unreal MCP 是跑在 Unreal 编辑器里的一个服务。按 Epic 的说法,它提供 30 多个工具集、几百个编辑器工具,涵盖 Actor、蓝图、材质、Niagara、Sequencer、State Tree、UMG 控件、Gameplay Ability System 和自动化测试等。Epic 的文档把 Unreal MCP 标成实验性功能,提醒很多部分还不完整,以后也可能会变。
第一步:在 Claude Code 里装插件
插件在 claude-plugins-official 这个市场里,Claude Code 启动时会自动加载它。在 Claude Code 里运行“/plugin install unreal-engine-skills-for-claude-code@claude-plugins-official”。如果看不到官方市场,先运行“/plugin marketplace add anthropics/claude-plugins-official”把它加上,再运行一次安装命令。也可以在 /plugin 面板的 Discover 标签页里找到它。
团队一起用的话,Epic 建议把插件加进项目 .claude/settings.json 里的 enabledPlugins。谁信任了这个项目文件夹,就会收到安装提示。
第二步:在编辑器里开启 Unreal MCP
在 Unreal 编辑器里打开 Edit 菜单下的 Plugins,把 Unreal MCP 和 All Toolsets 都勾上,按提示重启编辑器。两个都要开。Unreal MCP 是服务本身,具体的工具由 All Toolsets 提供,不开它的话服务里什么工具都没有。
第三步:启动服务
打开编辑器的控制台(默认按反引号键打开),输入“ModelContextProtocol.StartServer”。服务会在本机的 8000 端口、/mcp 路径上监听。端口被占了的话,在命令后面加一个别的端口号。想让它每次自动启动,就去 Editor Preferences 的 General 里找到 Model Context Protocol,打开 Auto Start Server。
第四步:生成连接文件
插件本身不带 MCP 配置文件。在编辑器控制台输入“ModelContextProtocol.GenerateClientConfig ClaudeCode”,它会在项目根目录写一个 .mcp.json,指向正在运行的服务。以后改了端口或路径,再运行一次就行。
第五步:在项目根目录启动 Claude Code,确认连上了
等编辑器和服务都跑起来,再从写了 .mcp.json 的那个文件夹启动 Claude Code。Epic 建议确认三件事:编辑器的 Output Log 里有 MCP 服务启动的信息;Claude Code 里 /plugin 的 Installed 标签页显示插件已启用;/mcp 里能看到 unreal-mcp。然后试一句简单的,比如“List all actors in the current level”。
如果 Claude Code 找不到服务,Epic 的文档建议先确认是不是在有 .mcp.json 的文件夹里启动的,再试试先开编辑器后开 Claude Code,或者重新连接 MCP 服务。
Windows 要装 Git Bash 或 WSL
插件带了一个启动钩子,是个 bash 脚本,作用是告诉 Claude 这个文件夹是 Unreal 项目,按 Unreal 的规矩来。macOS 和 Linux 直接就能用。Windows 上要装 Git for Windows(自带 Git Bash),或者在 WSL 里跑 Claude Code。只用 PowerShell 的话这个钩子跑不起来。按 README 的说法,这种情况下编辑器工具照样能用,只是每次开会话时少了那段项目说明。
注意 Claude 能碰到什么
Epic 的 README 把风险写得很直白。装上插件,Claude 就能大范围、实时地操作正在运行的编辑器,其中一个工具还能在编辑器里执行任意 Python 脚本,对项目有完全的访问权限。Epic 建议加载这个插件时不要用 Claude Code 的 --dangerously-skip-permissions 参数,长时间操作前先保存并提交,出了意外改动也能退回去。服务只接受本机的连接,但 Epic 提醒它没有自己的登录验证,同一个用户下跑的任何程序都能连上,所以别在共用或者不信任的电脑上开。
