AI Game Dev 应用与 gamedev CLI
介绍 AI Game Dev 桌面应用与 gamedev CLI 是什么、它们如何配合 Unity、Unreal 和 Godot 插件工作，以及从哪里开始。
AI Game Dev 是 AI Game Developer 的 AI 游戏开发应用：一个能理解你的游戏项目、编辑项目文件，并通过自然语言驱动引擎编辑器的 AI 智能体。它有两种形态，共用同一个账号、同一个后台服务和同一份聊天记录：桌面应用和面向终端的 gamedev CLI。本部分 wiki 介绍如何安装它们、登录、打开项目、选择模型、用包扩展应用，以及解决常见问题。
桌面应用还是 CLI
两个前端运行同一个智能体，由 Claude Agent SDK 驱动，并且都通过你的 AI Game Developer 账号进行身份验证。
| 桌面应用 | gamedev CLI | |
|---|---|---|
| 运行环境 | Windows、macOS、Linux | Windows、macOS、Linux 终端 |
| 安装方式 | 从下载页面获取签名安装程序 | npm install -g @baizor/gamedev |
| 最适合 | 日常开发：窗格、预览、Source Control、Packages 窗口 | 终端工作流、脚本调用（--print）、T3 Code 或 Zed 等 ACP 客户端 |
| 包 | Packages 窗口以及 /packages | gamedev pkg 和 /packages |
| 更新 | 下载更新并提示 Restart to update | gamedev update |
你可以在同一台电脑上同时使用两者。在一端开始的聊天会保存在共享历史中，在用户级别安装的包对两者都生效。
它与引擎插件和 MCP 的关系
应用并不取代引擎插件，而是使用它们。每个引擎都有自己的 MCP 插件，对外暴露编辑器工具（创建对象、编辑场景、运行测试、截图等等）：
- 用于 Unity 的 Unity MCP，由
unity-mcp-cli管理。 - 用于 Unreal Engine 的 Unreal MCP，由
unreal-mcp-cli管理。 - 用于 Godot 的 Godot MCP，由
godot-cli管理。
当你打开一个 Unity、Unreal 或 Godot 项目时，应用会检测引擎，提示你安装或更新对应的插件，在智能体需要时启动编辑器，并通过 ai-game.dev 借助你已登录的会话把编辑器的工具接入聊天。安装程序已内置在应用中，因此桌面应用不需要 Node.js 或 npm。
这些插件也可以脱离应用使用：任何 MCP 客户端（Claude Code、Cursor、VS Code、Codex 等）都能连接到 MCP 端点。生态系统概览展示了应用、插件和 MCP 服务器如何协同工作，工具目录则列出了插件为智能体提供的全部能力。
应用在插件之上额外提供的能力
- 一个聊天智能体，可以读取和编辑你的项目文件、运行命令、调用引擎工具，所有操作都需经你批准。
- 来自多家供应商的 AI 模型可选，具体可用模型由你的套餐和所在地区决定。参见智能体与模型。
- 桌面工作区为每个项目提供一个窗口，支持窗格中的会话、文件预览（贴图、3D 模型、音频、视频）以及 Git。参见工作区。
- 包可添加完整的功能能力：Blender、基于 SuperCollider 的音乐、项目知识库、Tripo 3D、在你 GPU 上运行的本地图像与视频生成，以及云端视频和音频模型。参见包。
- 会话工具：每个聊天自行选择携带哪些工具，从而让智能体的上下文保持精简。
页面导航
如果你是新手，从这里开始：
- 安装：在 Windows、macOS 或 Linux 上安装桌面应用，或安装
gamedevCLI，并保持它们更新。 - 登录与账号：登录、套餐、以百分比显示的用量、切换账号。
- 项目与引擎：打开或创建项目，让应用自动配置 Unity、Unreal 或 Godot 插件。
- 智能体与模型：选择模型、推理强度与智能体、审批设置、本地模型。
接下来深入了解：
- 工作区：桌面应用中的窗格、预览、Explorer、Search 和 Source Control。
- 包：什么是包、Packages 窗口、
gamedev pkg、级别、更新。 - 包目录：目前可用的所有包及其功能。
- 创建包：编写、测试并分享你自己的包。
- CLI 参考：所有
gamedev命令以及终端中的斜杠命令。 - 故障排查：登录、引擎连接、包与模型。
- 常见问题：常见问题的简短解答。
快速开始
- 从下载页面下载应用，或运行
npm install -g @baizor/gamedev。 - 使用你的 AI Game Developer 账号登录。
- 打开你的游戏项目文件夹。
- 描述你的需求，例如“列出活动场景中的所有内容。”
- 安装在 Windows、macOS 或 Linux 上安装 AI Game Dev 桌面应用，或用 npm 安装 gamedev CLI，并让两者保持最新。
- 登录与账户登录 AI Game Dev 应用和 gamedev CLI，切换账户，了解套餐与用量百分比，并管理你的其他设备。
- 项目与引擎在 AI Game Dev 应用中打开或创建 Unity、Unreal 或 Godot 项目，安装引擎插件，并让 agent 在需要时打开编辑器。
- 智能体与模型在 AI Game Dev 应用和 CLI 中选择 AI 模型、推理强度和智能体，控制工具审批，并在自己的 GPU 上使用本地 AI 模型。
- 工作区AI Game Dev 桌面工作区：项目窗口、窗格中的会话、纹理/3D 模型/音频的文件预览，以及 Explorer、Search 和 Git。
- 包AI Game Dev 应用中有哪些包，如何在 Packages 窗口或使用 gamedev pkg 安装、更新、排除和删除它们，以及层级如何工作。
- 软件包目录当前可用的全部第一方 AI Game Dev 软件包：Blender、SuperCollider 音乐、Knowledge Base、Tripo 3D、本地图像与视频模型、云端模型。
- 创建包编写你自己的 AI Game Dev 包：aigd-package.json 清单、命令、斜杠命令、MCP 工具，用 gamedev pkg dev 本地开发，以及分享。
- gamedev CLI 参考gamedev CLI 的每条命令与选项：交互模式与无头模式、pkg、remote、daemon、acp、image-runtime、update，以及终端中的斜杠命令。
- 故障排查解决 AI Game Dev 应用和 gamedev CLI 的常见问题：登录、模型、引擎插件与编辑器连接、包、本地与云端生成。
- 常见问题关于 AI Game Dev 应用和 gamedev CLI 的简明解答：支持的引擎、平台、套餐、用量、包、本地模型、隐私，以及使用你自己的 AI 客户端。