Unity CLI 1.0 正式发布:unity setup 一条命令为 Claude Code、Codex 等 Agent 装好官方插件,CLI 会代答编辑器隐藏弹窗,输出统一 JSON、退出码可区分状态,并承诺 1.x 期间命令兼容。
2026 年 11 月 17 日,Unity Technologies 借 Unite Tokyo 之机,正式发布了可在终端操作 Unity 的命令行工具「Unity CLI」以及用于从 CLI 驱动已启动编辑器的「Pipeline」包,两者均升级到正式版 1.0。

本版本新增了 unity setup——一条命令即可完成 Claude Code、Codex 等 AI Agent 的接入准备,并针对脚本与 CI 的易用性做了大量改进。官方同时承诺 1.x 期间保持命令与输出的兼容性。
Unity CLI 是什么
Unity CLI 是一个可独立运行的命令行工具,用于在终端安装和管理 Unity 编辑器、模块与项目,2026 年 7 月 15 日以 Beta 形式发布。配合同期提供的 Pipeline 包,CLI 还能操作本机已启动的编辑器——脚本或 AI Agent 打开项目、在编辑器里执行命令、确认结果,整个流程都可以只在终端里完成。
此后 Unity Hub 开始自动安装 CLI,所以只要在用最新的 Unity Hub,CLI 就已经在你的机器上了。针对 Claude Code、Codex、Grok Build、Google Antigravity 的官方插件也在陆续发布,Unity 各团队编写的技能(作业指引)可以直接装进 Agent,同一批技能也发布在 GitHub 仓库中,其他 Agent 同样可用(github.com/Unity-Technologies/skills)。
Beta 期间发布了 17 个以上版本。据 Unity 统计,7 月 20 日以来已有超过 35 万登录用户通过 Unity CLI 执行了超过 6 亿次命令,其中约 98% 来自编程 Agent 或其他自动化。常见用法是:人负责搭好 Unity 环境,之后的操作交给已启动编辑器里的 Agent。
1.0 版本的主要强化点
1.0 的多数改动来自错误报告、Discussions 讨论串以及日常使用 CLI 的工作室反馈。工作室反映的问题包括:实际失败却显示成功的命令、阻塞远程作业的弹窗、输出格式变化导致脚本失效等,这些决定了后续版本的优先级。
| 命令 / 功能 | 说明 |
|---|---|
| unity setup | 一条命令为 Claude Code、Codex、Grok Build 或 Google Antigravity 安装 Unity 官方插件 |
| unity skill install –all | 向机器上的所有 Agent 统一分发 Unity 技能,覆盖 VS Code、GitHub Copilot、Qwen Code、OpenCode 等;unity skill sync 可保持技能最新 |
| 隐藏对话框应答 | CLI 能检测编辑器正在等待应答的对话框并代为处理,避免脚本和 Agent 被看不见的弹窗卡住 |
| unity build –target | 复用当前打开该项目的编辑器执行构建;unity pipeline cloud-build 可从终端配置云构建目标 |
| unity vcs | 按资产单位读出场景与 Prefab 的改动,能以人可读的方式查看变更,也可在不切分支的情况下汇总 Pull Request 内容 |
| unity projects create / open / audit | 新建项目自动附带 Pipeline 包并可安装所需编辑器;open –until-ready 会等到编辑器可接受命令;audit 运行 Project Auditor 并导出报告(可指定升级、优化、URP 等侧重点) |
| 脚本与 CI 友好化 | 所有列表与流式输出统一为同一种 JSON 形态;短参数在所有命令中含义一致,–project-path 全命令可用;CI 中不再弹出交互提示;用退出码区分编辑器忙、对话框阻塞、断网等状态;可按项目固定 CLI 版本范围 |
| 安装与安全 | 提供 macOS / Linux / Windows 原生二进制,可经 Homebrew、winget、APT 获取;unity self-update 保留最近 3 个版本以便回滚;unity docs cache add 支持离线文档;修复了克隆仓库借 CLI 执行任意程序的安全问题 |
官方明确:1.x 期间保持命令、参数与输出的兼容;确需变更时会先给出弃用警告并留出过渡期。全部变更可查阅 Unity CLI 发行说明或用 unity changelog 查看(docs.unity.com)。
AI Agent 与自动化中的用法
Unity CLI 的定位是 AI Agent 实际操作 Unity 的通道:Agent 通过 CLI 打开项目、在编辑器里执行命令、进入 Play Mode 读取结果。使用官方插件时,还可调用 Unity 各团队编写的技能,覆盖 UI 搭建、光照设置、内购接入等任务,清单见 Unity Plugin 文档(docs.unity.com)。没有官方插件的 Agent 也能直接经 CLI 操作 Unity;不使用 AI 的脚本、测试运行器与 CI 任务同样适用。
运行环境方面:Build Server 许可的覆盖范围从构建扩展到 Agent 与自动化,每个实例 1 个许可,可在无头编辑器或容器中运行 Agent,且不限制宿主机器。针对 CI、构建机与 Agent 的官方支持版无头编辑器「Linux containerized Editor」也即将提供。
后续计划
Unity 表示会保持 Beta 期间的更新节奏,下一步让终端能操作更多 Unity 功能,包括面向 AI Generators、Live Games、Build Automation 的命令,以及为 Agent 打造的账号体系。
如何使用
只要在用最新的 Unity Hub,Unity CLI 就已安装。官方建议从 Unity CLI 文档开始(docs.unity.com);不熟悉终端的用户可以看入门指南 A beginner’s guide to Unity CLI and the Pipeline package(unity.com)。
- 出典:The Unity CLI 1.0 is here!(unity.com)
常见问题
Unity CLI 怎么安装?
最新版 Unity Hub 会自动安装 CLI,提供 macOS、Linux、Windows 原生二进制,也可经 Homebrew、winget、APT 获取;unity self-update 保留最近 3 个版本可回滚。
unity setup 能配置哪些 AI Agent?
Claude Code、Codex、Grok Build、Google Antigravity 四家官方插件任选其一;unity skill install –all 还能把 Unity 技能批量分发给 VS Code、GitHub Copilot、Qwen Code、OpenCode 等。
1.0 相比 Beta 改了什么?
依据 Beta 期间 17 次以上发布的反馈:输出统一为同一种 JSON 形态、短参数全命令一致、CI 下不再弹交互提示、退出码区分编辑器忙/对话框阻塞/断网等状态。
用得多吗?
官方统计:2026 年 7 月 20 日以来超过 35 万登录用户经 CLI 执行了超 6 亿次命令,其中约 98% 来自编程 Agent 或其他自动化。


评论留言