不会编程也能用 Godot 和 Agent 做出第一个小游戏

这篇文章，就能让你的 Agent 猛写游戏。 把本文（页面右上角有一键复制，连同提示词和网址）直接交给 Claude Code、Codex 这样的 Agent，它就知道怎么用 Godot 一步步写出能玩的游戏：怎么建项目、怎么写、怎么自己跑命令查错、怎么按你的话一点点改。你不用懂代码，只管说想要什么、按 F5 试玩、告诉它哪里不对。

你会得到什么

用免费的游戏引擎 Godot，加上一个 AI Agent（Claude Code、Codex 等），做出你的第一个小游戏：一个方块在屏幕上躲避掉下来的障碍，能计分、能重新开始。

不需要会编程。 代码由 Agent 来写，你负责三件事：说清楚想要什么、按一下运行、告诉它哪里不对。

这个教程只做最简单的 2D 小游戏，目的是让你完整走一遍"想法 → 能玩"的流程。做复杂游戏是以后的事。

先认识几个词

Godot：一个免费、开源（MIT 许可证）的游戏引擎，不用注册账号。你可以把它理解成"做游戏的软件"。
GDScript：Godot 自带的编程语言，写法接近 Python，Agent 很熟。
项目：一个文件夹，里面有一个叫 project.godot 的文件，Godot 靠它认出这是个游戏。
场景（scene）：游戏里的一个"画面"，文件后缀是 .tscn。

第 1 步：安装 Godot（5 分钟）

打开官网 godotengine.org/download，下载你电脑系统对应的版本。
选普通版，不要选带 ".NET" 或 "C#" 的版本。新手用 GDScript 就够了，Agent 写它也更稳。
下载下来是个压缩包，解压后就能运行，不用安装。

截至写这篇教程时，官方最新的稳定版是 4.7.2。版本号以 4 开头的都行，不要下 3.x，那是老版本，写法不一样。

想用命令安装也可以：Mac 用 brew install godot，Windows 用 scoop install godot（需要先装 Scoop）。这样 Godot 会直接出现在命令行里，后面让 Agent 帮你检查错误时更方便。

第 2 步：新建一个空项目

打开 Godot，会看到项目管理器。点 New Project（新建项目）。
起个名字，比如 my-first-game，选一个空文件夹放它。
其他选项保持默认，点创建。

这时文件夹里会出现 project.godot。先别急着在 Godot 里点来点去，接下来交给 Agent。

第 3 步：让 Agent 写游戏

打开终端，进到刚才的项目文件夹，启动 Claude Code（或你用的其他 Agent）：

cd 你的项目文件夹路径
claude

然后把下面这段话发给它：

这段关键内容需要登录后解锁

新用户注册就送 10 积分，每天签到再领 1 积分。用 1 积分解锁，以后随时回来都能看。

它会创建 main.tscn、main.gd，并改好 project.godot。

为什么这样要求： 不用图片素材，Agent 就不会因为缺文件出错；全部写在一个脚本里，你以后看起来、改起来都简单。

第 4 步：运行游戏

回到 Godot 项目管理器，如果列表里没有你的项目，点 Import（导入），选项目文件夹里的 project.godot。
打开项目，进入编辑器。
按 F5（或者点右上角的"运行项目"播放按钮）。游戏窗口弹出来，用方向键玩。

如果 Godot 提示某些文件在磁盘上被修改了，选重新加载。因为文件是 Agent 改的，不是你在 Godot 里改的。

第 5 步：让 Agent 自己查错

Agent 写的代码有时有语法错误。你不用自己看，让它自己跑一遍：

用命令行检查一下这个项目有没有报错：
godot --headless --path . --quit-after 120
把输出里的错误读一下，有错就修。

这条命令让 Godot 在不开窗口的情况下把游戏跑 120 帧就退出，错误会打印在终端里。（如果提示找不到 godot，说明它不在命令行路径里，让 Agent 用你解压出来的 Godot 程序的完整路径代替。）

第 6 步：一点一点改

游戏能跑之后，用大白话告诉 Agent 哪里不对、想要什么：

"红色方块掉得太快，慢一点。"
"再加一种绿色方块，吃到加 5 分。"
"游戏结束后显示历史最高分。"
"我想要有 3 条命，碰一次扣一条。"

几个让你省心的习惯：

一次只改一件事，改完运行一下，确认没坏再改下一件。
报错就把错误原文复制给 Agent，不要自己概括。Godot 底部的"输出"和"调试器"面板里有错误信息。
每次能玩了，就存档一次。 让 Agent 执行 git init 并提交一次。改坏了可以退回，不会从头来。

第 7 步：下一步学什么

看官方教程。 Godot 官方文档有一套完整的 2D 入门教程 "Dodge the Creeps!"，和我们做的游戏很像。读它能让你看懂 Agent 写的东西。官方说明它假设你有一点编程经验，纯新手可以先看文档里的脚本入门部分，或者边读边问 Agent。
加素材。 想把色块换成真正的图片和声音，先找免费、允许商用的素材，然后问 Agent 怎么导入。
试试 MCP 工具。 社区有让 Agent 直接控制 Godot 编辑器的 MCP 工具，比如 godot-mcp，能启动编辑器、运行项目。上手前用不着，等你熟悉基本流程后再试。

常见问题

Agent 写出来的代码一堆红字报错。 最常见的原因是它用了 Godot 3 的老写法。回它一句"请只用 Godot 4 的 GDScript 语法"，再把错误原文贴给它。
窗口一闪就没了。 多半是脚本里有错。按第 5 步让 Agent 用命令行检查。
按 F5 提示没有主场景。 说明 project.godot 里没设好主场景，让 Agent 检查 run/main_scene 这一项。
想用 C#。 先别。新手用 GDScript，官方也推荐它作为入门语言。

注意

Agent 会改你项目里的文件。 所以建议在一个专门的空文件夹里做，别放在重要文件旁边。
从官网下载 Godot。 只从 godotengine.org 或官方 GitHub 下载，别用来路不明的"破解版""整合包"。
别指望一句话出大作。 小游戏能很快做出来，但想要好玩，需要你反复试玩和调整。