全部模型资源
  • 全部模型资源
  • - 交通工具
  • - 动物昆虫
  • - 场景\道具模型
  • - 建筑模型
  • - 植物模型
  • - 武器模型
  • - 独家资源库
  • - 科幻模型
  • - 角色动画库
  • - 角色模型
  • 游戏开发知识博客

Unity CLI 1.0 正式发布:一条命令接入 Claude Code 等 Agent,输出与选项全面规范化

概要

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 标志宣传图,象征命令行工具 Unity CLI

本版本新增了 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 或其他自动化。

次世代模型库 - 3D模型资源下载

评论留言