Unity CLI

Unity 正式发布了 Unity CLI，这是一款独立的、原生的命令行工具，旨在将游戏引擎深度集成到现代开发工作流中。通过提供结构化的输出、快速的启动速度以及对运行时环境的直接访问，Unity CLI 解决了传统 Unity 自动化流程中编译慢、交互难、上下文缺失的痛点，成为连接 AI 智能体（如 Claude Code, Codex）和 持续集成系统（CI/CD）的关键基础设施。

虽然 Unity 的 MCP（Model Context Protocol）服务器仍受支持，但 Unity 官方现在推荐将 Unity CLI 作为首选的自动化接口，并提供了向后兼容的 MCP 模式。

核心亮点：为什么选择 Unity CLI？

🚀 极速与原生体验

• 独立二进制文件：无需安装复杂的依赖项，unity 命令可直接加入 PATH，启动速度极快。
• 无缝管理：从编辑器安装、模块管理（Android, iOS, WebGL 等）到身份验证，均可通过一行命令完成（如 unity install 6000.2.10f1 -m android ios）。
• 自动化友好：所有命令均支持结构化 JSON/TSV 输出，错误信息定向至 stderr，退出代码遵循标准契约，完美适配脚本和 CI 流水线。

🤖 AI 智能体的“手”与“眼”

Unity CLI 弥补了 AI 编码助手在“执行”与“验证”环节的短板：

• 实时反馈循环：通过 unity command eval，智能体可以在几毫秒内在正在运行的编辑器或 Player 中执行任意 C# 代码，无需等待冗长的项目重新编译或域重载（Domain Reload）。
• 结构化上下文：AI 能够解析清晰的 JSON 结果，理解操作是否成功，从而形成“观察-行动-验证”的闭环。
• 全 API 覆盖：由于 eval 可以访问 Unity 的所有公开 API，智能体的能力边界等同于 Unity 引擎本身的能力边界。

🛠️ Pipeline 包：驱动运行中的编辑器与游戏

配合实验性的 com.unity.pipeline 包，Unity CLI 的能力进一步延伸至运行时：

• 自定义命令暴露：开发者只需在静态方法上添加 [CliCommand] 属性，即可将其暴露为 CLI 命令，无需额外注册。
• 编辑器自动化：CLI 可以直接驱动正在运行的 Unity 编辑器，执行构建、资源导入或场景修改等操作。
• 运行时控制：通过将运行时组件嵌入开发构建（Development Build），CLI 甚至可以控制正在运行的游戏实例，实现自动化玩法测试和实时状态修改（仅限 localhost，默认关闭以确保安全）。

快速开始

1. 安装 Unity CLI

使用平台包管理器安装后，即可在终端使用 unity 命令。

unity --help
unity doctor # 诊断环境、凭证和配置问题

2. 安装编辑器与模块

unity install 6000.2.10f1 -m android ios webgl

3. 启用 Pipeline 支持

在项目根目录下运行：

unity pipeline install

这将允许 CLI 与正在运行的 Unity 6.0 LTS+ 编辑器进行通信。

4. 实时执行 C# 代码

# 在正在运行的编辑器中评估表达式并返回结果
unity command eval "GameObject.Find('Main Camera').transform.position"

与 Unity AI 产品的关系

Unity CLI 并非取代 Unity 的 AI 产品，而是为其提供底层的执行界面。

• Unity AI：负责推理项目结构、理解意图并决定“做什么”。
• Unity CLI / Pipeline：负责实际“执行”这些决定，并返回可验证的结果。

这种分层架构使得任何 AI 智能体（无论是 Unity 官方的还是第三方的 Claude Code/Codex）都能通过统一的标准接口与 Unity 引擎交互。