LayaAir 3.4 开始官方把 AI 直接塞进了 IDE 里起名叫LayaIdea。它不是一个独立的聊天窗口而是跟场景编辑器、资源管理、属性面板集成在一起的 AIGC 智能助手——你可以在项目里直接描述需求、生成代码、管理资源不用在浏览器、Cursor、IDE 之间切来切去。这篇把从零创建 AI 工程到 AI 成功回你第一句话的完整流程走一遍所有截图都来自真实 LayaAir IDE 3.4.0 Layabox 控制台。跟着点就行。一、先搞清楚LayaIdea 是什么LayaIdea 是 LayaAir 内置的 AIGC 开发助手核心能力就三块对话生成在 AI 面板里用语言描述需求生成代码、解释 API、排查报错。资源管理右侧边栏提供资源管理界面方便替换和调度美术资源。开发流程专业模式下还能做需求分析、偏好设置、自动测试等把 AI 真正嵌入到游戏开发流程里。它跟之前我写的 LayaAir-CodingMCP 使用说明不是同一个东西CodingMCP 是面向 Cursor/Claude Code 等外部 AI 工具的知识库服务LayaIdea 是长在 LayaAir IDE 里的原生 AI 面板。二、创建 AI 工程打开 LayaAir IDE 3.4.0新建项目时你会看到模板列表里多了一个LayaIdea AIGC 空项目。创建项目时选择 LayaIdea AIGC 空项目项目名和保存位置按自己习惯填即可。选中它填好项目名和路径点击右下角 创建项目。这个模板已经把 LayaIdea 插件内置好了不需要再去商城单独下载安装。三、获取 API Key去 Layabox 控制台LayaIdea 需要 Layabox 的 API Key 做认证。拿到 Key 之后才能在 IDE 里连上 AI 服务。创建工程后打开 AIChatPanel会看到 LayaIdea 欢迎页右上角会显示查看/订阅入口点击它即可进入配置/订阅首次使用需要先到这里的控制台创建 API Key。看到这个欢迎页和“查看/订阅”按钮说明 LayaIdea 面板已加载接下来去控制台拿 API Key。1. 登录 Layabox 控制台打开浏览器进入 Layabox 控制台用手机号 密码或者微信扫码登录。Layabox 控制台是统一认证计费平台账号跟 LayaAir 生态通用。2. 进入 LayaIdea 套餐页登录成功后左侧菜单找到套餐管理 - LayaIdea顶部导航栏点击接口秘钥。这里能看到当前是否订阅了 LayaIdea 套餐。点击顶部“接口秘钥”去管理 API Key。3. 新建 API Key在接口秘钥页面点击 新建 Key生成后立刻复制保存。Key 明文只在创建时展示一次页面关了就没法再查看完整内容。API Key 是访问 Layabox 所有服务的凭证妥善保管不要泄露到公开仓库。⚠️ 如果这个 Key 以后丢了只能删除重建不能回来看明文。四、在 IDE 里配置 LayaIdea1. 打开 AI 面板回到 LayaAir IDE右侧应该已经能看到AIChatPanel标签页标题显示LayaIdea AIGC 智能助手。面板右上角有个设置按钮点它进入配置。打开项目后右侧 AIChatPanel 就是 LayaIdea 的主面板。2. 选择开发模式首次配置会弹出选择开发模式对话框普通模式适合快速生成游戏内容和美术资源右侧边栏有专属资源管理界面。专业模式功能最全包含偏好设置、需求分析、资源管理、更多/技能适合按完整流程推进项目。两个模式都能随时切换建议直接选专业模式普通模式无法配置自己的大模型。普通模式偏轻量专业模式把完整工作流都打开了。对话框底部会显示当前组件状态组件版本说明OpenCode 引擎v1.14.26-laya.3AI 代码生成引擎Agent 配置v20260514AI 代理配置版本最下方是修改 API KEY输入框把刚才从控制台复制的 Key 填进去点击确定。五、配置偏好与 Coding PlanKey 填好后在 AI 面板右侧滑出一列快捷按钮点最上面的设置偏好齿轮图标。偏好设置项说明这些开关按需开不需要一次性全打开。选项作用建议详细询问让 AI 多确认一步确保理解准确默认开YOLO 模式自动批准所有权限请求自己机器上可开团队协作慎开自动测试自动生成预览和测试Token 消耗较大按需开Coding Plan用自己的 API Key 调用厂商 Coding Plan 模型关键项建议配置使用网络代理OAuth 登录或海外 API 必需国内用户一般关配置 Coding Plan 模型Coding Plan 决定了 AI 实际用哪个大模型来帮你写代码。LayaIdea 支持三种智谱 Coding Plan国内推荐国内用户支持 GLM-5.1 等模型。Kimi Coding PlanMoonshot月之暗面的 Coding Plan。OpenAI CodexChatGPT 订阅需要海外 API 或代理。点击Coding Plan右边的按钮选择模型填入该厂商的 API Key然后添加为默认。智谱、Kimi、OpenAI Codex 三选一填入对应厂商的 API Key。配置完成后偏好面板里会显示你当前选用的模型比如智谱 Coding Plan国内 GLM-5.1最新旗舰。确认没问题点右下角保存并重启 AI 服务。修改配置后必须重启 AI 服务才能生效。六、验证让 AI 回你第一句话重启完成后回到 AIChatPanel 底部的输入框随便发一句比如hello。如果看到 AI 回复“你好我是 LayaIdea可以帮你开发 LayaAir 游戏。有什么需要帮忙的吗”就说明服务已经连通了。有 AI 回应就算配置成功。几个实测注意事项GLM 目前无法识图如果你发的是图片部分功能会受限建议用文字描述需求。积分影响资源生成AI 对话如果走的是你自己的 Coding Plan Key一般消耗你自己的 Token但资源生成和LLM 大模型访问服务需要 Layabox 积分积分不够时资源生成会失败。先用简单对话验证不要一上来就丢复杂需求先确认网络、Key、模型都通。七、积分消耗哪些功能要花钱Layabox 控制台里套餐管理 - LayaIdea - 费率说明把服务列得很清楚。真正需要消耗 Layabox 积分的主要是这两个服务费率说明LLM 大模型访问服务9.5 / 百万 Token统一大模型访问层资源生成2.2 / 次文生图、文生 3D 等 AI 资源生成只有 LLM 大模型访问和资源生成这两个需要消耗 Layabox 积分大模型可以走自己的 Coding Plan Key。省钱建议日常对话、代码生成尽量走自己的 Coding Plan Key智谱 / Kimi / OpenAI。只有需要 AI 生成图片、3D 资源时才走 Layabox 的付费资源生成服务。余额不足时记得充值否则资源生成会直接失效。八、常见问题速查Q: 为什么创建项目要选 LayaIdea AIGC 空项目A: 这个模板已经内置了 LayaIdea 插件省得手动去商城安装。用普通项目也可以自己补插件但新工程建议直接选这个模板。Q: API Key 填了还是连不上A: 先检查 Key 是否复制完整前后不要带空格然后确认 Coding Plan 也配了自有 Key 或者订阅了 Layabox 的 LLM 服务。最后点“保存并重启 AI 服务”否则不生效。Q: 普通模式和专业模式能切换吗A: 能。在 AI 面板里重新点击“选择开发模式”即可切换。Q: YOLO 模式自动批准权限会不会有风险A: 自己本地学习开 YOLO 没问题正式项目或团队环境建议关闭让 AI 每次请求权限时你确认一下。Q: 可以不配 Coding Plan直接用 Layabox 的 LLM 服务吗A: 可以但 Layabox 的 LLM 服务按 Token 计费且模型选择受限。配自己的 Coding Plan 更灵活也更容易控制成本。写在最后LayaIdea 把 AI 从“外部工具”变成了“IDE 内置能力”对 LayaAir 开发者来说最方便的地方在于AI 能直接读到你的工程结构、场景、资源生成的代码和对话上下文都更贴近项目本身。不过它现在还在快速迭代建议先用起来同时关注官方更新。配置过程中最关键的两步拿到 Layabox API Key和配好 Coding Plan搞定了基本就能顺畅对话。