기본 패턴
bash
unity-cli status
unity-cli editor play --wait
unity-cli console --filter all
unity-cli exec "Application.dataPath"설명
unity-cli는 Unity 에디터를 셸 명령으로 직접 제어하게 해 주는 커뮤니티 도구이며, README는 "MCP 없이, Python 없이, 단일 바이너리"라는 점을 핵심으로 내세웁니다.- Codex는 원래 셸 명령 실행에 강하므로, 별도 MCP 구성을 하지 않고도
unity-cli status,unity-cli editor play --wait,unity-cli exec ...같은 명령을 바로 호출할 수 있다는 점이 큰 장점입니다. - README 기준으로 상태 확인, 플레이 모드 제어, 콘솔 로그 읽기, 임의 C# 실행, 메뉴 아이템 호출, 리시리얼라이즈, 프로파일러 조회, 커스텀 툴 호출까지 폭넓게 지원합니다.
- Unity 쪽에서는
unity-connector패키지를 넣으면 에디터 시작 시 자동으로 HTTP 엔드포인트를 열고 인스턴스를 등록하므로, CLI는 이를 찾아 연결하는 구조입니다. - 따라서 "도구 프로토콜 기반 연동"보다 "Codex가 셸에서 Unity를 다루는 흐름"이 더 자연스러운 팀이라면
unity-cli가 더 가볍고 빠르게 맞을 수 있습니다.
빠른 정리
| 관점 | unity-cli의 특징 |
|---|---|
| 접근 방식 | 셸 명령으로 Unity 에디터 제어 |
| 잘 맞는 경우 | Codex가 터미널에서 직접 Unity를 만지게 하고 싶을 때 |
| 강점 | 설정이 비교적 단순하고 셸 친화적 |
| 대표 명령 | status, editor, console, exec, profiler |
| 멀티 인스턴스 | --port, --project로 인스턴스 선택 |
주의할 점
README는 Unity가 백그라운드일 때 명령 처리가 늦어질 수 있으니 Editor Throttling을
꺼 두는 것을 권합니다. 또 exec는 실제 C#을 실행하므로 매우 강력한 대신 영향 범위도
크기 때문에, Codex에게 맡길 때는 작업 범위를 더 명확히 주는 편이 좋습니다.
참고 링크
1 sources