# Claude Code 游戏开发，接入真正的游戏引擎

> Claude 是很强的程序员，但它看不到你的游戏。把它连接到 Summer，它就能搭建场景、编写脚本、运行游戏、读取报错，并查看实际效果。

- URL: https://www.summerengine.com/zh/claude-code-game-development
- Keyword: Claude Code 游戏开发

**简短回答:** 当 Claude 不只是写文件、还能操作引擎时，Claude Code 游戏开发的效果最好。Summer MCP 为 Claude Code 提供 80 多个工具，可以查看和编辑场景、编写 GDScript、运行游戏、发送输入、读取运行时状态和报错、截图，以及生成 3D、图像和音频素材。安装只需一条命令，`npx -y summer-engine@latest setup claude-code --yes`。

Claude Code 几秒钟就能写出一个玩家控制器。但它自己做不到的是，打开你的项目，发现角色穿过了地板，再去修正碰撞层。没有引擎连接，你就得当它的眼睛，运行游戏、描述哪里坏了、再把报错粘贴回去。

Summer 补上了这个闭环。它是一款兼容 Godot 4 项目的桌面游戏引擎，自带 MCP 服务器，把编辑器和运行中的游戏开放给你的代理。Claude 会编辑场景树、挂载脚本、点击运行、发送输入，读取带帧号的状态和截图，并查看调试器。然后修复它发现的问题。

你的 Claude 订阅和终端都照常使用。Summer 在此基础上加入引擎、游戏开发专用技能和素材生成器。

## 功能

- **场景与节点:** 读取场景树，添加和删除节点，设置属性，实例化场景，连接信号并保存。
- **脚本与报错:** 编写和编辑 GDScript 文件，并在声称修复完成之前，先查看脚本错误、调试器错误和警告。
- **运行并探查游戏:** 启动和停止游戏，发送脚本化输入，逐帧推进，读取带帧号的运行时状态和截图。
- **亲眼看到结果:** 编辑器和游戏截图、世界快照以及前后对比差异，让 Claude 检查画面，而不是靠猜。
- **生成素材:** 图像、精灵图集、带骨骼和动作的 3D 模型、配音、音效和音乐，直接导入项目。
- **游戏技能库:** 可搜索的技能、示例和模板，教会 Claude 引擎相关的开发模式，从平台跳跃移动到多人游戏状态同步。

## 工作方式

1. **安装 Summer:** 下载适用于 macOS（Apple 芯片）或 Windows 的免费 Summer 桌面应用，打开或新建一个项目。
2. **连接 Claude Code:** 运行 `npx -y summer-engine@latest setup claude-code --yes`。它会把 Summer MCP 注册到 Claude Code。出现提示时，用 `npx summer-engine login` 登录。
3. **描述你的游戏:** 用日常语言让 Claude 做一个功能。它会在动手前先读取项目上下文和相关技能。
4. **让它自己验证:** Claude 会运行游戏，检查诊断信息和截图，反复迭代直到功能正常。你只需审查代码差异。

## 在 Studio 中，或在你正在用的 AI 代理里

### 在 Summer Studio 中

不想用终端？Summer 桌面应用内置了拥有同样引擎工具的代理，网页版 Studio 则负责素材生成。Claude Code 和应用内代理操作的是同一套项目文件。

[查看 Claude Code 设置指南](https://www.summerengine.com/zh/mcp/how-to-make-games-in-claude-code)

### 通过 MCP 在 Claude、Cursor 或 Codex 中使用

完成设置后，Claude Code 会自动识别 summer_* 工具。第一个请求不妨让 Claude 读取项目上下文，做一个小功能，运行它，并汇报它验证了哪些内容。

给代理的示例提示词:

```text
先读取 Summer 项目上下文，然后给玩家加上带土狼时间的二段跳。运行游戏，发送两次跳跃输入，在探针中确认玩家能跳上上方的平台，并给我看一张截图。
```

[配置 Summer MCP](https://www.summerengine.com/zh/mcp)

## 目前 Claude Code 配合 Summer 能做和不能做的事

| 任务 | 状态 | 说明 |
| --- | --- | --- |
| 编辑场景、节点和脚本 | 支持 | 需要在同一台电脑上打开 Summer 桌面应用 |
| 运行游戏并读取报错 | 支持 | 运行、停止、输入、逐帧推进、诊断 |
| 查看游戏画面 | 支持，以静态画面形式 | 截图和快照，暂无视频录制工具 |
| 生成 3D、图像和音频 | 支持 | 无需打开引擎，需要付费套餐或充值 |
| 在浏览器版 claude.ai 中使用 | 暂不支持 | Summer MCP 在本地运行，目前没有托管的网页连接器 |
| 签名并提交到商店 | 由你完成 | 导出取决于已安装的导出模板，签名和提交商店仍由你负责 |

## 费用

- 图像，Nano Banana 2 Lite（1K）: $0.04 (估算)
- 3D 模型，Hunyuan 3D v3.1 Pro: $0.53
- 音效，5 秒: $0.01

通过 MCP 使用的引擎和项目工具都是免费的。Claude 的费用照常支付给 Anthropic。只有素材生成会消耗 Summer 套餐额度或充值。

费用从你的 Summer 使用余额中扣除。生成素材需要付费套餐或充值。Pro 每月 $20，含 $20 使用额度，充值 $5 起。桌面引擎本身免费下载。

## 好用的提示词和生成结果

这些请求展示了接入引擎的 Claude 在一次会话里能做到什么。

### 修复物理 bug

- 提示词: 玩家有时会从移动平台上掉下去。复现这个问题，找到原因并修好。
- 你会得到: Claude 用脚本化输入运行游戏，读取出错那一帧的运行时状态，调整碰撞设置，再重新运行确认。

### 端到端实现一个功能

- 提示词: 加一个卖三件商品的商店 NPC、HUD 上的金币计数器和购买音效。
- 你会得到: 新的场景和脚本、一个生成的音效、HUD 节点，以及一次检查购买流程的试玩。

### 填充关卡

- 提示词: 生成五块低多边形岩石和两棵树，散布在出生点周围，不要挡住道路。
- 你会得到: 生成的 3D 素材经过碰撞检查后摆放在地形上，并附上一张结果截图。

### 调整手感

- 提示词: 跳跃感觉太飘了。让它更干脆利落，并给我看改动前后的对比。
- 你会得到: 调整后的重力和跳跃参数，附带两个版本的探针读数和截图。

[浏览 Summer 技能](https://www.summerengine.com/zh/skills)

## 为什么连接引擎比只改文件更有效

游戏出问题的方式往往在代码里看不出来，比如节点放错了位置、信号从没连上、精灵被缩放到零、脚本能编译却从未执行。只能编辑文件的代理只能靠猜。能运行游戏并读取状态的代理则可以去核实。

Summer 的工具就是围绕这种核实来设计的。运行时探针返回带帧号的状态，Claude 可以对比某个操作前后的变化。诊断功能会把永远不会出现在控制台里的运行时错误暴露出来。截图则确认画面结果。

## 开源的代理层

Summer CLI、MCP 服务器、技能和插件清单均以 MIT 协议开源。桌面应用可免费下载。托管 AI、素材生成和云端功能是 Summer 的付费服务。

## 常见问题

### Claude Code 能做出一款完整的游戏吗？

只要能操作引擎，Claude Code 就能构建并不断迭代一款完整的游戏。配合 Summer，它会编辑场景和脚本、运行游戏，并修复出问题的地方。设计方向和结果审查仍然由你来把握。

### 怎么把 Claude Code 连接到 Summer？

先安装 Summer 桌面应用，然后在终端里运行 `npx -y summer-engine@latest setup claude-code --yes`。这条命令会把 MCP 服务器注册到 Claude Code，再用 `npx summer-engine login` 登录即可。

### 能用于 Godot 项目吗？

Summer 兼容 Godot 4 项目，所以 Claude 可以处理标准的场景和 GDScript。在进行大规模迁移之前，请先查看针对你项目的兼容性说明。

### 需要订阅 Summer 吗？

做引擎相关的工作不需要。引擎和项目工具都是免费的。素材生成需要 Summer 付费套餐或充值。Claude 本身由 Anthropic 计费。

### Cursor 或 Codex 也能用吗？

能。同一个 MCP 可以安装到 Cursor、Codex、Gemini CLI、Cline 等代理中。具体请查看各自的 MCP 指南。

### Claude 能看到正在运行的游戏吗？

能，通过截图、运行时探针和运行中游戏的快照。它处理的是静态画面，目前还没有视频录制工具。

### 可以在浏览器版 claude.ai 中使用吗？

目前不行。Summer MCP 在引擎旁边本地运行，所以适用于 Claude Code 这类桌面和终端代理。

## 相关工具和指南

- [如何用 Claude Code 做游戏](https://www.summerengine.com/zh/mcp/how-to-make-games-in-claude-code)
- [Claude 用于 Godot](https://www.summerengine.com/zh/blog/claude-for-godot)
- [Godot MCP 服务器指南](https://www.summerengine.com/zh/blog/godot-mcp-servers-guide)
- [Cursor 用于 Godot](https://www.summerengine.com/zh/cursor-for-godot)
- [Godot AI 编程助手](https://www.summerengine.com/zh/godot-copilot)
- [Summer CLI](https://www.summerengine.com/zh/cli)
- [面向 AI 代理的 Summer](https://www.summerengine.com/zh/for-ai)
- [AI 游戏 3D 模型生成器](https://www.summerengine.com/zh/ai-3d-model-generator-for-games)

[设置 Summer MCP](https://www.summerengine.com/zh/mcp)

---

## Machine-readable resources

- Site index for agents: https://www.summerengine.com/llms.txt
- Full inlined content: https://www.summerengine.com/llms-full.txt
- Porting catalog: https://www.summerengine.com/llms-porting.txt
- Structured catalog: https://www.summerengine.com/agent-catalog.json
- Sitemap: https://www.summerengine.com/sitemap.xml
- Developer resources: https://www.summerengine.com/docs
- Summer API (assets from any agent or code; public per-call model prices): https://docs.summerengine.com/api