이 웹페이지는 이해를 돕기 위해 기계 번역으로 제공됩니다. 기계 번역으로 제공되는 콘텐츠에 대한 정확도나 신뢰도는 보장되지 않습니다. 번역된 콘텐츠의 정확도에 관해 의문이 있는 경우 웹페이지의 공식 영어 원문을 참고해 주시기 바랍니다.
지난 기사에서 Unity CLI 및 Pipeline 패키지 시작하는 방법을 살펴보았습니다. 이전에 시도해 보지 않았거나 단순히 복습이 필요하다면 여기를 확인해 보세요.
이 기사에서 우리는 개발자 도구 벨트에 추가할 수 있는 몇 가지 명령어를 더 공유하고자 했습니다. 140개 이상의 명령어가 있고 업데이트될 때마다 더 추가되므로, 모두 배울 필요는 없습니다. 하지만 필수 명령어 중 일부를 암기하고 더 많은 옵션이 무엇인지 아는 것은 AI 개발자 워크플로우를 더 잘 활용할 수 있도록 준비시켜 줄 것입니다. 새로운 것들을 훑어보고 골라내고 이미 알고 있는 것은 건너뛰세요. 시작해 봅시다.
자세한 내용으로 들어가기 전에 간단히 고지합니다. 새로운 기능과 개선 사항이 자주 추가되고 있습니다. 작성 시점 기준으로 Unity CLI 1.0.0-beta.10 버전을 com.unity.pipeline 패키지 0.6.0-exp.1 및 Unity 6000.6.0f1과 함께 사용하고 있습니다. 따라서 앞으로 상황이 변경될 수 있으며 문제가 발생하면 Unity CLI 문서를 확인하십시오: https://docs.unity.com/en-us/unity-cli/use-unity-cli.
1. 모든 명령어에 대해 --help를 사용하십시오
당신은 이미 unity --help 명령어를 알고 사용했을 가능성이 높습니다. 하지만, --help는 중첩된 명령어의 어떤 레벨에도 붙여서 즉시 문서를 얻을 수 있습니다. 의심스러울 때는 단순히 끝에 --help를 추가하세요.
다음은 몇 가지 예시입니다.
당신은 이미 unity --help 명령어를 알고 사용했을 가능성이 높습니다. 하지만, --help는 중첩된 명령어의 어떤 레벨에도 붙여서 즉시 문서를 얻을 수 있습니다. 의심스러울 때는 단순히 끝에 --help를 추가하세요.
다음은 몇 가지 예시입니다.모든 편집기 가져오기 문서
unity editors --help
특정 모듈 설치에 대한 매개변수 가져오기
unity install-modules --help
# 인증 명령어 도움말
unity auth --help
로그인 명령어에 대한 도움말
unity auth login --help
모든 도움말 화면은 명령어가 정확히 무엇을 하는지, 사용 가능한 옵션은 무엇인지, 어떤 인수를 기대하는지를 즉시 출력할 것입니다.
--help 플래그는 에이전트가 도구를 탐색하는 데 사용하는 기능이기도 하므로, CLI로 새 세션을 시작할 때 에이전트에게 --help를 실행하도록 요청하여 연결되었는지 확인할 수 있습니다.
2. 명령 목록을 나열하세요
문서와 수많은 옵션 중에서 길을 찾는 것에 대해 말하자면, 이 명령어(인수 없이 실행할 때)도 있습니다.
unity command
이 명령어는 파이프라인 패키지의 로컬 서버를 통해 실행 중인 Unity 에디터 연결하여 에디터의 API 셸에 노출하는 모든 등록된 명령어 목록과 에이전트가 Unity 내부에서 작업을 수행하는 데 사용할 수 있는 목록을 제공합니다.
명령어를 사용하는 한 가지 예는 다음과 같습니다:unity command editor_play
연결된 에디터를 플레이 모드로 전환하여(클릭하는 플레이 버튼의 CLI 등가물) 스크립트가 에디터 UI를 건드리지 않고 실행되도록 합니다. 마찬가지로 대응하는 것은 다음과 같습니다:Unity command editor_stop
에이전트가 CLI가 무엇을 할 수 있는지 알도록 하기 위해 (그리고 때로는 블랙박스처럼 느껴지기 때문에), 새 프롬프트를 시작할 때 시도해 볼 수 있는 팁은 더 탐색적으로 접근하고 Claude, Codex 등에 CLI가 무엇을 할 수 있는지에 대한 맥락을 제공하는 것입니다. 다음과 같은 명령을 실행하여 할 수 있습니다:
bash에서 "unity command"를 실행하고 그것이 무엇을 할 수 있는지 알려주고 간단한 "eval" 명령을 테스트해 주세요.
3. 상태 확인 및 다중 인스턴스 실행
Unity CLI가 실행 중인지 확인하려면 단순히 다음 명령을 사용할 수 있습니다.Unity 상태
이런 식으로 반환되어야 합니다:Unity 에디터 (포트 7800): readyProject: /Users/thomaskr/Github/UnityProjects/MyAwesomeProjectVersion: 6000.6.0d1PID: 85009
첫 번째 줄 옆에 ready 상태가 보인다면, 편집기가 활성화되어 있고 접속 가능하다는 의미입니다. 또한 에디터가 어떤 포트에 있는지, 프로젝트 경로, 에디터 버전 및 프로세스 식별자(PID)도 확인합니다.
unity status는 이미 연결된 모든 에디터를 나열하므로 "어떤 것들이 실행 중인가?"에 스스로 답합니다. 어떤 프로젝트에 Pipeline 패키지가 설치되어 있고 접근 가능한지 구체적으로 알고 싶을 때는 다음을 사용하십시오:# 파이프라인
unity 파이프라인 목록
CLI가 알고 있는 모든 Unity 프로젝트 중 Pipeline 패키지가 실행 중인 프로젝트를 보여주며, 각 프로젝트와 서버 포트, 현재 도달 가능한지 여부를 나열합니다.
여러 편집기가 위 예시처럼 실행 중일 때, 해당 프로젝트 경로를 지정하여 --project-path 로 하나를 대상으로 지정할 수 있습니다. 그렇지 않으면 CLI는 현재 디렉토리를 포함하는 프로젝트를 가진 편집기를 선택합니다.
4. 짧은 플래그와 긴 플래그
대부분의 명령어는 일상적인 터미널 작업 흐름에서 빠른 타이핑을 위해 설계된 단일 문자 단축키도 제공합니다. 따라서 unity --help을 실행하는 대신 unity -h를 사용해도 되는데, 둘 다 같은 답변을 주면서 키 입력을 몇 번 절약할 수 있습니다.unity --help # 긴 플래그 버전 (가독성 향상)
unity -h # 일상적인 사용에서 더 빠름인 짧은 플래그 버전
5. 프로젝트 크기를 확인하세요
공간을 확보하려고 한다면 이 명령이 Unity 프로젝트의 크기를 빠르게 파악하는 데 도움이 될 수 있습니다.
프로젝트당 폴더별 디스크 사용량으로, 얼마나 재생 가능한지(라이브러리/임시) 확인할 수 있습니다
unity projects size
# 크기별로 정렬된 모든 등록된 프로젝트 요약
unity projects size --all
6. 출력 형식을 제어하세요
기본적으로 명령어는 사람이 읽을 수 있는 텍스트를 반환하지만, 스크립트가 파싱할 깔끔한 중첩 JSON이 필요할 때는 형식을 JSON으로 변경할 수 있습니다. 에이전트가 작고 평평한 결과를 직접 읽을 때는 사람이 읽기 쉬운 출력으로 기본 설정하고, 응답에 구조나 크기가 있어서 그렇지 않으면 정규 표현식으로 형식 추측을 해야 하는 경우, --format json으로 전환하십시오.
# Machine-readable JSON
unity editors list --format json
# 사람 친화적인 형식
unity 에디터 목록 --format human
7. 다운로드 없이 모듈 설치 미리보기
다운로드를 확정하고 디스크 공간을 많이 차지하는 모듈을 사용하기 전에, --dry-run을 사용할 수 있습니다. 그러면 아무것도 다운로드하지 않고 어떤 모듈이 설치될지 그리고 그들의 총 크기가 얼마인지 정확하게 보여줍니다.
unity install-modules --module android ios --dry-run
드라이 런을 하면 전체 프로젝트가 어떻게 보일지에 대한 좋은 개요를 얻을 수 있습니다.
8. 컴파일 시점에 커밋하기 전에 빌드의 구성을 검사하십시오
빌드에는 --dry-run이 없지만, 컴파일 비용을 지불하기 전에 모양을 확인할 수 있습니다. unity build는 --target 또는 --profile 중 하나를 필요로 하며, 여러 플래그는 빌드가 시작되기 전에 종료되어 몇 분이 아닌 몇 초 만에 잘못된 대상이나 누락된 빌드 프로필을 잡아냅니다.
실행하기 전에 빌드를 테스트하세요
unity build --list-targets
프로필 목록
unity build --list-profiles
9. 모든 모듈이 포함된 특정 에디터 버전을 한 번에 설치하세요
재현성이 중요한 CI 환경의 경우, 허브 없이 정확한 에디터 버전을 설치할 수 있습니다. 버전은 위치 인자이며, --cm은 자식 모듈을 자동으로 가져오고, 이름이 지정된 플랫폼 모듈은 별도의 install-modules 명령에서 가져옵니다.
# 버전은 --version 플래그가 아니라 위치 기반입니다
unity install 6000.6.0f1
# 자식 모듈 자동 포함
unity install 6000.6.0f1 --cm
# 플랫폼 모듈 추가 (별도 명령, --dry-run 지원)
unity install-modules --module android ios webgl
10. 터미널에서 에디터 설치 및 업그레이드 프로세스
Hub를 사용하여 설치 프로세스를 관리하는 대신, 기본 unity install 명령을 사용하면 Hub를 열지 않고도 설치할 수 있는 모든 에디터 버전을 나열해 줍니다.
# 대화형 설치 가이드
unity 설치
새 버전을 설치한 후, 프로젝트 폴더 경로와 업그레이드할 버전을 지정하는 upgrade 명령을 사용하여 프로젝트를 업그레이드할 수 있습니다.프로젝트에 맞게 프로젝트 경로와 편집기 버전을 교체하세요
unity projects upgrade /Users/thomaskr/Github/UnityProjects/CLIDemo --to 6000.6.0f1
위 스크린샷에서 한 가지 간단한 커맨드 라인 업그레이드가 어떻게 이루어졌는지 볼 수 있습니다.
11. 터미널에서 프로젝트를 생성하세요
CLI를 통해 몇 가지 명령만으로 새 프로젝트를 생성할 수 있습니다:
#기본 대화형 템플릿
unity projects create "CLI demo"
표준 모드를 실행하면 프로세스를 안내하는 대화형 마법사가 제공됩니다. 원하는 에디터 버전을 선택하고, Unity Cloud 연결한 다음, 생성 시 템플릿과 에디터 버전을 선택하여 Hub에서 하는 것처럼 새 프로젝트를 매우 쉽게 설정할 수 있습니다.
하지만 허브와 달리, 원하는 대로 옵션을 정의하기만 하면 자주 사용하는 설정 워크플로우를 자동화할 수도 있습니다. 여기서는 특정 편집기 버전, 템플릿 및 프로젝트 경로를 정의하는 예시입니다.
템플릿 사용(#3D, 2D, VR 등 - 플레이스홀더를 간단히 대체)
unity projects new "CLI demo" --editor-version 6000.6.0b9 --template com.unity.template.3d --path ~/MyProjects
12. 스크린샷 캡처
워크플로우에서 스크린샷을 캡처해야 하는 경우 세 가지 다른 명령을 사용할 수 있습니다.
# PNG 파일로 장면 또는 게임 뷰를 캡처하고 경로를 반환합니다. Params: --view, --output, --width, --height
게임 보기
# 참고: 스크린 공간 오버레이 UI는 카메라 출력에 없으므로 검은색을 반환합니다
unity command screenshot --view game
# 씬 뷰
unity command screenshot ---view scene
특정 해상도와 카메라로 캡처하고, base64를 인라인으로 받으세요
# 합성된 백버퍼를 읽으므로 오버레이 UI가 포함됩니다. 플레이 모드만.
unity command capture_game_view --width 1920 --height 1080 --camera "Main Camera" --save_path Screenshots/check.png
출력은 다음과 같을 것입니다:
이것은 이미지가 별도로 열어야 하는 경로가 아니라 에이전트가 즉시 추론할 수 있는 데이터로 반환되기 때문에 Claude Code 자체 모범 사례 지침의 "이것을 구현하고, 스크린샷을 찍고, 디자인과 비교하기" 검증 루프에 유용할 수 있습니다.
13. 변경 로그
Unity CLI 및 Pipeline 패키지에 새로운 기능이 빠르게 추가되고 있기 때문에, 제가 유용하게 사용하는 명령어 중 하나는 단순히 실행하여 얻을 수 있는 변경 로그입니다.
Unity 변경 로그
최근 변경 사항을 요약하여 주의해야 할 사항과 시도해 볼 만한 새로운 명령어를 간략하게 알려드립니다.
14. Eval을 사용하여 C# 실행
Unity 파이프라인 패키지가 에디터 내에서 실행될 때, CLI는 eval command를 사용하여 에디터 내에서 C# 스니펫을 실시간으로 컴파일하고 실행할 수 있습니다. 프로젝트 수준의 재컴파일이나 도메인 리로드가 없기 때문에 기다리지 않고 밀리초 단위로 실행됩니다. 이것을 사용하여 자동 설정 스크립트를 실행하거나, 에디터 상태를 쿼리하거나, 심지어 unity command eval_file --file path/to/script.cs를 사용하여 디스크의 C# 스크립트 파일을 실행할 수 있습니다.
# 에디터가 현재 플레이 모드인지 여부를 반환합니다
unity command eval --code "return UnityEditor.EditorApplication.isPlaying;"
콘솔 창에 간단한 문자열을 기록합니다
unity command eval --code 'Debug.Log("I was invoked in the terminal");'
15. 테스트
Unity의 테스트 도구인 Unity Test Framework는 CLI에서 직접 실행할 수 있습니다.
Unity 테스트를 두 가지 범주로 나누며, 에이전트가 이를 반복적으로 실행할 때 그 차이가 매우 중요합니다.
- 편집 모드 테스트: 재생 버튼을 누르지 않고 즉시 실행됩니다. 순수 로직(수학, 데이터 처리, MonoBehaviour가 아닌 클래스) 테스트에 적합합니다.
- PlayMode 테스트: 실제로 플레이어가 경험하는 것처럼 게임을 잠시 실행해 보세요. Unity 백그라운드에서 무언가를 다시 로드해야 하기 때문에 더 느립니다.
아마도 EditMode 테스트부터 시작하고 싶을 것입니다. 그것들은 더 빠르고, 작성하기가 더 간단하며, 초기에 필요한 대부분을 다룹니다. Test Framework Unity CLI를 모두 설치했다면 커맨드 라인 호출할 수 있습니다:
# 프로젝트의 EditMode 테스트 실행
unity test --mode EditMode
# 하위 집합으로 필터링하고 JUnit 보고서 작성
unity test --mode EditMode --filter MyNamespace.MyTests --junit-output results.xml
# 최근 변경 사항에 영향을 받는 테스트만 실행
unity test --affected
이것은 모든 EditMode 테스트에서 실행됩니다. --junit-output results.xml을 추가하면 무엇이 통과했고 무엇이 실패했는지에 대한 구조화된 보고서도 얻을 수 있습니다. 그런 다음 에이전트에게 테스트를 실행하고 발견한 내용을 요약해 달라고 요청하세요. 예를 들어 다음과 같이: "EditMode 테스트를 실행하고 실패하는 것만 평이한 영어로 알려주세요." 에이전트가 명령을 실행하고, 보고서를 읽고, 다시 보고하므로 수동으로 로그를 스크롤할 필요가 없습니다.
16. 클라우드 관리
management에 로그인하는 동안 unity auth 아래에 있지만, 터미널에서 Unity Cloud 조직 및 프로젝트를 처리하려면 unity cloud를 사용할 수 있습니다.
# 사용 가능한 모든 클라우드 명령 목록을 엽니다
Unity Cloud
조직 ID 및 계정 받기
unity cloud status
# 활성 조직 ID만 파이프 연결 준비됨
unity cloud org current
17. 의사를 확인하세요
환경을 문제 해결하거나 확인할 때, 인증, 설치 및 로그 파일을 수동으로 감사하는 대신 unity doctor 명령을 사용할 수 있습니다. 이 명령어는 사용 가능한 편집기, 프록시 구성 및 최근 활동 로그를 단일 출력에 포함하여 설정에 대한 포괄적인 상태 검사를 실행합니다. 초기 설정 중 CI 머신에서 발생하는 조용한 구성 오류를 진단하는 데 특히 유용합니다.
# 설정을 진단하세요
유니티 닥터
# 전체 오류 스택 추적을 추가합니다
unity doctor --verbose
사일런트 프록시 구성 오류가 일반적인 빌드 실패 원인이므로 빌드를 실행하기 전에 에디터 상태를 확인하는 것을 고려할 수 있습니다. 이것을 CI 머신에서 설정 중에 간단하게 자동화할 수 있습니다.
unity env 명령도 사용할 수 있습니다. unity doctor의 하위 집합으로, 다운로드 캐시를 지우거나 user-settings.json을 수동으로 검사해야 할 때 필요합니다.
# 해결된 경로 (설치 경로, 캐시 경로, 구성 경로)
unity env
18. 사용자 지정 명령어 만들기
[CliCommand] 속성은 AI 에이전트에게 사용자 지정 스크립트를 제공하기 위해 사용자 지정 명령을 쉽게 작성할 수 있도록 합니다. CLI 명령을 사용하려면 표준 정적 C# 메서드가 필요하며, 이를 [CliCommand] 및 [CliArg] 속성으로 장식해야 합니다.
Pipeline 패키지는 컴파일 중에 이러한 속성을 자동으로 발견하므로 수동 구성이나 등록 파일이 필요 없습니다. 인수 없이 unity command를 실행하면 CLI가 내장 명령과 함께 사용 가능한 모든 사용자 지정 명령을 동적으로 나열합니다.
참고: [CliCommand] 속성은 명령어를 CLI를 통해 검색하고 호출할 수 있게 합니다. 매개변수화된 실행의 경우, CLI 스타일 플래그를 전달하는 대신 C# 구문을 사용하여 unity command eval 메서드를 직접 호출합니다.
빠른 "Hello World" 사용자 지정 명령을 실행해 보겠습니다.
HelloWorldCommand.cs라는 새 C# 스크립트를 만드세요. 클래스와 메서드가 static인지 확인하고 Unity.Pipeline.Commands 네임스페이스를 포함하세요:
using UnityEngine;
using Unity.Pipeline.Commands;
public static class HelloWorldCommand
{
[CliCommand("hello-cli", "안녕하세요 세상 테스트")]
public static void SayHello()
{
Debug.Log("안녕하세요 여러분!") 저는 사용자 지정 CLI 명령입니다.";
}
}
새 명령을 실행하려면 터미널을 켜고 다음을 실행하세요:
unity command hello-cli
실행하면 명령의 결과가 터미널에 출력되고, Debug.Log 출력은 에디터의 콘솔 창에 나타납니다.
사용자 지정 명령 생성에 대해 더 알고 싶으시면 다음 기사에서 다룰 예정입니다.
19. MCP 서버 사용하기
CLI를 사용하는 것이 일반적으로 권장되는 작업 흐름이지만, 네이티브 도구 통합을 원하거나 에이전트가 셸 명령에 어려움을 겪는 경우 Unity CLI를 MCP 서버로도 작동시킬 수 있습니다.
MCP는 에이전트가 원시 셸 실행 및 출력 구문을 피하고 지속적인 연결을 통해 도구 이름, 설명 및 구조화된 스키마에 직접 액세스할 수 있도록 하여 통합을 단순화합니다. CLI는 스크립트 및 수동 워크플로우에 적합한 반면, MCP는 Unity 도구를 AI 워크플로우에 원활하게 통합합니다. 둘 다 의미 있는 성능 차이 없이 동일한 편집기 기능을 제공합니다.
AI 클라이언트는 일반적으로 MCP 서버를 자동으로 실행합니다. 서버가 독립적으로 실행되더라도, 에디터 도구는 파이프라인 패키지가 있는 활성 에디터를 필요로 합니다. MCP를 도구에 문제가 생길 경우의 대안 인터페이스로 생각하십시오. 대부분의 사용 사례에서 Unity CLI가 최선의 선택일 것입니다.
AI 클라이언트를 다음으로 구성하세요:
# 지원되는 에이전트 확인
unity mcp configure --list
Claude Code에 서버 추가
unity mcp configure claude-code
# 또는 현재 프로젝트에만 범위가 지정된 커서로
unity mcp configure cursor --local
# 설정을 작성하지 않고 변경 사항 미리보기
unity mcp configure vscode --dry-run
20. CLI용 Unity 에이전트
Unity CLI용 에이전트 스킬을 제공합니다. 이것은 에이전트가 어떤 명령이 있는지 그리고 어떻게 호출해야 하는지 알 수 있도록 도와줄 수 있습니다. CLI가 대신 설치할 수 있습니다:
# 설치하지 않고 사용 가능한 기술 인쇄
유니티 스킬
# 해당 스킬이 구성된 파일 목록
unity skill show --list
# 지원되는 클라이언트 및 설치 상태 표시
unity skill install --list
AI 클라이언트에 설치하세요
unity skill install claude-code
# 최신 버전으로 업데이트
유니티 스킬 새로고침
어떻게 해야 하나요?
이것이 명령어에 대한 유용한 간략한 개요였기를 바랍니다. 언급했듯이 전부 외울 필요는 없지만 몇 가지 기본 명령어를 아는 것은 정말 도움이 될 수 있습니다. 다음 기사에서는 Claude Code 및 Unity 사용에 대해 자세히 살펴보겠습니다. 즐거운 게임 코딩 되세요!