UnityMCP + Claude + VSCode 搭建 AI 游戏开发工作流

如果不打算连接 Claude，此时已可直接通过 VSCode 进行 Unity 的 AI 开发。接下来我们接入 Claude。

2. 安装 VSCode 插件

在 VSCode 扩展市场中搜索并安装以下插件：

• Unity
• Claude Code For VS Code

安装完成后，VSCode 侧边栏会出现 Claude 对话按钮，点击即可打开对话框。

3. 安装 Claude CLI

为了在本地运行 Claude Code，需要安装 Node.js 环境并通过 npm 全局安装 CLI 工具。

# 检测 npm 版本
npm -v

# 安装 claude code cli
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

如果网络受限导致安装失败，可尝试调整 npm 镜像地址至国内源。为了方便在不同 API Key 之间切换，推荐使用 cc-switch 工具管理密钥。

4. 配置 MCP 连接

在 Unity 工程目录下创建 .mcp.json 文件，内容如下：

{
  "mcpServers": {
    "unityMCP": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

这一步至关重要，否则 Claude 无法检测到 UnityMCP，也就无法调用相关功能。

5. 开始开发

首次使用时，在 Claude 对话框中输入 /init，AI 会输出更符合项目上下文的功能说明。随后可输入 /mcp 查看 MCP server 连接状态。

测试提示词示例：

• Create a red, blue and yellow cube
• 帮我在 AIScene 中创建一个平面和一个角色，角色支持 WASD 移动，移动速度为 5

输入指令后，AI 会自动操作 Unity 编辑器完成场景构建。运行游戏后，按 WASD 键即可控制角色按指定速度移动。

至此，UnityMCP + Claude + VSCode 的开发流程已跑通。后续可以直接在对话框通过自然语言让 AI 协助开发游戏逻辑。Claude 的强大之处在于可以添加各种 Skill 和 MCP，定制化开发自己的游戏项目，将 AI 从'聊天机器人'转变为能操作电脑工具的智能体。

常见问题排查

如果在初次使用时遇到 MCP 未连接或无法调用功能的错误，可参考以下步骤排查：

1. 检查配置文件位置：确保 Unity 项目根目录下存在 .mcp.json 文件，且内容格式正确。
2. 全局配置：若希望所有项目都能读取该配置，可在 VSCode 全局目录 C:\Users\Administrator\AppData\Roaming\Code\User 下配置 mcp.json。

   {"mcpServers":{"unityMCP":{"url":"http://localhost:8080/mcp","type":"http"}}}
   

3. 引导 AI 排查：如果 Claude 仍检测不到连接，直接在对话框询问 AI 原因，让它一步步引导你检查日志和环境变量。
4. Python 环境问题：若 Unity 中点击 StartServer 时提示无法打开指定文件，通常是因为 Python 环境变量未配置。可将报错信息发送给 AI 进行诊断。
5. 官方文档：更多 MCP 连接细节可参考 Claude Code MCP 文档。

总结

这套组合拳将 AI 的认知能力与 Unity 的创作能力深度融合。无论是独立开发者还是小型团队，都能借助此环境快速验证想法、减少技术债务，将更多精力聚焦于创意本身。随着 AI 模型的进化与 MCP 生态的完善，这种模式有望成为游戏开发的标配。