A beginner’s guide to Unity CLI and the Pipeline package

Gần đây chúng tôi đã ra mắt Unity CLI và nhận được phản hồi vô cùng tích cực với ngày càng nhiều trường hợp sử dụng đầy cảm hứng. Tuy nhiên, nếu bạn, giống như nhiều người khác, cảm thấy các công cụ dòng lệnh hơi khó sử dụng, cảm thấy mình giống một nhà thiết kế hơn là một lập trình viên, hoặc đơn giản là chưa có thời gian để thử nghiệm với chúng, thì hướng dẫn này được thiết kế dành cho bạn.

Unity CLI là gì?

Một trong những điểm mạnh lớn nhất của Unity Editor là GUI), giúp dễ dàng quản lý trực quan các dự án phức tạp. Kiểm tra một đối tượng dựng sẵn, tinh chỉnh giá trị vật liệu, chạy thử nghiệm, thiết lập ánh sáng hoặc tìm lỗi trong bảng điều khiển đều chỉ cần vài cú nhấp chuột trong Trình chỉnh sửa. Quy trình làm việc này đã phục vụ người dùng gần hai thập kỷ, và giờ đây nó đã trở thành điểm nghẽn đối với các tác vụ lặp đi lặp lại, tự động hóa và các quy trình làm việc do AI (tác nhân) điều khiển. Một tác nhân AI có thể điều hướng các thao tác nhấp chuột và giao diện chỉ dựa trên hình ảnh, nhưng điều này đòi hỏi một lớp diễn giải hình ảnh bổ sung, không phải là ngôn ngữ gốc, làm chậm quá trình và thêm chi phí không cần thiết, dẫn đến việc tiêu hao nhanh chóng các token.

Đây là lúc mà Unity CLI mới và gói Unity Pipeline thử nghiệm phát huy tác dụng.

Như tên gọi của nó, Unity CLI là giao diện dòng lệnh để quản lý Unity. Vì không có giao diện người dùng đồ họa, nó đặc biệt phù hợp cho tự động hóa và các quy trình làm việc dựa trên tác nhân. Nó hoạt động như một ứng dụng độc lập, bao gồm tất cả những gì cần thiết để chạy, quản lý và tương tác với Unity. Nói cách khác, bạn có thể chạy các lệnh từ thiết bị đầu cuối giao tiếp trực tiếp với Unity, thay thế lớp thao tác chuột và toàn bộ quy trình làm việc trong Hub hoặc Editor.

Ghi chú: Các tính năng mới và cải tiến đang được bổ sung thường xuyên. Tại thời điểm viết bài này, phiên bản 1.0.0-beta.6 của Unity CLI kết hợp với gói com.unity.pipeline phiên bản 0.5.0-exp.1 và Unity 6000.6.0b9 là cấu hình cập nhật nhất. Nếu gặp sự cố, hãy tham khảo tài liệu hướng dẫn sử dụng Unity CLI: https://docs.unity.com/en-us/unity-cli/use-unity-cli

Cách Unity CLI và gói Pipeline hoạt động cùng nhau

Mặc dù công cụ nhị phân Unity CLI độc lập xử lý việc thiết lập môi trường của bạn (như cài đặt trình chỉnh sửa, mô-đun và quản lý giấy phép), giá trị thực sự nằm ở việc kết hợp nó với gói Unity Pipeline ( com.unity.pipeline ).

Gói Unity Pipeline này về cơ bản biến trình soạn thảo đang chạy của bạn thành một máy chủ HTTP cục bộ. Vì trình chỉnh sửa vẫn mở trong nền, các cảnh đã tải và cơ sở dữ liệu tài nguyên của bạn vẫn được lưu trữ "sẵn sàng" trong bộ nhớ hệ thống. Bằng cách lưu trữ mọi thứ sẵn có, bạn sẽ hoàn toàn tránh được sự phiền phức khi khởi động động cơ từ trạng thái nguội. Thiết bị đầu cuối của bạn (hoặc một tác nhân AI) giờ đây có thể điều khiển Trình chỉnh sửa ngay lập tức để chạy thử nghiệm, tải cảnh hoặc sửa đổi GameObjects.

Hệ thống này cũng xử lý được tình trạng tắc nghẽn khi tải lại tên miền. Trước khi có gói Pipeline, mỗi khi bạn hoặc tác nhân AI của bạn thực hiện thay đổi trực tiếp vào một tập lệnh C# trên ổ đĩa, bạn phải đợi Unity xây dựng lại dự án và tải lại miền. Một số thao tác thậm chí còn yêu cầu bạn phải tập trung hoặc nhấp chuột vào một mục nào đó trong Trình chỉnh sửa trước khi nó có thể tiếp tục.

Nhưng máy chủ cục bộ của gói Pipeline xử lý quá trình biên dịch đó hoàn toàn bất đồng bộ. Kết nối luôn ổn định và hoạt động trong suốt quá trình biên dịch, đảm bảo phiên làm việc trên terminal của bạn không bị gián đoạn hoặc hết thời gian chờ trong khi Trình soạn thảo đang tải lại ở chế độ nền.

Mọi thứ sẽ còn nhanh hơn nữa khi bạn thực thi mã một cách động thông qua lệnh eval . Tại đây, gói Pipeline trong Editor hoạt động như một trình dịch tức thời, biên dịch đoạn trích C# của bạn ngay lập tức và đưa trực tiếp vào luồng chính của Unity. Vì quá trình thực thi động này hoàn toàn khép kín, nó bỏ qua hoàn toàn quá trình biên dịch lại toàn bộ dự án và tải lại miền. Bạn sẽ bỏ qua hoàn toàn thời gian chờ đợi tẻ nhạt và nhận được kết quả chỉ trong vài mili giây.

Điều này có nghĩa là các tập lệnh tự động hóa nặng của bạn sẽ không bị lỗi hoặc mất kết nối chỉ vì quá trình biên dịch dự án lớn đang diễn ra ở chế độ nền, trong khi các lệnh terminal nhanh của bạn vẫn hoạt động với độ trễ gần như bằng không. Bạn có được sự ổn định và tốc độ trong cùng một công cụ.

Chuyển từ MCP sang Unity CLI

Có lẽ bạn đang thắc mắc, “Vậy còn máy chủ Giao thức Ngữ cảnh Mô hình (MCP) chính thức Unity thì sao?” Tại sao tôi không nên cứ dùng hoặc tiếp tục dùng cái đó?”

Câu trả lời ngắn gọn là chúng tôi sẽ không ngừng hỗ trợ MCP. Tuy nhiên, gói Unity CLI và Pipeline xử lý tất cả các trường hợp sử dụng tương tự như MCP và thậm chí nhiều hơn nữa, nhưng thực hiện chúng tốt hơn và nhanh hơn nhiều.

Câu trả lời chi tiết hơn nằm ở kiến ​​trúc. Các thiết lập MCP truyền thống yêu cầu một công cụ hỗ trợ máy khách hoạt động (như Claude Desktop hoặc Cursor) để đóng vai trò là bộ phiên dịch giữa tác nhân AI của bạn và Unity. Nhưng các tác nhân hiện đại, được thiết kế dành riêng cho giao diện dòng lệnh như Claude Code đã cực kỳ giỏi trong việc chạy trực tiếp các lệnh shell tiêu chuẩn. Bằng cách sử dụng các lệnh CLI trực tiếp như unity command hoặc unity eval , bạn hoàn toàn bỏ qua được công đoạn cấu hình và bảo trì máy chủ MCP. Nhân viên hỗ trợ của bạn có thể giao tiếp trực tiếp với Unity thông qua một máy chủ HTTP cục bộ thống nhất, cực nhanh. Điều này có nghĩa là bạn viết các cấu hình gọn gàng hơn, dành ít thời gian hơn để gỡ lỗi các socket kết nối và có thể cho phép AI của bạn hoạt động với tốc độ thuần túy, giống như tốc độ của thiết bị đầu cuối gốc.

Ngoài ra, máy chủ MCP cũ chạy trực tiếp bên trong tiến trình Editor dưới dạng một gói C#. Điều này có nghĩa là cầu nối kết nối đó gắn liền với luồng chính và không gian bộ nhớ của Unity. Ngay khi bạn biên dịch mã hoặc kích hoạt tải lại miền, Unity sẽ giải phóng bộ nhớ, điều này thường gây ra hiện tượng mất kết nối, ném ra ngoại lệ null hoặc làm cho tác nhân bị kẹt giữa vòng lặp.

Gói com.unity.pipeline hiện tại cũng là một gói C# chạy bên trong Trình chỉnh sửa, nhưng nó cung cấp một máy chủ HTTP và API REST (không phải cầu nối socket), đó là lý do tại sao nó có khả năng chống chịu tốt hơn với việc tải lại tên miền. Vì máy chủ cục bộ này xử lý các lệnh bất đồng bộ, kết nối thiết bị đầu cuối của bạn vẫn hoàn toàn ổn định và hoạt động ngay cả trong quá trình biên dịch nặng và tải lại tên miền.

Tóm lại, bằng cách chuyển sang sử dụng Unity CLI, bạn hoàn toàn tránh được tình trạng mất kết nối và lãng phí token. Cuối cùng, giao diện dòng lệnh (CLI) cũng cung cấp chế độ MCP nếu bạn có trường hợp sử dụng cụ thể nào muốn dùng MCP.

Cài đặt gói CLI và Pipeline

Việc cài đặt các gói CLI và Pipeline được thực hiện tự động bằng Unity Hub trong các phiên bản mới nhất. Tại thời điểm viết bài này, có nhiều cách để cài đặt Unity CLI, vì vậy hãy đảm bảo bạn tham khảo tài liệu hướng dẫn để có thông tin chính xác nhất.

Nếu vì lý do nào đó bạn chưa cài đặt nó, cách đơn giản nhất là sử dụng các lệnh trong terminal để thực hiện quá trình cài đặt. Bạn có thể xem video hoặc làm theo hướng dẫn bên dưới.

Để cài đặt Unity CLI, tất cả những gì bạn cần làm là chạy các lệnh sau từ terminal của mình, tùy thuộc vào nền tảng bạn đang sử dụng:

# macOS hoặc Linux

curl -fsSL https://public-cdn.cloud.unity3d.com/hub/prod/cli/install.sh | UNITY_CLI_CHANNEL=beta bash

# Windows

$env:UNITY_CLI_CHANNEL='beta'; irm https://public-cdn.cloud.unity3d.com/hub/prod/cli/install.ps1 | iex

Bước tiếp theo là cài đặt gói Unity Pipeline:

cài đặt pipeline Unity

Sau khi cả hai được cài đặt xong, bạn có thể kiểm tra lại xem chúng đã hoạt động bình thường chưa.

Kiểm tra việc lắp đặt

Để xác nhận việc cài đặt, chỉ cần chạy lệnh sau:

trạng thái thống nhất

Nó sẽ trả về kết quả tương tự như thế này:

Unity Editor (cổng 7800): readyProject: /Users/thomaskr/Github/UnityProjects/MyAwesomeProjectVersion: 6000.6.0b7PID: 85009

Nếu bạn thấy trạng thái "sẵn sàng" bên cạnh dòng đầu tiên, điều đó có nghĩa là Trình soạn thảo đang hoạt động và có thể truy cập được. Nó cũng xác nhận cổng mà trình chỉnh sửa đang sử dụng, đường dẫn dự án, phiên bản trình chỉnh sửa và mã định danh tiến trình (PID).

Tiếp theo, để đảm bảo quyền truy cập của bạn đã được xác thực, hãy chạy lệnh sau:

đăng nhập xác thực Unity

Thao tác này sẽ mở trình duyệt của bạn để đăng nhập bằng OAuth vào tài khoản Unity của bạn. Sau khi xác thực, CLI sẽ lưu thông tin đăng nhập của bạn vào kho khóa hệ thống để các lệnh sau này cần xác thực (như danh sách dự án Unity, xây dựng Unity, cấp phép Unity, Unity Cloud ) sẽ hoạt động tự động mà không cần nhắc lại.

Thực hiện một vài lệnh cơ bản

Sau khi cài đặt CLI và gói Pipeline, đã đến lúc thử thêm một vài lệnh nữa. Chúng ta hãy bắt đầu với lệnh `unity --help` , lệnh này sẽ cung cấp cho bạn cái nhìn tổng quan nhanh chóng về tất cả những gì bạn có thể làm.

sự thống nhất --trợ giúp

Lệnh `unity --help` cung cấp cho bạn danh sách tất cả các lệnh cơ bản có sẵn cùng với tổng quan và các tùy chọn cho mỗi lệnh.

Thoạt nhìn, số lượng tùy chọn có thể hơi choáng ngợp, nhưng cú pháp giao diện dòng lệnh (CLI) tuân theo một khuôn mẫu rất logic và nhất quán.

Hãy sử dụng một lệnh mà chúng ta vừa dùng làm ví dụ, nhưng lần này có thêm một tùy chọn:

đăng nhập xác thực Unity --không tương tác

Từ trái sang phải:

• Lệnh `unity` kích hoạt Unity CLI và do đó là lệnh chính.
• Lệnh `auth login` là các lệnh con. Bạn có thể coi chúng như những động từ cho chương trình chính biết chính xác hành động cần thực hiện. Ở đây, lệnh `auth` hướng CLI đến hệ thống xác thực, còn lệnh `login` yêu cầu CLI đăng nhập cho bạn.
• --non-interactive là tùy chọn. Hãy coi các tùy chọn tương tự như các tham số. Chúng là các từ bổ nghĩa cho biết mệnh lệnh đó hoạt động như thế nào. Trong trường hợp này, nó yêu cầu giao diện dòng lệnh (CLI) đăng nhập trực tiếp vào thiết bị đầu cuối thay vì mở cửa sổ trình duyệt. Các tùy chọn đôi khi cũng được gọi là "cờ" khi được sử dụng trong ngữ cảnh bật/tắt.

Ngoài ra còn có một phím tắt chỉ gồm một chữ cái được thiết kế để gõ nhanh trong quy trình làm việc hàng ngày của bạn với terminal.

Quay trở lại với tùy chọn trợ giúp của chúng ta ( --help ), thay vì chạy unity --help, bạn cũng có thể chỉ cần sử dụng unity -h , cả hai đều cho bạn cùng một câu trả lời.

sự thống nhất --trợ giúp # Phiên bản cờ dài (cải thiện khả năng đọc) unity -h # Phiên bản cờ ngắn (nhanh hơn trong công việc hàng ngày)

Các ký hiệu ngắn sử dụng dấu gạch ngang đơn (-) và được thiết kế như một lối tắt, trong khi các ký hiệu dài sử dụng dấu gạch ngang kép (--) và là các mô tả đầy đủ tương đương được thiết kế để dễ đọc.

Lệnh --help là công cụ quan trọng nhất trong bộ công cụ của bạn; bạn có thể thêm nó vào bất kỳ cấp độ nào của lệnh lồng nhau để nhận tài liệu nhanh chóng. Dưới đây là một vài ví dụ về lệnh xác thực mà chúng ta vừa tìm hiểu:

# Trợ giúp về các lệnh xác thực

unity auth --help

# Trợ giúp cụ thể cho lệnh đăng nhập

unity auth login --help

Mỗi màn hình trợ giúp sẽ ngay lập tức hiển thị chính xác lệnh đó làm gì, những tùy chọn nào có sẵn và những đối số mà lệnh đó yêu cầu. Khi không chắc chắn, hãy hỏi trực tiếp lệnh đó!

Hãy thử các lệnh phát hành làm một ví dụ khác:

bản phát hành Unity

Điều này giúp tôi có cái nhìn tổng quan tuyệt vời về mọi phiên bản Unity hiện có tại thời điểm viết bài này.

Bây giờ chúng ta hãy thêm tùy chọn --help :

bản phát hành unity --help

Lệnh `unity releases --help` sẽ giải thích tất cả các tùy chọn khác nhau mà bạn có thể thêm vào để thu hẹp phạm vi tìm kiếm các phiên bản Unity .

Ví dụ, tại thời điểm viết bài này, chúng tôi đang sử dụng phiên bản beta của Unity 6.6b7 và muốn cài đặt phiên bản beta mới nhất. Chúng ta có thể sử dụng lệnh cài đặt Unity cơ bản, lệnh này sẽ cung cấp cho chúng ta một giao diện trực quan đơn giản, nơi chúng ta có thể chọn phiên bản mình muốn.

cài đặt unity

Chúng ta hãy chọn phiên bản b9, phiên bản này sẽ khởi chạy trình cài đặt ngầm (và sẽ mất vài phút để hoàn tất).

Thay vì sử dụng trình hướng dẫn cài đặt, bạn cũng có thể sử dụng lệnh --help để xem tổng quan về tất cả các lệnh:

unity install --help

Điều này mang đến cho bạn cái nhìn tổng quan như sau:

Từ danh sách, bạn có thể thấy rằng bạn có thể truyền phiên bản Unity mà bạn muốn cài đặt làm đối số. Điều này có nghĩa là nếu bạn muốn cài đặt một phiên bản cụ thể, bạn có thể thực hiện việc này chỉ bằng một lệnh duy nhất:

#Chỉ cần thay thế phiên bản bằng phiên bản bạn muốn sử dụng

unity install 6000.5.9f1

Trong khi đó, phiên bản mới của trình soạn thảo đã được cài đặt xong, vì vậy bây giờ chúng ta cần nâng cấp dự án. Để làm điều này, hãy thêm phiên bản cụ thể mà bạn muốn mở dự án. Điều này cũng giống như việc bạn vào Hub và chọn một phiên bản Editor khác để mở theo dự án, từ đó kích hoạt quá trình nâng cấp dự án.

unity open --version 6000.6.0b9

Như chúng ta đã đề cập trước đó, gói Pipeline mở ra một bộ công cụ khổng lồ chứa gần như mọi thứ bạn có thể làm bên trong Unity Editor (và các lệnh mới liên tục được bổ sung khi phiên bản beta hoàn thiện).

Nếu bạn muốn xem các lệnh hiện có trong dự án của mình, hãy chạy lệnh sau:

danh sách thống nhất

Lệnh này cung cấp cho bạn một bảng tổng quan hiển thị tên, nhóm và mô tả ngắn gọn cho mỗi lệnh. Nó hoạt động rất tốt như một điểm khởi đầu để nhanh chóng duyệt qua hàng trăm lệnh tích hợp sẵn như eval , add_animator_layer , build và find_assets .

Khi bạn cần biết chính xác cách định dạng dữ liệu đầu vào. Bạn có thể chạy:

lệnh thống nhất

Chạy lệnh này mà không có đối số sẽ cung cấp cho bạn "bản thiết kế" chi tiết của các lệnh Unity với tài liệu hướng dẫn cho từng lệnh đã đăng ký, bao gồm cả các tùy chọn (các cờ và kiểu dữ liệu chính xác mà lệnh yêu cầu).

Cả hai lệnh đều tương tác với cùng một tiến trình Editor được kết nối, nhưng chúng trả về các mức độ chi tiết khác nhau. Khi bạn bắt đầu xây dựng các kịch bản tự động hóa tùy chỉnh hoặc thiết lập các quy trình làm việc dựa trên tác nhân để điều khiển Unity , lệnh unity command sẽ nhanh chóng trở thành công cụ tra cứu được sử dụng nhiều nhất để cấu trúc các lệnh gọi tự động, rõ ràng.

Cuối cùng, hãy cùng xem xét lệnh `eval` và cách chạy một bài kiểm tra `Debug.Log` đơn giản ( "Hello World" ) bên trong bảng điều khiển Unity của chúng ta. `eval` là một lệnh trong gói Pipeline (và có thể nói là lệnh thú vị nhất trong số hơn 140 lệnh tích hợp sẵn) dùng để biên dịch và thực thi mã C# một cách động trong tiến trình Editor. Hãy thử chạy lệnh sau:

unity command eval --code 'Debug.Log("hello from unity cli");'

Điều này sẽ cho bạn kết quả sau, trong đó JSON trả về "success": true nếu nó hoạt động.

Trong Trình chỉnh sửa, bạn có thể kiểm tra xem thao tác này đã thực sự thành công hay chưa trong cửa sổ Console .

Hãy cùng phân tích lệnh này:

unity command eval --code 'Debug.Log("hello from unity cli");'

Đọc từ trái sang phải:

1. Unity chạy công cụ CLI Unity .
2. Lệnh này là lệnh phụ hướng dẫn nó "giao tiếp với Trình chỉnh sửa được kết nối".
3. eval là một lệnh con cấp hai, có nghĩa là "thực thi (chạy) một đoạn mã nào đó cho tôi".
4. --code là một tùy chọn (hoặc cờ) cho biết "đây là đoạn mã cần chạy".
5. 'Debug.Log("hello from unity cli");' là giá trị cho --code ; đây là đoạn mã thực tế cần thực thi.

Kết nối chương trình LLM

Việc làm quen với một vài lệnh cơ bản có thể giúp tăng tốc một số công việc bảo trì với các cài đặt Unity của bạn, nhưng điểm mạnh thực sự của nó là khi bạn bắt đầu tự động hóa và tích hợp các quy trình làm việc dựa trên tác nhân.

Với Unity CLI và gói Pipeline, bạn có thể kết nối với tác nhân mà mình lựa chọn. Điều này có nghĩa là dù bạn đang sử dụng Claude, Codex, Copilot hay các mô hình cục bộ, v.v., giao diện dòng lệnh (CLI) được thiết kế để tích hợp với thiết lập hiện có mà bạn ưa thích và sẽ kết nối mà không cần bất kỳ thiết lập bổ sung nào.

Đơn giản chỉ cần mở cửa sổ dòng lệnh, điều hướng (bằng lệnh cd) trực tiếp đến thư mục dự án Unity của bạn và khởi động tác nhân bằng cách nhập "claude" (hoặc lệnh của tác nhân). Bạn có thể xác nhận mình đã kết nối bằng cách hỏi nhân viên hỗ trợ một câu hỏi tương tự như sau:

Chạy lệnh "unity command" trong bash và cho tôi biết nó có thể làm gì, sau đó kiểm tra một lệnh "eval" đơn giản.

Kết nối LLM bằng MCP

Unity đã loại bỏ máy chủ MCP tích hợp trong trình chỉnh sửa thuộc gói com.unity.ai.assistant . Nó đã được thay thế bằng máy chủ MCP tích hợp sẵn của Unity CLI ( unity mcp ), được hỗ trợ bởi gói Unity Pipeline. Nó sử dụng cùng một giao thức, vì vậy các máy khách kết nối liền mạch. Chế độ MCP vẫn được hỗ trợ đầy đủ cho các tác nhân không thể chạy các lệnh shell tùy ý hoặc gặp khó khăn trong việc soạn thảo dòng lệnh.

Để sử dụng MCP, hãy chạy lệnh sau:

cấu hình unity mcp

Lệnh này tự động chèn cấu hình trực tiếp vào cài đặt của tác nhân. Để kiểm tra xem LLM của bạn đã được kết nối hay chưa, hãy thực hiện một bài kiểm tra nhỏ bằng cách yêu cầu công cụ LLM chạy một lệnh tương tự như sau:

Tôi muốn bạn tạo một khối lập phương 2 × 2 × 2 ở trung tâm của khung cảnh mà tôi đang mở. Sau đó, tạo một đoạn mã để nó liên tục quay quanh cả ba trục với tốc độ 45 độ mỗi giây.

Đây là phản hồi của Claude Code:

Sau khi hoàn tất, chương trình sẽ chuyển sang chế độ Chơi và chạy cảnh để bạn có thể kiểm tra xem khối lập phương có quay đúng cách hay không.

Mở rộng bằng các lệnh tùy chỉnh của riêng bạn

Bộ công cụ tích hợp sẵn của CLI bao gồm tất cả các chức năng cơ bản như bật/tắt chế độ Play, biên dịch lại và chạy kiểm thử đơn vị. Tuy nhiên, sức mạnh thực sự của kiến ​​trúc này nằm ở khả năng mở rộng của nó. Bạn có thể dễ dàng viết các lệnh tùy chỉnh để cung cấp cho các tác nhân AI của mình ngữ cảnh phù hợp, cụ thể cho từng dự án và các công cụ độc đáo được xây dựng riêng cho trò chơi của bạn.

Việc tạo lệnh tùy chỉnh rất đơn giản. Tất cả những gì bạn cần làm là viết một phương thức tĩnh chuẩn trong C# và trang trí nó bằng các thuộc tính [CliCommand] và [CliArg] .

Gói Pipeline tự động phát hiện các thuộc tính này trong quá trình biên dịch, nghĩa là nó không yêu cầu bất kỳ cấu hình thủ công hoặc tệp đăng ký nào. Khi bạn chạy lệnh unity mà không có đối số nào, giao diện dòng lệnh (CLI) sẽ tự động liệt kê tất cả các lệnh tùy chỉnh có sẵn cùng với các lệnh tích hợp sẵn.

Ghi chú: Thuộc tính [CliCommand] giúp các lệnh có thể được tìm thấy và gọi thông qua giao diện dòng lệnh (CLI). Đối với việc thực thi có tham số, bạn gọi trực tiếp phương thức bằng lệnh `eval` của Unity với cú pháp C#, thay vì truyền các cờ kiểu CLI.

Hãy cùng xem một ví dụ nhanh về lệnh tùy chỉnh "Hello World" hoạt động như thế nào.

Tạo một tập lệnh C# mới có tên là HelloWorldCommand.cs . Hãy đảm bảo rằng lớp và phương thức là static, và bao gồm không gian tên Unity :

using UnityEngine;

Sử dụng Unity;

public static class HelloWorldCommand

{

[CliCommand("hello-world", "Một lệnh hello world đơn giản")]

public static void SayHello()

{

Debug.Log("Hello, World! Đây là một lệnh CLI tùy chỉnh.");

}

}

Để chạy lệnh mới, hãy mở cửa sổ dòng lệnh (terminal) và thực hiện lệnh sau:

lệnh unity hello-world

Giao diện terminal sẽ trông giống như thế này.

Và nhật ký console của bạn sẽ trông như thế này:

Bạn cũng có thể mở rộng tính năng này nếu cần truyền tham số bằng thuộc tính [CliArg] .

using UnityEngine;

Sử dụng Unity;

public static class HelloWorldCommand

{

[CliCommand("hello-world", "Một lệnh hello world đơn giản")]

public static void SayHello(

[CliArg("name", "Người cần chào hỏi")] string name)

{

Debug.Log($"Hello, {name}! Đây là một lệnh CLI tùy chỉnh.");

}

}

Để chạy lệnh mới, hãy mở cửa sổ dòng lệnh và thực thi:

lệnh unity hello-world --name "thomas"

Cài đặt plugin Unity Agent

Unity cũng cung cấp một plugin phát triển game chính thức, hiện tại (tính đến thời điểm viết bài này) dành cho Claude Code, Codex và Grok. Nó cung cấp các kỹ năng được chọn lọc cho việc phát triển game và tối ưu hóa hiệu năng. Sau khi cài đặt, các kỹ năng sẽ tự động được tải khi bạn làm việc trên một dự án Unity trong bất kỳ trình soạn thảo nào ở trên. Để cài đặt cho Claude, chỉ cần chạy lệnh này:

claude plugin marketplace add Unity-Technologies/unity-agent-plugin

github.com/Unity-Technologies/unity-agent-plugin

Một mẹo nhanh khác nếu bạn là người dùng Claude Code và đang bắt đầu một dự án mới là chạy giai đoạn khởi tạo, giai đoạn này sẽ thiết lập Claude với các thông tin cơ bản về dự án của bạn bằng cách tạo tệp claude.md . Đó là một tập tin Markdown nằm ở thư mục gốc của dự án mà Claude Code sẽ đọc khi bắt đầu mỗi phiên làm việc.

/init # Chạy lệnh này bên trong Claude Code

Bằng cách đó, bạn có thể dùng nó để cho Claude biết về bộ công nghệ mà bạn ưa thích, ví dụ như bạn thích uGUI hơn UI Toolkit làm giao diện người dùng, Input System mới hơn so với trình quản lý nhập liệu cũ hơn, v.v. Nó cũng có thể được sử dụng cho các quyết định về kiến ​​trúc, chẳng hạn như sử dụng mẫu định vị dịch vụ thay vì các singleton, MVP cho thiết kế giao diện người dùng, v.v.

Trong khi Claude cũng tự động xây dựng bộ nhớ khi hoạt động, lưu lại những gì đã học được qua các phiên mà không cần bạn nhập bất cứ thứ gì, tệp Claude.md giúp định hướng tổng thể cho dự án cụ thể.

Trong quá trình thực hiện, bạn có thể cân nhắc bổ sung thêm các hướng dẫn tùy chỉnh, chẳng hạn như hướng dẫn về kiểu mã của bạn. Tôi đã viết một bài báo về cách thức hoạt động này đối với các hướng dẫn tùy chỉnh trong trợ lý AI, nhưng các nguyên tắc hoàn toàn tương tự đối với Claude Code nếu bạn muốn tìm hiểu thêm.

Tiếp theo là gì?

Chúng tôi hy vọng phần giới thiệu này sẽ hữu ích giúp bạn bắt đầu. Nếu bạn muốn tối ưu hóa hơn nữa quy trình làm việc của tác nhân, hãy xem bài viết về thiết lập các hướng dẫn tùy chỉnh cho LLM của bạn, bao gồm cả việc xác định hướng dẫn kiểu mã C# Unity .

Hãy xem video tại đây:

Giao diện dòng lệnh (CLI) Unity