如何在 Unity 引擎中使用 Claude Code

Claude Code 是目前最出色的 AI agent 之一，由 Opus 4.5 等模型驱动。在本教程中，我们将它直接连接到 Unity 引擎，让它能够读取你的场景、调用 Unity API 并修改你的项目——全程都在终端中完成。

准备工作

• Unity 2021.3 或更高版本
• Node.js ^20.19.0 或 >=22.12.0（用于 CLI）
• 已安装 Claude Code（基于终端的 AI agent）
• AI Game Developer——AI agent 与 Unity 之间的桥梁：github.com/IvanMurzak/Unity-MCP

安装 AI Game Developer

AI Game Developer 充当先进 AI agent 与模型和 Unity 引擎之间的桥梁。你可以通过 Unity 编辑器手动安装，也可以使用 CLI 完成全自动安装。

方案 A：手动安装（Unity 编辑器）

1. 从 AI Game Developer 的 GitHub 页面下载安装包
2. 双击安装包文件，在 Unity 中打开它
3. 在 Unity 的导入窗口中点击“Import”
4. 等待 Unity 完成编译

方案 B：CLI 安装（推荐）

unity-mcp-cli 工具可以在命令行中自动完成整个安装流程——无需手动点击。先全局安装它，然后用它为任意 Unity 项目添加插件。

# Install the CLI globally
npm install -g unity-mcp-cli

# Install the AI Game Developer plugin into your Unity project
unity-mcp-cli install-plugin ./MyUnityProject

install-plugin 命令会直接修改项目的 Packages/manifest.json——它会添加 OpenUPM 作用域注册表和插件依赖。它绝不会降级已有安装。运行完成后，在 Unity 中打开该项目以完成包的安装。

配置连接

包导入后，会出现 AI Game Developer 窗口。向下滚动找到 Claude Code 区域并点击“Configure”——这就是所需的全部配置。然后点击“Connect”开始连接流程。一开始你会看到错误，因为 Claude Code 尚未运行——这是正常现象。

CLI：为 Claude Code 配置 MCP

CLI 可以自动为 Claude Code 配置 MCP 集成——无需使用 Unity 编辑器界面。它会写入正确的配置文件，使 Claude Code 在启动时发现 AI Game Developer 服务器。

# Configure Claude Code MCP integration
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

# Generate skill files so Claude Code knows about available tools
unity-mcp-cli setup-skills claude-code ./MyUnityProject

启动 Claude Code

你可以从 Visual Studio Code 启动 Claude Code，也可以直接在终端中启动。本教程采用终端方式。在 Unity 项目文件夹中打开终端——你可以在 Unity 的 Assets 文件夹中右键单击，选择“Show in Explorer”，然后右键单击并选择“Open in Terminal”。

# Navigate to your Unity project folder and start Claude Code
cd /path/to/your/unity/project
claude

Claude Code 启动后，AI Game Developer 窗口中的状态会变为“Connected”。要验证一切正常，在 Claude Code 中输入 /mcp——你应该会看到“AI Game Developer”已被列出并处于已连接状态。

在 Unity 场景中测试 AI

连接建立后，试着问 AI 类似“你在 Unity 项目的这个场景里看到了什么？”的问题。AI 会使用 AI Game Developer 提供的 MCP 工具读取你的场景层级、检查 GameObjects，并汇报它的发现。它会一步步迭代——读取场景数据、检查嵌套对象，逐步构建出项目的完整图景。

当 Claude Code 请求使用某个工具的权限时，你可以选择选项 2 来允许它，并跳过之后对同一工具的提示。随后 AI 会读取你的场景，识别网格、灯光和嵌套层级等对象，并对它的所有发现给出详细描述。

优化上下文

AI Game Developer 会向 AI 暴露许多 MCP 工具。一个关键技巧：禁用你不需要的工具。每个启用的工具都会占用 AI 上下文，保持上下文干净能让 AI 更高效地工作并产出更好的结果。你可以在 AI Game Developer 窗口中开关工具——也可以使用 CLI。

# List current tool/prompt/resource configuration
unity-mcp-cli configure ./MyUnityProject --list

# Enable only the tools you need
unity-mcp-cli configure ./MyUnityProject \
  --enable-tools rql-query,rql-mutate,rql-schema,script-update-or-create \
  --disable-all-prompts

# Or enable everything at once
unity-mcp-cli configure ./MyUnityProject \
  --enable-all-tools \
  --enable-all-prompts

• 禁用你不使用的工具，保持 AI 上下文精简
• 如果你不需要 Resources，可以考虑将其禁用
• Prompts 就是斜杠命令——在 Claude Code 中输入 / 即可查看可用命令，例如“set up an animation”或“add a component”
• 查看 Connected 状态指示器，确认连接处于活动状态

接下来你可以做什么

Claude Code 连接到 Unity 后，你可以让 AI 做 MCP 工具支持的任何事情——检查场景、创建 GameObjects、修改组件、生成动画、构建 UI，等等。AI 可以使用一整套全面的工具，并能根据你的自然语言提示调用其中任意一个。

你也可以不经过 AI，直接从命令行运行 MCP 工具，这对编写脚本和 CI 流水线很有用。

# Check connection status at a glance
unity-mcp-cli status ./MyUnityProject

# Run an MCP tool directly from the CLI
unity-mcp-cli run-tool rql-query ./MyUnityProject --input '{"query":"objects | where name == \"Player\" | select $ref name transform.position"}'

# Run Unity tests via MCP
unity-mcp-cli run-tool tests-run ./MyUnityProject --input '{"testMode":"EditMode"}'

全自动化：从零到连接完成

CLI 可以将整个工作流自动化——创建项目、安装插件、配置 Claude Code、打开 Unity、等待连接，然后运行工具。下面是一个从零开始完成全部设置的完整脚本。

# 1. Create a new Unity project
unity-mcp-cli create-project ./MyAIGame --unity 6000.3.1f1

# 2. Install the AI Game Developer plugin
unity-mcp-cli install-plugin ./MyAIGame

# 3. Enable all MCP tools
unity-mcp-cli configure ./MyAIGame --enable-all-tools

# 4. Configure Claude Code MCP integration
unity-mcp-cli setup-mcp claude-code ./MyAIGame

# 5. Open the project with MCP connection
unity-mcp-cli open ./MyAIGame --keep-connected

# 6. Wait for Unity and MCP server to be ready
unity-mcp-cli wait-for-ready ./MyAIGame

# 7. Generate Claude Code skills
unity-mcp-cli setup-skills claude-code ./MyAIGame

# 8. Verify by running a tool
unity-mcp-cli run-tool tests-run ./MyAIGame --input '{"testMode":"EditMode"}'

开始使用

AI Game Developer 是开源的。安装 Unity 包、配置 Claude Code，然后开始输入提示。CLI 工具已在 npm 上发布，可用于自动化工作流。详细安装说明请查阅快速入门指南 ai-game.dev/docs/quickstart 。

• AI Game Developer（Unity-MCP）：github.com/IvanMurzak/Unity-MCP
• AI 动画扩展：github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md
• CLI 工具：npmjs.com/package/unity-mcp-cli
• 下载：ai-game.dev/download
• 下一篇：用 AI 生成动画——ai-game.dev/blog/generating-unity-animations-with-ai