# 如何在 Unity 引擎中使用 Claude Code — AI Game Dev

通过 AI Game Developer 将 Claude Code 连接到 Unity 引擎。分步讲解：安装、配置，以及首次由 AI 驱动的场景检查。

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/blog/claude-code-unity-tutorial)。

[博客](https://ai-game.dev/zh-hans/blog)

通过 AI Game Developer 将 Claude Code 连接到 Unity 引擎。分步讲解：安装、配置，以及首次由 AI 驱动的场景检查。

Ivan Murzak · 2026年1月12日 · 5 分钟阅读 ·

**更新于 2026年10月17日。** 自 Unity-MCP 1.0.0 起，agent 通过 RQL（rql-query、rql-mutate、rql-schema）读取和编辑场景、GameObjects、组件与资源，而不再是每个操作对应一个工具。下面的安装步骤保持不变，CLI 示例使用的是当前的工具名。参见 ai-game.dev/docs/rql 。

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](https://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 项目添加插件。

Bash 终端

```bash
# 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 服务器。

Bash 终端

```bash
# 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”。

Bash 终端

```bash
# 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。

Bash 终端

```bash
# 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 流水线很有用。

Bash 终端

```bash
# 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、等待连接，然后运行工具。下面是一个从零开始完成全部设置的完整脚本。

Bash full-setup.sh

```bash
# 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](https://ai-game.dev/docs/quickstart) 。

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

## 博客更多内容

[全部文章](https://ai-game.dev/zh-hans/blog)

### [从参考图到可直接用于游戏的3D模型——AI Game Developer 内置的 Tripo AI](https://ai-game.dev/zh-hans/blog/tripo-ai-3d-models-from-reference-images)

2026年10月26日

在 AI Game Developer 中用 Tripo 把两到四张参考视图变成一个3D模型，再在同一对话里贴图、清理、绑定骨骼并制作动画。

Ivan Murzak 7 分钟阅读

### [先规划，再动手 —— 游戏开发中 AI Agent 的计划模式](https://ai-game.dev/zh-hans/blog/plan-mode-ai-agent-game-development)

2026年10月26日

在 AI Game Developer 中用计划模式、澄清提问、消息队列和代码审查卡片，在大型游戏任务中掌控 AI Agent。

Ivan Murzak 6 分钟阅读

---

Source (HTML): https://ai-game.dev/zh-hans/blog/claude-code-unity-tutorial

Machine-translated (zh-Hans) from the English page: https://ai-game.dev/blog/claude-code-unity-tutorial