# 快速入門 — 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-hant/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）**。

▸ 先試試這個

_「建立一個包含方向光與旋轉立方體的新場景，然後進入 Play 模式。」_

想手動設定，或自備 MCP 用戶端？進階 CLI + 手動設定請見 [Unity 安裝指南 →](https://ai-game.dev/zh-hant/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-hant/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-hant/engines/godot)。

## 開始打造

就是這樣——用自然語言描述你的需求，代理程式就會即時驅動你的編輯器。你不必記住工具 ID，只要描述需求就好。

▸ 可試試的提示詞

- _「列出目前場景中的所有內容。」_
- _「在原點建立一個立方體，並賦予它物理剛體。」_
- _「擷取目前視圖的螢幕畫面。」_

想知道代理程式還能做什麼？

[瀏覽全部 261 項能力 →](https://ai-game.dev/docs/tools)

## 疑難排解

以下是使用者最常回報的坑。驗證相關問題在[驗證指南](https://ai-game.dev/docs/auth)中有詳細說明。

**登入用的瀏覽器視窗沒有開啟**

**可能原因** 沒有設定預設瀏覽器，或防火牆擋掉了本機回呼

**解決方式**

請設定預設瀏覽器後再試一次**登入**。應用程式會在瀏覽器中啟動標準的 OAuth 裝置流程，流程運作方式請見[驗證指南](https://ai-game.dev/docs/auth)。企業 Proxy 可能需要放行對 `ai-game.dev` 的對外 HTTPS 連線。

**選擇引擎後，引擎外掛沒有安裝成功**

**可能原因** 在這台機器上找不到該引擎或專案

**解決方式**

請確認已安裝引擎（Unity Hub、Unreal Engine 或 Godot），並讓應用程式指向實際的專案資料夾。如果想手動處理，也可以直接依照[各引擎安裝指南](https://ai-game.dev/zh-hant/engines/unity)安裝外掛。

**登入後編輯器面板顯示「已中斷連線」**

**可能原因** 編輯器還沒完成授權，或與 Cloud 的連線中斷

**解決方式**

在編輯器中開啟 **AI Game Developer** 視窗，選擇 **Cloud**，然後點選 **Authorize**。等待狀態標籤顯示 ● Ready 。若授權遭到撤銷，請重新授權——你可以在 [已連線的裝置](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>` 網址的差別，[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-hant/docs/quickstart

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