# Plugin Unity chính thức cho Claude Code

[Unity](https://homus.dev/speakers/unity) · [Unity](https://homus.dev/orgs/unity)

> Plugin chính thức của Unity cho Claude Code: Unity CLI, pipeline package, skill và MCP server, cách cài và demo dựng thành phố bằng Claude.

Topics: Plugins, Skills, Coding Agents

Canonical: https://homus.dev/talks/your-guide-to-the-official-unity-plugin-for-claude-code

## 1. Unity CLI và pipeline package: điều khiển Unity Editor một cách deterministic

Video là một đoạn giới thiệu ngắn của Unity, khoảng hai phút, về plugin chính thức của Unity dành cho Claude Code. Lời dẫn mở bằng nền móng mà plugin dựa vào: **Unity CLI** (command line interface, giao diện dòng lệnh) và **pipeline package**. Theo Unity, hai thứ này cho phép điều khiển Unity một cách deterministic hơn, tức là kết quả lặp lại được và đoán trước được, thay vì để một agent mò mẫm qua giao diện.

![Màn hình tiêu đề: Official Unity Plugin for Claude Code, bên cạnh ảnh một thành phố lúc hoàng hôn](https://homus.dev/photos/NVT8JwUNDSA-0003.jpg)

Màn hình mở đầu: dòng chữ "Official Unity Plugin for Claude Code" cạnh ảnh một thành phố 3D dưới bầu trời hoàng hôn đỏ, chính là cảnh sẽ được dựng ở phần demo.

Ba khả năng được kể ra ngay sau đó:

- **Custom commands**: lệnh tự định nghĩa để gọi vào Unity.

- **Runtime access**: truy cập vào game đang chạy, không chỉ vào project nằm im trên đĩa.

- **Chạy C# tuỳ ý trong editor mà không cần domain reload.** Với người dùng Unity, domain reload là bước Unity nạp lại toàn bộ script mỗi khi code đổi hoặc khi vào Play mode, thường làm mọi thứ khựng lại vài giây. Bỏ được bước đó nghĩa là agent có thể chạy một đoạn C# nhỏ để kiểm hoặc sửa scene mà không phải chờ.

Pipeline package biến chính Unity Editor thành một **local server**. Từ đó, terminal của bạn, agent của bạn, giao diện riêng bạn tự làm, hay máy build của bạn đều có thể truy cập vào editor và vào game đang chạy.

![Sơ đồ kiến trúc bốn tầng: Clients, Unity CLI, giao thức HTTP + JSON, Pipeline package, Unity Editor / runtime](https://homus.dev/photos/NVT8JwUNDSA-0023.jpg)

Tầng Clients gồm Terminal, Agents, Custom UI và CI/CD; tất cả đi qua Unity CLI; giao thức là HTTP + JSON; tới Pipeline package với hai phần Editor server và Runtime server; và dưới cùng là Unity Editor / runtime.

Đọc sơ đồ theo chiều từ trên xuống: mọi client (một lệnh gõ tay trong terminal, một coding agent như Claude Code, một UI tự viết, hay một job CI/CD trên máy build) đều nói chuyện qua cùng một cửa là Unity CLI. CLI gửi request dạng HTTP + JSON xuống pipeline package. Ở đó có hai server tách biệt: **Editor server** để làm việc với editor (scene, asset, prefab) và **Runtime server** để làm việc với game khi đang chạy. Vì giao thức là HTTP + JSON đơn giản, bất kỳ công cụ nào gọi được HTTP cũng có thể dùng chung đường này.

## 2. Plugin chính thức: skill, Unity CLI và MCP server trong một lần cài

Trên nền đó, Unity giới thiệu plugin chính thức cho Claude Code. Một plugin cài ba thứ cùng lúc:

- **Các engineering skill của Unity**: những skill đóng gói cách Unity khuyến nghị làm từng loại việc. Trên màn hình có hiện tên một skill ví dụ là `unity-package-management`.

- **Unity CLI**, cái cửa chung đã nói ở phần trên.

- **MCP server của Unity**, để Claude điều khiển editor trực tiếp khi editor đang mở (live editor control).

Ba thành phần một lần cài plugin mang vào Claude Code, theo lời giới thiệu của Unity.

Mục đích, theo Unity, là để Claude Code làm việc đúng theo cách Unity muốn (the way Unity intends): thay vì đoán cấu trúc project hay tự bịa cách gọi API của engine, Claude dùng skill và công cụ do chính Unity viết.

## 3. Cài plugin rồi để Claude lo phần còn lại

Phần cài đặt được minh hoạ ngay trong ứng dụng Claude: mở Settings, vào mục **Customize → Plugins**, bấm **Browse plugins**, tìm Unity rồi bấm **Install**.

![Cửa sổ Settings của Claude, mục Plugins với nút Browse plugins](https://homus.dev/photos/NVT8JwUNDSA-0031.jpg)

Cửa sổ Settings của Claude: cột trái có General, Account, Claude Code, mục Desktop app và Customize với Plugins đang được chọn; bên phải là nút Browse, Add và Browse plugins. Cảnh kế tiếp chỉ còn một nút Install.

Sau khi cài, Claude có quyền truy cập vào các skill khác nhau và sẽ tự dùng chúng khi liên quan. Thông điệp của Unity rất ngắn: cài plugin, Claude lo phần còn lại. Claude nhặt skill phù hợp trong lúc bạn làm việc, và tự cài Unity CLI cùng pipeline package khi cần, bạn không phải tự dựng từng mảnh.

Nếu dùng Claude Code trong terminal, README của repo plugin hướng dẫn cài bằng hai slash command gõ ngay trong một phiên Claude Code: `/plugin marketplace add Unity-Technologies/unity-agent-plugin` rồi `/plugin install unity@unity-agent-plugin`. Kiểm tra bằng cách gõ `/unity:` để thấy các skill hiện ra trong danh sách lệnh. README cũng ghi plugin dùng được cả cho Codex và Grok.

## 4. Demo: tìm chiếc xe cũ, dựng thành phố, thêm hàng cây

Phần demo không có lời giảng từng bước; màn hình kể câu chuyện. Một project Unity mới được dựng với bộ asset thành phố. Người dùng gõ vào Claude một yêu cầu rất đời thường:

```
Find me a car from one of my older projects.
```

![Hội thoại với Claude: yêu cầu tìm một chiếc xe từ project cũ, Claude tìm trong 4 project lưu trữ và đọc file Sedan_A.prefab](https://homus.dev/photos/NVT8JwUNDSA-0103.jpg)

Khung hội thoại "Unity project using the Official Unity Plugin for Claude Code". Claude liệt kê các bước: Search 4 archived projects, Match vehicle prefabs by tag, Read Assets/Vehicles/Sedan_A.prefab, Check materials, rồi hỏi lại "Yes, what about this one?".

Claude không trả lời chung chung mà làm việc thật trên đĩa: tìm qua 4 project đã lưu trữ, lọc các vehicle prefab theo tag, đọc file `Assets/Vehicles/Sedan_A.prefab`, kiểm tra material của nó, rồi đề xuất lại chiếc sedan đó và hỏi người dùng có muốn dùng không. Đây đúng là kiểu việc mất thời gian khi làm tay: nhớ xem asset nằm ở project nào, mở từng project, kiểm material có còn đủ không.

Tiếp theo, Claude dựng một thành phố với các toà nhà chọc trời. Kết quả là chiếc xe chạy giữa thành phố vừa được tạo ra, dưới bầu trời hoàng hôn. Sau đó người dùng yêu cầu thêm cây vào scene, và cảnh được cập nhật: hai bên đường giờ có hàng cây, bãi cỏ, lối đi bộ và dòng xe phía trước.

![Chiếc xe chạy trên đại lộ giữa các toà nhà cao tầng, hai bên có hàng cây và bãi cỏ](https://homus.dev/photos/NVT8JwUNDSA-0143.jpg)

Scene sau khi thêm cây: chiếc xe lấy từ project cũ chạy trên đại lộ, hai bên là hàng cây, bãi cỏ, vỉa hè và các toà nhà cao tầng, phía trước là đèn của những xe khác.

Video khép lại bằng lời mời: cài Unity plugin cho Claude Code, mở một project và xem mình build được thêm bao nhiêu thứ. Plugin có sẵn trong Claude Code từ hôm nay.

## Nguồn và liên kết

- Tên gốc: Your guide to the official Unity plugin for Claude Code
- Sự kiện: [YouTube](https://homus.dev/events/youtube)
- Video gốc: [https://www.youtube.com/watch?v=NVT8JwUNDSA](https://www.youtube.com/watch?v=NVT8JwUNDSA)

- Kênh YouTube Unity (Unity Technologies): [youtube.com/channel/UCG08EqOAXJk_YXPDsAvReSg](https://www.youtube.com/channel/UCG08EqOAXJk_YXPDsAvReSg)

- Trang plugin Unity trên Claude Marketplace (mô tả các skill: UI với uGUI và UI Toolkit, 2D và tilemap, in-app purchase, localization, multiplayer, Shader Graph): [claude.com/marketplace/plugins/unity](https://claude.com/marketplace/plugins/unity)

- Repo mã nguồn plugin, có lệnh cài cho Claude Code, Codex và Grok: [github.com/Unity-Technologies/unity-agent-plugin](https://github.com/Unity-Technologies/unity-agent-plugin)

Nguồn: https://homus.dev/talks/your-guide-to-the-official-unity-plugin-for-claude-code · cập nhật 2026-10-09