Tóm lại: 3 bước

Plugin Unity cho Codex hợp với dự án Unity 6 muốn Codex viết code theo API hiện hành, thay vì theo mười năm câu trả lời trên diễn đàn. Unity phát hành plugin dưới tên của chính họ, và 31 Skill bên trong do các nhóm Unity phụ trách từng tính năng viết ra. Cài từ thư mục plugin của Codex hoặc bằng hai câu lệnh, duyệt kết nối MCP trong editor, rồi gọi tên Skill khi giao việc. Cần Unity 6 trở lên.

Bước 1: Tìm plugin và cài

Có hai đường, cùng dẫn tới một plugin.

Trong sidebar của Codex, mở Plugins (plugin), tìm Unity, rồi cài từ mục do Unity Technologies phát hành.

Trang plugin Unity trong Codex, liệt kê 31 Skill gồm 2d Pixel Perfect, Audio Setup Mixers, Build Live Game

Từ terminal, cũng vẫn là hai câu lệnh:

codex plugin marketplace add Unity-Technologies/unity-agent-plugin
codex plugin add unity@unity-agent-plugin

Repository là Unity-Technologies/unity-agent-plugin, giấy phép Unity Companion License. Claude Code cài từ cùng repository đó với /plugin install unity@unity-agent-plugin.

Đây không phải gói trên Asset Store, nên Package Manager (trình quản lý gói) trong editor sẽ không tìm ra. Bản hiện tại là 0.1.6-beta; các bản sau về qua codex plugin marketplace upgrade unity-agent-plugin, nên không phải chép gì giữa các máy và cũng không cần cấu hình riêng cho từng dự án.

Mở một phiên Codex mới và gõ /unity: để xác nhận danh sách Skill đã nạp.

Bước 2: Duyệt kết nối MCP trong editor

Mở dự án Unity 6 trước. Mọi thao tác bên dưới đều diễn ra trên editor đang chạy.

Trong Unity, vào Edit (chỉnh sửa) → Project Settings (cài đặt dự án) → AI → Unity MCP và kiểm tra Bridge có đang ở trạng thái Running không. Yêu cầu đầu tiên từ Codex rơi vào Pending Connections và nằm đó cho tới khi chọn Accept ngay trong editor. Kết nối đi qua IPC local, nên mã nguồn dự án không rời khỏi máy.

Có hai bảng dễ nhầm. Plugin chính thức dùng MCP Bridge tích hợp sẵn trong editor Unity. Unity MCP được nói riêng trên trang này là một cửa sổ dịch vụ độc lập chạy ở cổng 6594, có cấu hình một lần nhấn cho Cursor và Codex. Cả hai đều chạy local, nhưng không phải cùng một bảng. Kênh kết nối hoạt động ra sao thì xem MCP nối công cụ lập trình AI với game engine.

Sau khi kết nối được duyệt, scene hiện tại, các GameObject và log trong Console đều đọc và sửa được từ phiên làm việc.

Bước 3: Gọi tên Skill khi giao việc

Skill được gọi theo tên, dưới dạng lệnh slash. Nếu chỉ nói «làm màn hình cài đặt» mà không gọi Skill nào, việc chọn UI framework vẫn bỏ ngỏ. Đó là cách một dự án uGUI nhận về code UI Toolkit và sau đó phải gỡ ra làm lại.

Giao cho router trước, để nó đọc dự án:

/ui làm màn hình cài đặt có thanh trượt âm lượng và nút quay lại

/ui đọc xem dự án đang dùng hệ UI nào, rồi chuyển tiếp sang /ui-uitk, /ui-ugui hoặc /ui-imgui. Các mảng khác cũng vậy: chuyển từ Built-in sang URP thì /migrate-birp-to-urp, đóng gói atlas thì /manage-sprite-atlas, chữ CJK hiện thành ô vuông thì /optimize-text-mesh-pro, Unity IAP thì /implement-in-app-purchases.

Toàn bộ 31 Skill, nhóm theo công việc: Giới thiệu chi tiết Unity Skills trong Codex.

Unity CLI và plugin không phải một

Câu này được hỏi đủ nhiều để viết thẳng ra.

Unity CLI là một giao diện. Nó chạm tới engine từ terminal—cài Editor, tạo và mở dự án, quản lý package và license, chạy build và test, đọc log. Agent gọi được, người gọi cũng được. Unity phát hành CLI ở Unite Seoul, trước cả hai plugin.

Plugin đưa ra phần hướng dẫn. Mỗi Skill mô tả một công việc Unity đáng lẽ phải được làm như thế nào, nên Codex kiểm tra dự án, dùng API hiện hành, và xác minh kết quả trước khi trả về. Không có phần đó, một công cụ lập trình đa dụng trả lời theo mức trung bình của mọi thứ từng viết về Unity, mà phần lớn nhắm vào những phiên bản engine không còn phát hành nữa.

Hai thứ gặp nhau bên trong plugin: unity-cli chính là một trong 31 Skill, Skill dạy Codex cách điều khiển CLI. Cài plugin không thay thế được CLI, và dùng CLI cũng không có nghĩa là agent đã nhận được hướng dẫn của Unity cho công việc đang làm.

Phần còn nằm ngoài cả hai

Skill lo phần code được viết ra sau khi dự án đã mở. Xử lý art UI sinh ra theo lô—cắt ảnh một tấm ghép theo biên phát hiện được, xuất thành file có tên có nghĩa vào Assets/Textures và Assets/Prefabs, giữ và đồng bộ ngữ cảnh layer—diễn ra trước đó, và không nằm trong danh sách Skill. Xem Plugin Codex của Unity: 31 Skill lo được gì, và bỏ lại gì.