# 快速入门 — AI Game Developer

几分钟即可上手：下载 AI Game Developer 应用，使用订阅登录，选择 Unity、Unreal 或 Godot，应用会自动安装并连接好一切。

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/docs/quickstart)。

文档 · 快速入门

几分钟即可上手。下载 **Game Dev App**，使用订阅登录并选择引擎 — 应用会自动安装并连接合适的 Unity、Unreal 或 Godot 插件。无需手动填写令牌，也无需配置文件。

## 获取 Game Dev App

AI Game Developer 应用是适用于所有引擎的 AI 结对编程助手。获取桌面应用，或安装 `gamedev` CLI — 同一账号，同一订阅。

▸ 桌面应用

适用于 Windows、macOS 和 Linux 的已签名安装包，支持自动更新。

[下载应用 →](https://ai-game.dev/zh-hans/download)

**更喜欢用终端？安装 `gamedev` CLI。**

在命令行中获得同样的核心功能（Node.js 20.19+ 或 22.12+）：

```bash
npm install -g @baizor/gamedev
```

```bash
gamedev
```

想全面了解应用和 CLI？ [打开应用指南 →](https://ai-game.dev/docs/app)

## 使用订阅登录

启动应用并点击 **登录**。浏览器窗口会打开安全的设备授权流程 — 批准后即可登录。你的用量、历史和限制会在桌面应用与 CLI 之间同步。

1. 打开应用并选择 **登录**。
2. 在打开的浏览器窗口中批准登录。
3. 应用会确认你的账号和订阅方案。

想了解登录原理，或想使用自己的 AI 客户端？ [阅读身份验证指南 →](https://ai-game.dev/docs/auth)

## 选择你的引擎

在应用中选择引擎。它会安装匹配的插件、配置好云端连接并打开编辑器 — 无需手动安装任何内容。Brutal 即将推出。

**Unity**

Unity 2022.3 LTS Unity 2023 Unity 6 (6000.x) 任意 2022.3+ 版本

选择 **Unity** 后，应用会安装插件、通过 **ai-game.dev** 建立连接并打开编辑器。当状态标签显示 ● 就绪 时，即可开始输入提示词 — 它会提供 **72 项能力（21 个 MCP 工具 + RQL）**。

▸ 先试试这个

_“创建一个新场景，包含一盏平行光和一个旋转的立方体，然后进入播放模式。”_

想手动操作，或使用自己的 MCP 客户端？高级 CLI + 手动设置请见 [Unity 安装指南 →](https://ai-game.dev/zh-hans/engines/unity)

**Unreal Engine**

Unreal Engine 5.5+ 已在 5.7 上测试 C++ 项目

选择 **Unreal Engine** 后，应用会安装插件、通过 **ai-game.dev** 建立连接并打开编辑器。当状态标签显示 ● 就绪 时，即可开始输入提示词 — 它会提供 **90 个 MCP 工具**。

▸ 先试试这个

_“创建一个带静态网格立方体的新 Actor 蓝图，并在关卡中放置三个。”_

想手动操作，或使用自己的 MCP 客户端？高级 CLI + 手动设置请见 [Unreal Engine 安装指南 →](https://ai-game.dev/zh-hans/engines/unreal)

**Godot**

Godot 4.3–4.5 C# / .NET 8 (mono)

选择 **Godot** 后，应用会安装插件、通过 **ai-game.dev** 建立连接并打开编辑器。当状态标签显示 ● 就绪 时，即可开始输入提示词 — 它会提供 **99 个 MCP 工具**。

▸ 先试试这个

_“添加一个包含 Camera3D 和 MeshInstance3D 立方体的 Node3D 场景，然后将其保存为 Main.tscn。”_

想手动操作，或使用自己的 MCP 客户端？高级 CLI + 手动设置请见 [Godot 安装指南 →](https://ai-game.dev/zh-hans/engines/godot)

## 开始构建

就是这样 — 用自然语言描述你的需求，智能体就会实时操控编辑器。无需记住工具 ID，直接提问即可。

▸ 可尝试的提示词

- _“列出活动场景中的所有内容。”_
- _“在原点创建一个立方体，并为其添加物理刚体。”_
- _“对当前视图截图。”_

想了解智能体还能做什么？

[浏览全部 261 项能力 →](https://ai-game.dev/docs/tools)

## 常见问题

最常被反馈的坑。认证相关问题在[认证指南](https://ai-game.dev/docs/auth)中有详细说明。

**登录用的浏览器窗口没有打开**

**可能原因** 未设置默认浏览器，或防火墙拦截了本地回调

**解决方法**

设置默认浏览器后重试**登录**。应用会在浏览器中打开标准 OAuth 设备流程——具体流程见[认证指南](https://ai-game.dev/docs/auth)。企业代理可能需要放行到 `ai-game.dev` 的出站 HTTPS。

**选择引擎后，引擎插件没有安装**

**可能原因** 在本机找不到该引擎或项目

**解决方法**

确认已安装引擎（Unity Hub、Unreal Engine 或 Godot），并让应用指向真实的项目文件夹。如果你更想手动安装，也可以直接参考[各引擎安装指南](https://ai-game.dev/zh-hans/engines/unity)安装插件。

**登录后编辑器面板显示“已断开连接”**

**可能原因** 编辑器尚未完成授权，或与 Cloud 的连接已中断

**解决方法**

在编辑器中打开 **AI Game Developer** 窗口，选择 **Cloud**，然后点击 **Authorize**。等待状态标签显示 ● Ready 。如果授权已被撤销，请重新授权——你可以在 [Connected devices](https://ai-game.dev/app/connected-devices) 页面查看活跃会话。

**使用自己的 AI 客户端（Claude Code、Cursor、Copilot……）而不是本应用**

**可能原因** 你的客户端需要 MCP 端点以及自己的授权

**解决方法**

让客户端指向 MCP 端点，并通过 OAuth 完成授权——[认证指南](https://ai-game.dev/docs/auth)中说明了 `/mcp` 与固定版 `/mcp/p/<pin>` URL 的区别，[MCP 端点页面](https://ai-game.dev/mcp-endpoint-info)则提供了各客户端的配置片段。

### 接下来去哪？

[**应用 →** 深入了解桌面应用和 gamedev CLI。](https://ai-game.dev/docs/app) [**认证 →** OAuth 设备流程、用于 CI 的 PAT，以及端点固定。](https://ai-game.dev/docs/auth) [**工具目录 →** 你的 AI 能做的 261 件事：MCP 工具和 RQL。](https://ai-game.dev/docs/tools) [**常见问题解答 →** 关于安装、认证和隐私的常见问题。](https://ai-game.dev/docs/faq)

---

Source (HTML): https://ai-game.dev/zh-hans/docs/quickstart

Machine-translated (zh-Hans) from the English page: https://ai-game.dev/docs/quickstart