用 Claude Code Skills 完整开发 Godot 游戏
实战案例展示如何用 Claude Code Skills 快速构建完整 Godot 游戏,演示 AI 编程工具在游戏开发中的真实应用能力。
完整中文译文
面向 Godot、Bevy 和 Babylon.js,使用 Claude Code 与 Codex 进行自主游戏开发。
观看演示 · Prompts
描述一款游戏。Agent 会构建游戏、生成素材、运行引擎并验证结果——你在场时,可以观看并操控实时运行的游戏;你不在场时,则会得到录制的视频。在运行过程中,Agent 会根据实际情况自行判断采用哪种方式。
这个 repo 本身不是游戏,而是一个游戏生成器的源码,其工作流程是:godogen -> game repo -> game。你需要先将其发布到一个全新的 game repo,并选择游戏引擎和 host-agent 类型;随后,Agent 会在该 repo 内运行,根据一份简短的引擎指南构建真正的游戏。
发布后的 repo 会刻意保持精简,只包含 runtime manifest、一页式引擎指南和素材生成 skill。其余所有内容,包括项目脚手架和录制工具,都会由 Agent 根据指南重新创建。
prompts/runtime.md— runtime manifestasset-gen/— 跨引擎素材生成 skillengines/babylon.md、engines/godot.md、engines/bevy.md— 各引擎对应的指南publish.sh— 根据所选引擎和 host agent 渲染 runtime 布局
引擎和 host agent(Claude 或 Codex)是在发布时进行渲染的选项,而不是相互独立的源码树。
- Godot 4 — 使用 C#/.NET 的项目,支持构建时场景生成、runtime scripts 和 Jolt physics。
- Bevy — 使用 Rust/Bevy 的项目,采用 code-first ECS 场景并支持 offscreen capture。
- Babylon.js — 使用 TypeScript/Vite 的浏览器游戏,通过实时 URL 提供访问。
- 素材生成 — 使用 Gemini 生成精确的参考图和角色,使用 xAI Grok 生成纹理和简单物体,使用 Tripo3D 完成 image-to-3D 和带骨骼的双足角色动画;动画 sprites 则通过 Grok video 生成,并进行循环检测和背景移除。
- 以验证结果为准,而非仅凭声称 — Agent 会根据实际运行中的游戏结果(实时 URL 或录制片段)进行判断,而不是以成功编译作为完成标准,因此任何可见缺陷都会推动下一轮迭代。
- 参与程度由你决定 — 你可以观看实时游戏(Babylon.js URL,或者由你运行的 Godot/Bevy 项目),并在决策节点进行引导;也可以让整个过程无人值守,最后获得一段 15–20 秒的验证录像。Agent 会根据你描述任务的方式判断该如何配合。
Godot 项目要求 PATH 中包含 Godot 4(.NET build)。
Bevy 项目要求安装 Rust/Cargo。
Babylon.js 项目要求安装 Node.js 22.12+ 和 npm。
Babylon.js 浏览器录制要求安装支持硬件 WebGL2 的 Chrome 或 Chromium。
API keys 需设置为环境变量:
-
GOOGLE_API_KEY— 用于通过 Google AI Studio 调用 Gemini 生成图像 -
XAI_API_KEY— 用于通过 xAI Grok 生成图像和视频 -
TRIPO3D_API_KEY— 用于通过 Tripo3D 生成 3D 内容 -
GOOGLE_API_KEY— 用于通过 Google AI Studio 调用 Gemini 生成图像 -
XAI_API_KEY— 用于通过 xAI Grok 生成图像和视频 -
TRIPO3D_API_KEY— 用于通过 Tripo3D 生成 3D 内容
还需要安装 setup.md 中列出的系统软件包:vulkan-tools、xvfb、ffmpeg、imagemagick,以及各平台特有的额外依赖。
已在 Ubuntu、Debian 和 macOS 上完成测试。
选择引擎和 host agent:
./publish.sh --engine godot --agent claude --out ~/my-game # CLAUDE.md + .claude/skills/
./publish.sh --engine babylon --agent codex --out ~/my-game # AGENTS.md + .agents/skills/
./publish.sh --engine bevy --agent claude --out ~/my-game
传入 --force,可在重新发布前清空目标位置中的现有内容。
一次完整的生成过程可能需要数小时,因此将任务交给服务器运行会更加方便。最好使用 GPU 实例,因为硬件加速能够显著提升引擎渲染和视频录制速度。
使用 tmux 或 screen,即使 SSH 连接中断,也能让 session 持续运行。
启用远程控制后,你可以通过任何设备随时查看并引导运行过程——Claude Code 和 Codex 都提供官方的远程控制界面。
关注进展:@alex_erm