Unity CLI 사용 시작하기

[음악] >> 이 영상에서는 Unity CLI 설치 및 사용에 대한 간략한 개요를 제공합니다. Unity 에디터의 가장 큰 장점 중 하나는 직관적이고 사용자 친화적이어서 믿을 수 없을 만큼 복잡한 프로젝트를 시각화하고 관리하기 쉽다는 것입니다. 프리팹 검사, 머티리얼 값 조정, 테스트 실행, 조명 작업, 또는 [음악] 콘솔 오류 추적 등은 모두 몇 번의 마우스 클릭만으로 가능합니다. 이것이 거의 20년 동안 사용되어 온 방식이지만, 반복적인 작업, 자동화, [음악] 그리고 AI 기반 또는 에이전트 워크플로우에서는 병목 현상이 되기도 합니다.

AI 에이전트가 클릭 및 시각적 인터페이스만 탐색할 수는 있지만, >> [음악] >> 그렇게 하는 것은 추가적인 비네이티브 수준의 시각적 해석을 필요로 하며 >> 이는 오류가 발생하기 쉽고, 프로세스를 늦추며, 불필요한 오버헤드를 추가하여 토큰을 매우 빠르게 소모합니다. 바로 여기에 새로운 Unity CLI와 실험적인 Unity 파이프라인이 등장합니다. >> 이름에서 알 수 있듯이, Unity CLI는 Unity를 관리하는 명령줄 인터페이스입니다. 그래픽 사용자 인터페이스(GUI)가 없기 때문에 자동화 및 에이전트 워크플로우에 매우 적합합니다.

다시 말해, [음악] 터미널이나 Unity와 직접 통신하는 에이전트에서 간단히 실행할 수 있으며, 허브나 에디터의 마우스 클릭과 전체 워크플로우를 대체합니다. 여기에는 함께 작동하는 두 부분이 있습니다. CLI와 파이프라인 패키지입니다. Unity CLI는 편집기 설치, 라이선스 관리 또는 프로젝트 열기와 같은 환경을 처리하는 독립 실행형 바이너리입니다. 진정한 마법은 두 번째 부분인 파이프라인 패키지입니다. [음악] 이를 프로젝트에 설치하면, 실행 중인 에디터가 로컬 서버가 됩니다.

그리고 에디터가 백그라운드에서 열려 있기 때문에, 여러분의 씬과 [음악] 애셋 데이터베이스는 메모리에서 따뜻하게 유지됩니다. 모든 명령마다 콜드 스타트 엔진 부팅이 필요 없습니다. 그렇다면 이것은 [음악] MCP 문제와 무엇이 다를까요? 이 경우, 서버가 컴파일을 비동기적으로 처리합니다. [음악] 여러분의 연결은 도메인 리로드 내내 살아있게 유지되며, 코드를 동적으로 실행할 때도 플립(on the fly)으로 스니펫을 컴파일하여 Unity 메인 스레드에서 실행하며, 프로젝트 전체 재컴파일을 완전히 건너뜁니다.

결과는 밀리초 단위로 돌아옵니다. 이것을 설치하는 것은 [음악] 두 개의 명령만 필요합니다. CLI 자체를 위한 설치 프로그램 명령어 하나가 필요한데, 이는 문서에서 여러분의 특정 플랫폼에 맞춰 가져올 수 있습니다. 그 링크는 설명란에 있습니다. [음악] Mac OS와 Linux에서는 Homebrew를 사용하여 CLI를 설치할 수도 있습니다. 이렇게 하면 Homebrew가 최신 상태로 유지하고 업데이트해 줍니다. 그런 다음, 프로젝트 폴더 안에서 터미널을 열고 Unity pipeline install을 실행하여 파이프라인 패키지 [음악]를 여러분의 프로젝트에 추가합니다. 이것이 작동했는지 확인하려면 Unity 에디터가 열려 있는지 확인한 후, [음악] 상태(status) 명령어를 실행하세요.

'ready'라는 메시지가 보인다면, 여러분의 에디터는 라이브하고 접근 가능하며, 포트, 프로젝트 경로, 버전 정보도 함께 표시됩니다. 마지막으로, Unity auth login을 사용하여 브라우저를 열고 한 번 로그인합니다. 그 후에는 자격 증명이 시스템 키링에 저장되어 다시 요청받지 않습니다. 명령어 목록은 [음악] 처음에는 압도적으로 보일 수 있지만, 모든 명령어는 동일한 왼쪽에서 오른쪽 패턴을 따릅니다. 이 예시를 살펴보겠습니다. Unity auth login --non-interactive. 이 경우, Unity가 메인 명령이고, auth login이 서브 명령입니다.

이러한 요소들을 동사처럼 생각할 수 있습니다. 그리고 대시(-)로 시작하는 것은 명령의 동작 방식을 변경하는 옵션이나 수정자입니다. >> 여기서 --non-interactive는 '브라우저를 열지 않고 터미널에서 로그인해라'라는 의미입니다. 전체 단어를 사용하려면 이중 대시(--)를, 짧은 버전을 사용하려면 단일 대시(-)를 사용합니다. 예를 들어, unity-h와 unity--help는 실제로는 같은 명령입니다. --help 옵션은 초보자가 알아야 할 가장 중요한 것일 것입니다.

이것을 어떤 명령에도 붙일 수 있으며, [music] 이 명령어의 기능과 어떤 옵션을 받는지, 그리고 무엇을 기대하는지 정확하게 알려줄 것입니다. 여러분의 도구에 대해 이것들을 외울 필요는 전혀 없습니다. 의심스러울 때는 에이전트에게 그냥 help 옵션을 가리키기만 하면 되고, 그러면 에이전트는 스스로 명령이 무엇을 하는지, 어떻게 사용하는지를 학습할 것입니다. 자, 이 모든 것을 제외하고 편집기는 여기서 실제로 무엇을 할 수 있을까요? unity list를 실행하면 전체 [music] 옵션 표를 얻을 수 있습니다. 테스트 실행부터 프로젝트 빌드까지 100개가 넘는 빌딩 명령들이 있습니다.

가장 흥미로운 것은 아마도 eval일 것입니다. 이는 C# 코드를 편집기 프로세스 내에서 직접 컴파일하고 실행합니다. 한번 살펴보겠습니다. 이전과 같은 패턴을 사용할 것입니다. unity, 그리고 연결된 [music] 편집기와 통신하는 명령어, 다음으로 eval, 마지막으로 실행할 스니펫이 담긴 --code를 사용합니다. JSON은 success true와 함께 반환됩니다. 그리고 지금 편집기로 이동하면 결과가 로그에 있는 것을 볼 수 있습니다. 이 전체 라운드[music] 트립은 도메인 리로드 없이 단 몇 밀리초 만에 완료되었습니다. CLI를 사용하는 것의 가장 큰 장점은 여러분의 에이전트들도 그것에 접근할 수 있다는 것입니다.

그리고 여기서 의미하는 바는 여러분이 선호하는 어떤 모델이든 상관없이, Claude, Codex, Cursor, Copilot 등 모든 에이전트가 가능하다는 것입니다. 만약 그 에이전트가 셸 명령을 실행할 수 있다면, 편집기를 구동할 수 있습니다. 왜냐하면 에이전트에게 CLI는 단지 또 다른 커맨드 라인 도구일 뿐이기 때문입니다. 명령을 보내고, 출력을 읽으면 되며, 여기에 Unity에 특화된 것을 가르칠 필요가 없습니다. 에이전트는 그저 일반적인 커맨드 라인 도구를 보고, 명령을 보내고, [음악] 응답을 평문 텍스트나 JSON으로 다시 읽어들이면 됩니다. 이를 위해 추가적인 설정은 필요하지 않습니다. 프로젝트 폴더에서 터미널을 열고 여러분의 에이전트를 시작하기만 하면 됩니다.

거기서부터는 모든 도구 상자가 펼쳐집니다. 감을 잡으실 수 있도록, 제 에이전트가 회전하는 재질을 가진 공들이 튀어 오르는 장면을 만들고 있습니다. 스크립트를 작성하고, 모든 것을 연결하며, 플레이 모드를 실행합니다. 이 모든 것이 단 하나의 프롬프트에서 나옵니다. >> 그래서 여러분이 가질 수 있는 질문 중 하나는 이것이 Unity MCP에 실제로 어떤 의미인가 하는 것입니다. >> 사라지는 건가요? 간단히 말해 아닙니다. 저희는 MCP 지원을 포기하는 것이 아니라, [음악] 현재의 구현 방식을 CLI와 그 내장된 MCP 모드로 대체하는 것뿐입니다. CLI와 pipeline 패키지가 MCP가 했던 모든 것을 그리고 더 많은 것을 다루지만, 더 빠르고 더 안정적으로 처리합니다.

만약 여전히 MCP를 통해 작업하는 것을 선호한다면, CLI가 여러분을 지원합니다. 클라이언트에게 MCP 서버를 등록하기 위해 단 하나의 명령만 필요합니다. 이것이 설정입니다. 더 나아가고 싶다면, 동반 기사(companion article)를 보거나 저희 CLI 문서를 확인해 보세요. 두 링크 모두 설명란에 있습니다. 또한 Claude용 공식 플러그인이 있어 도구, [음악] 스킬 및 통합을 원클릭 설치로 묶어 제공합니다. Codex, Cursor, Co-pilot, Kimi, 그리고 Rock용 공식 플러그인은 곧 출시될 예정입니다.