# 面向 Unreal Engine 的 Claude Code 技能 · Dola AI 博客 # 面向 Unreal Engine 的 Claude Code 技能 Epic 为 Unreal Engine 提供的 Claude Code 技能插件包含什么、如何安装、如何配合 Unreal MCP 使用、有哪些限制，以及 Dola 的位置。 最后更新：2026年11月11日 博客标题卡：面向 Unreal Engine 的 Claude Code 技能，配有 Dola 吉祥物 发布于 2026年11月11日 已于 2026 年 11 月 11 日对照以下来源以及 Unreal Engine 5.8.0 源码发布版中的插件文件核实。Unreal MCP 标记为 Experimental，细节可能变化： [Epic: skills plugin for Claude Code](https://github.com/EpicGames/unreal-engine-skills-for-claude-code-plugin), [Anthropic: Claude Code skills](https://code.claude.com/docs/en/skills), [Epic: Unreal MCP](https://dev.epicgames.com/documentation/unreal-engine/unreal-mcp-in-unreal-editor) ## [Claude Code 技能如何工作](#skills) Claude Code 技能是一个包含 SKILL.md 文件的文件夹：先是 YAML 头信息（建议写 description，另有 allowed-tools 等可选字段），后面是 Markdown 指令。当你的请求与技能描述匹配，或你输入 /skill-name 时，Claude Code 会加载该技能。 - **项目技能**放在 .claude/skills//SKILL.md。提交到仓库后，团队也能用。 - **个人技能**放在 ~/.claude/skills//SKILL.md。 - **插件技能**随通过 /plugin 安装的插件一起提供，调用方式为 /plugin-name:skill-name。 Anthropic 的文档建议 SKILL.md 保持在 500 行以内。技能描述在技能列表中超过 1,536 个字符会被截断；对话压缩后，每个技能只保留前 5,000 个 token。Claude Code 运行期间会读取对技能的修改。 ## [Epic 的技能插件包含什么](#epic) Epic 在 GitHub 上以 MIT 许可发布了 **unreal-engine-skills-for-claude-code-plugin**。其 README 将它描述为通过 MCP 从 Claude Code 控制 Unreal Editor 的方式，背后有 30 多个工具集，包括 Actor、蓝图、材质、Niagara、Sequencer 和自动化测试等。 - **unreal-mcp 技能：**如何在 Claude Code 中使用 Unreal MCP，附带设置和日常操作的参考页面。 - **一个 SessionStart 钩子**（unreal-context.sh），告诉 Claude Code 这个仓库是 Unreal 项目。 - **两个配套技能：**create-toolset，以及用于创建和审查技能的 unreal-skill。 ## [安装](#install) README 给出了这些命令。在 Claude Code 中运行： ``` /plugin install unreal-engine-skills-for-claude-code@claude-plugins-official # 如果缺少该插件市场： /plugin marketplace add anthropics/claude-plugins-official ``` 要为整个团队启用，README 的做法是在项目的 .claude/settings.json 中，于 enabledPlugins 下添加 "unreal-engine-skills-for-claude-code@claude-plugins-official": true。 要让它真正派上用场，你需要： - 启用了 **Unreal MCP**（ModelContextProtocol）和 **All Toolsets** 插件的 Unreal Editor。 - 编辑器正在运行且 MCP 服务器已启动（默认自动启动，否则运行 ModelContextProtocol.StartServer）。 - SessionStart 钩子需要 PATH 中有 bash。在 Windows 上请用 Git Bash 或 WSL。 如何把 Claude Code 连接到编辑器，详见[如何用 Claude Code 或 Cursor 设置 Unreal Engine 5.8 MCP](https://dolaai.pro/zh-hans/blog/unreal-engine-mcp-setup)。 ## [技能如何配合 Unreal MCP 工作](#unreal-mcp) 当你要求在打开的项目中执行操作（生成 Actor、编辑蓝图、用 Live Coding 编译）时，unreal-mcp 技能会触发；遇到概念性问题时则不介入。开启工具搜索后，Claude Code 用 list_toolsets 和 describe_toolset 发现工具，再用 call_tool 执行。 - 批量修改前后都要保存：MCP 做的修改并非总能撤销。 - 等待编译完成，并通过 Live Coding 编译 C++。 - 有依赖关系的调用逐个执行，不要并行。 - 任何不是明确成功的结果都要停下来。 - 结果看起来不对时，检查 Play in Editor 是否正在运行。 ### 引擎端的技能是另一回事 Unreal 有自己的“技能”概念。在 5.8.0 源码发布版中，技能是带有描述和指令的引擎对象，通过两个 Unreal MCP 工具 ListSkills 和 GetSkills 提供。Epic 的 unreal-mcp 技能要求 Claude Code 在开始不熟悉的工作时调用 ListSkills，并优先遵循项目自己的技能，而不是通用默认做法。 源码发布版附带的引擎技能涵盖蓝图基础、材质基础、默认室外光照、Niagara（基础、渲染器、优化等）以及 PCG 图生成。Unreal MCP 还有一个 **Instructions** 设置（Editor Preferences > Agentic Workflows > Model Context Protocol；项目级版本通过 DefaultGame.ini 共享），会向每个客户端发送提示。 ## [限制与安全](#limits) - README 提醒："Localhost is not a trust boundary." Unreal MCP 本身没有身份验证。 - execute_tool_script 能以完整编辑器权限运行任意 Python。README 建议不要使用 --dangerously-skip-permissions。 - 长时间会话前先 commit 或 shelve 你的工作；有些修改无法在编辑器中撤销。 - Unreal MCP 是实验性功能，README 也没有写明支持的引擎版本。 - 技能告诉 Claude Code 如何谨慎操作，但结果在游戏中是否正常，仍需你自己检查。 ### 不装插件的 Claude Code 没有 Unreal MCP 时，Claude Code 仍能在终端处理 C++、配置文件和构建，但看不到蓝图资产内部，也看不到正在运行的编辑器。关于这种分工，详见[Claude Code 用于 Unreal Engine 与 UE 原生 AI 的对比](https://dolaai.pro/zh-hans/blog/claude-code-unreal-engine)。 ## [Dola 的位置](#dola) Dola 不属于这套组合。它是一个桌面应用加上自己的 Unreal Editor 插件，面向 Windows 和 Linux 上的 **Unreal Engine 5.7**。它的智能体通过 Dola 的后端运行 Claude，所以你不需要安装 Claude Code、插件市场条目或 MCP 配置。 - **先审查再保留：**每次修改都在 Changes 面板中等待。在 Unreal 中打开差异，然后接受，或拒绝以恢复旧资产。 - **通过试玩做 QA：**QA 智能体会读取图表，并在 Play in Editor 中试玩改动，之后才算完成。 - **按你的环境选择：**如果是已在使用 Claude Code 的 5.8 项目，Epic 的插件是直接的路径。在 5.7 上，Dola 开箱即用，并会检查自己的工作。 2026 年 11 月 9 日 Dola 的一次真实运行：一条提示 "make BP_Lamp blink"，在 PIE 中检查后等待审查。 Dola 桌面应用：一次让 BP_Lamp 闪烁的蓝图运行，显示 QA 代理的 PIE 检查，以及 Changes 面板中待处理的更改 这次运行：Director（Sonnet）规划，Blueprint（Haiku）编辑，QA（Sonnet）读取图表、在 PIE 中运行并发现 0 个编译错误。Auto 模式下花费 $2.34。 Dola 的 Changes 面板，将 BP_Lamp.uasset 列为已编辑，包含 Accept all、Reject all 以及在 Unreal 中打开差异的按钮 Changes 面板会在你保留编辑之前保存它以供审阅。 完整运行过程，一步一步：[看 Dola 如何工作](https://dolaai.pro/zh-hans/see-it-work)。 ## [常见问题](#faq) ### 有。Epic 的 GitHub 组织下有一个 MIT 许可的 Claude Code 插件 unreal-engine-skills-for-claude-code-plugin。其主要技能 unreal-mcp 教 Claude Code 如何通过 Epic 的 Unreal MCP 插件操作 Unreal Editor。 ### README 没有写明引擎版本。它需要 Unreal MCP（ModelContextProtocol）和 All Toolsets 两个插件，我们在 Unreal Engine 5.8.0 源码发布版中找到了它们；编辑器必须在运行，且 MCP 服务器已启动。 ### 能，但有一点要注意：插件的 SessionStart 钩子是 bash 脚本，所以 bash 必须在 PATH 中。在 Windows 上就是 Git Bash 或 WSL；该钩子不能在原生 PowerShell 中运行。 ### 不使用。Dola 是独立产品，有自己的 Unreal Editor 插件，面向 Windows 和 Linux 上的 Unreal Engine 5.7。它的智能体通过 Dola 的后端运行 Claude，而不是通过你安装的 Claude Code。 ## [相关文章](#related) - [用 Claude Code 或 Cursor 设置 Unreal 5.8 MCP](https://dolaai.pro/zh-hans/blog/unreal-engine-mcp-setup) 在 Unreal Engine 5.8 中启用 Epic 实验性的 Unreal MCP，连接 Claude Code 或 Cursor，修复常见错误，并了解它能做什么、不能做什么。 - [Claude Code 用于 Unreal Engine 与 UE 原生 AI 对比](https://dolaai.pro/zh-hans/blog/claude-code-unreal-engine) Claude Code 在 Unreal Engine 项目中擅长什么，没有 MCP 桥接时它无法触及什么，以及它与 UE 原生助手 Dola 的对比。 - [Unreal Engine 蓝图 AI：工具对比](https://dolaai.pro/zh-hans/blog/best-ai-for-unreal-engine-blueprints) 每个 Unreal Engine 蓝图 AI 工具能做什么：Epic 的 AI Assistant 和 Unreal MCP、Aura、Ludus AI、VibeUE、UnrealGenAISupport 和 Dola。不做排名。 - [Unreal Engine 内置 AI Assistant 详解](https://dolaai.pro/zh-hans/blog/unreal-engine-5-7-ai-assistant) Epic 在 Unreal Engine 5.7 中的 AI Assistant 能做什么、如何打开、哪些没有文档说明，以及何时需要能修改并测试项目的智能体。 - [免费使用 Unreal Engine AI：你能得到什么](https://dolaai.pro/zh-hans/blog/unreal-engine-ai-free) 如何免费开始使用 Dola 的 Unreal Engine AI 助手，哪些操作会消耗 AI 积分，如何降低积分消耗，以及何时值得订阅套餐。 - [Unreal Engine AI 生成器：它能生成什么](https://dolaai.pro/zh-hans/blog/unreal-engine-ai-generator) 今天 Unreal Engine AI 生成器能生成什么：蓝图、关卡、材质、界面、C++ 和 3D 模型，以及如何用好它。 - [能编辑你项目的 Unreal Engine AI 聊天](https://dolaai.pro/zh-hans/blog/unreal-engine-ai-chat) 与一个会修改你打开的 Unreal Engine 项目的 AI 聊天：它如何工作、该问什么，以及它与通用聊天机器人有何不同。 - [Unreal Engine AI 智能体：它在编辑器中做什么](https://dolaai.pro/zh-hans/blog/unreal-engine-ai-agent) 什么是 Unreal Engine AI 智能体，它如何在 Unreal 编辑器中读取、规划、执行和检查，以及 Dola 的专业智能体如何让你保持控制。 - [Unreal Engine AI 插件：该看什么](https://dolaai.pro/zh-hans/blog/unreal-engine-ai-plugin) 为什么 Unreal Engine AI 助手需要编辑器插件，Dola 插件及其本地桥接如何工作，以及选择 Unreal AI 插件的检查清单。 - [Unreal Engine AI 工具：哪个适合你的工作](https://dolaai.pro/zh-hans/blog/unreal-engine-ai-tools) 四类 Unreal Engine AI 工具（编辑器助手、AI 编程工具、资产生成器和游戏内 AI），各自擅长什么，以及如何选择。 - [Unreal Engine AI 游戏制作工具：今天什么能做成](https://dolaai.pro/zh-hans/blog/unreal-engine-ai-game-maker) AI 能在 Unreal Engine 中制作游戏吗？今天的 AI 游戏制作工具能在你自己的项目中逐个功能真正构建什么，以及哪些工作仍需你来完成。 - [什么是 Dola AI？Unreal Engine AI 助手](https://dolaai.pro/zh-hans/blog/what-is-dola-ai) Dola AI 是面向 Unreal Engine 的 AI 助手：Dola 桌面应用加上用于蓝图和 C++ 的编辑器插件。与其他名为 Dola 的应用无关。 - [Dola 应用下载：Windows 和 Linux](https://dolaai.pro/zh-hans/blog/dola-app-download) 如何下载适用于 Windows 或 Linux 的 Dola AI 桌面应用，安装、登录，并将 Unreal Engine 5.7 插件连接到你的项目。 - [Dola 登录：登录、重置密码、修复错误](https://dolaai.pro/zh-hans/blog/dola-login) 如何在 dolaai.pro 和桌面应用中登录 Dola AI、创建账户、重置密码，以及修复常见的 Dola 登录问题。 - [Dola AI 助手：Unreal 的聊天与智能体](https://dolaai.pro/zh-hans/blog/dola-ai-assistant-unreal-engine) Dola 的聊天和专业智能体在 Unreal Engine 中如何工作：一个聊天窗口，配有蓝图、C++ 和材质专家，直接编辑你打开的项目。 - [Unreal Engine AI：NPC AI 与开发者助手](https://dolaai.pro/zh-hans/blog/unreal-engine-ai-npc-vs-assistant) “Unreal Engine AI”可以指游戏 NPC AI、Epic Developer Assistant 或第三方编辑器插件。Dola 属于最后一类：不是行为树，也不是 Epic 的面板。 - [建模模式是 Babylon 工作室，而不是 Unreal](https://dolaai.pro/zh-hans/blog/modeling-mode-babylon-studio) Dola 建模模式如何将聊天变为实时 Babylon 网格、检查命名部件并导出 GLB，与 Unreal 的蓝图和 C++ 路径相互独立。 - [Dola 为 Unreal Engine 开发者做什么](https://dolaai.pro/zh-hans/blog/what-dola-is-for-unreal-developers) Dola AI（dolaai.pro）是一款本地优先的 Unreal Engine 助手，面向蓝图和 C++：Dola 桌面应用加上 Unreal 编辑器插件。 [更多 Dola 博客文章](https://dolaai.pro/zh-hans/blog) [在你的项目里试试我！](https://dolaai.pro/signup) [看它工作](https://dolaai.pro/zh-hans/see-it-work)[免费注册](https://dolaai.pro/signup)