在Godot中使用Claude：配置、MCP与测试

无需更换引擎，也可以将Claude用于Godot开发。首先要确认代理可以访问哪些内容：项目文件、终端、编辑器操作、日志，以及运行中的游戏。

本文由Summer Engine团队编写，介绍官方文档支持的配置方式与验证流程，不是模型性能排名，也不声称所有集成都已在此完成实测。

选择工作环境

Claude Code支持编辑文件和执行命令。Cursor也提供终端工具。打开正确的项目，确认Godot可执行文件的位置，并检查权限设置。

自建集成需要实现所需操作，并返回真实结果与错误。安装模型本身不会自动建立测试环境。

提供具体的项目上下文

说明引擎版本、project.godot路径、主场景、相关节点路径和输入动作。附上错误文本与复现步骤。

可以从这样的请求开始：“读取玩家场景与移动脚本，先解释跳跃逻辑。保留现有输入动作，增加一次空中跳跃，并列出验证步骤。不要修改无关场景。”

先创建Git检查点，再审查修改差异。

运行项目并核对结果

Godot命令行文档说明了终端运行方式。以下示例假设godot位于PATH中；请替换为实际可执行文件和项目目录：

godot --version
godot --headless --path "/path/to/project" --import
godot --path "/path/to/project"

第二条命令会等待资源导入完成后退出，但不会运行每个场景，也不能证明游戏可用。最后一条启动项目，并持续运行到退出。读取命令输出，再测试地面跳跃、额外空中跳跃和落地后的恢复。同时检查原有操作是否正常。

无界面运行无法验证画面质量、音量平衡或操作手感。这些需要观察实际运行结果并试玩。

按需要接入MCP

MCP可以让Claude Code调用外部工具。某个服务器可能提供场景检查、节点编辑或诊断，但各实现不同。先检查实际工具列表，并从不修改项目的读取操作开始。

只要具备合适的工具，外部代理同样可以利用运行反馈。代理显示在编辑器内部还是外部，并不能单独决定其能力。

如果要使用Summer的本地编辑器工具，请先安装Summer Engine桌面应用，并在应用中打开项目。这与上面通过终端运行原版Godot的路径不同：Summer的编辑器工具连接的是Summer桌面应用，不是原版Godot编辑器。安装Node.js 20或更新版本后，在Claude Code中配置工具：

npx -y summer-engine@latest setup claude-code --yes

这条命令会将Summer MCP服务器和skills加入Claude Code配置，但不会安装或打开桌面应用。如果已经在Claude Code安装Summer官方插件，可使用它的/summer:start流程，避免重复安装同一套skills。Claude Code配置指南说明完整流程；MCP介绍是网页，不是可直接粘贴到配置中的服务器地址。

第一次连接时，先让Claude Code只读调用summer_get_project_context，报告实际返回的项目名称、路径和主场景，不要修改文件。核对它们是否对应Summer桌面应用中打开的项目，再用summer_get_scene_tree读取该场景。之后才做一个可见的小改动，例如修改已有文本标签并保存场景，运行summer_play，查看游戏截图和summer_get_diagnostics。自己检查场景差异、截图和诊断；诊断没有报错，不代表文字一定可见或游戏手感正确。

如果Claude Code中没有Summer工具，先重启Claude Code，再运行npx -y summer-engine@latest doctor --json，查看mcp-boot和mcp-tools-list检查。Doctor能检查服务器启动和工具列表，但不能证明Claude Code已经加载工具；必要时检查客户端的MCP设置。如果工具无法连接项目，请确认Summer桌面应用打开了正确项目，再查看同一份Doctor输出中的local-api。在项目身份正确之前，不要让代理编辑。

Summer适合什么场景

Summer提供基于Godot的编辑器、AI工作流程和代理工具。导入已有项目时，请检查插件兼容性和导出要求。

桌面编辑器可免费下载，本地编辑、运行和导出不消耗Summer托管生成点数。托管素材生成等计费任务需要账户和付费点数；免费聊天不等于免费生成，注册也不保证赠送点数。请查看当前价格。桌面应用为专有软件，CLI、MCP和skills采用MIT许可证。Claude Code等外部编码代理的订阅与Summer托管服务分开计费。

从一个具体机制开始，在游戏中验证，再基于可用的检查点继续开发。