---
title: 커맨드 라인 인터페이스에서 Unity 실행
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/unity-editor/command-line-arguments/run-unity
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/unity-editor/command-line-arguments/run-unity.md
last_updated: 2026-10-03
generated_at: 2026-11-19T21:42:13.731Z
locale: ko-kr
---

# 커맨드 라인 인터페이스에서 Unity 실행

> 커맨드 라인 Unity 실행하고 스크립트를 실행하는 방법에 대해 알아봅니다.

운영체제의 커맨드 라인 인터페이스에서 Unity 에디터 실행하고 인자를 전달하여 에디터 실행 방식을 변경할 수 있습니다. 커맨드 라인 사용하여 실행 시 프로젝트의 C# 스크립트에서 특정 메서드를 실행할 수도 있습니다.

Unity 에디터 실행할 때 커맨드 라인 인자 값의 구분 기호는 단일 공간입니다. 예를 들어 창 모드를 테두리 없는 모드로 설정하려면 `-window-mode borderless`를 사용합니다.

커맨드 라인 인자 전체 목록은 [Unity 에디터 커맨드 라인 인자 레퍼런스](/engine/6000.0/manual/unity-editor/command-line-arguments/editor.md) 및 [Unity 플레이어 커맨드 라인 인자 레퍼런스](/engine/6000.0/manual/unity-editor/command-line-arguments/player.md)를 참조하십시오.

## 커맨드 라인 인터페이스에서 Unity 실행##launching-unity-from-a-command-line-interface

커맨드 라인 인터페이스를 통해 Unity 프로젝트를 실행하려면 Unity 애플리케이션의 디렉토리 경로를 입력한 다음 `-projectPath` 및 타겟 프로젝트의 디렉토리 경로를 입력합니다.

> **Important:**
>
> 프로젝트의 경로 이름에 공백이 포함되어 있으면 따옴표로 둘러보십시오. 예를 들면 `"Unity Projects/My Game"`입니다.

이 방식으로 실행되면 에디터는 시작 시 커맨드와 정보를 수신하며, 이는 테스트 제품군, 자동 빌드, 기타 프로덕션 작업에 유용할 수 있습니다.

오류가 발생하면 문제를 진단하는 데 도움이 되는 추가 정보는 [Unity 로그 파일](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md)을 참조하십시오.

### 필수 조건##prerequisites

Unity Hub를 통해 기본 위치에 Unity 에디터를 [설치](/engine/6000.0/manual/get-started/install-and-upgrade/getting-started-installing-unity.md)합니다. 에디터가 다른 위치에 설치된 경우 경로를 조정하여 이를 반영하십시오. 에디터의 위치 경로를 찾는 방법에 대한 자세한 내용은 [에디터 버전 설치 및 제거](https://docs.unity.com/hub/add-editor.html.md)를 참조하십시오.

### Linux Unity 실행##launch-unity-on-linux

다음을 터미널에 입력하여 Unity 실행합니다.

`/home/<user>/Unity/Hub/Editor/<version>/Editor/Unity -projectPath <project path>`

### macOS에서 Unity 실행##launch-unity-on-macos

다음을 터미널에 입력하여 Unity 실행합니다.

`/Applications/Unity/Hub/Editor/<version>/Unity.app/Contents/MacOS/Unity -projectPath <project path>`

### Windows Unity 실행##launch-unity-on-windows

다음을 커맨드 프롬프트에 입력하여 Unity 실행합니다.

`"C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -projectPath "<project path>"`

Windows 구문 오류를 방지하려면 디렉토리 경로가 단일 백슬래시로 끝나지 않도록 해야 합니다. 다음과 같이 이중 백슬래치(`\\`) 또는 백슬래치 없음 사용:

* `"C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -projectPath "C:\MyUnityProjects\MyProject"`
* `"C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -createProject "C:\MyUnityProjects\MyProject\\"`

## 실행 시 메서드 실행을 위한 예제 스크립트##example-script-for-executing-methods-at-launch

커맨드 라인 사용하여 에디터 실행 시 프로젝트의 C# 스크립트에서 특정 메서드를 실행할 수 있습니다. 다음 예시는 C# 스크립트와 실행 시 해당 스크립트에서 메서드를 실행하는 데 사용되는 커맨드 라인 인자를 보여줍니다.

프로젝트의 C# 스크립트 예시:

```lang-cs
using UnityEditor;
class MyEditorScript
{
     static void PerformBuild()
     {
        BuildPlayerOptions buildPlayerOptions = new BuildPlayerOptions();
        buildPlayerOptions.scenes = new[] { "Assets/Scene1.unity", "Assets/Scene2.unity" };
        BuildPipeline.BuildPlayer(buildPlayerOptions);
     }
}
```

다음 명령은 에디터를 배치 모드로 실행하고 이전 스크립트에서 `MyEditorScript.PerformBuild` 메서드를 호출한 다음 완료 시 종료합니다. 에디터 경로에서 실행하려는 Unity 버전으로 `<version>`를 교체하거나 Unity 에디터 경로가 기본값이 아닌 경우 경로를 완전히 교체합니다.

* **Windows:**

  ```lang-shell
  "C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -quit -batchmode -project경로 "C:\Users\UserName\Documents\MyProject" -executeMethod"
  MyEditorScript.PerformBuild
  ```

* **macOS:**

  ```lang-shell
  /Applications/Unity/Hub/Editor/<version>/Unity.app/Contents/MacOS/Unity -quit -batchmode -project경로 ~/UnityProjects/MyProject -executeMethod
  MyEditorScript.PerformBuild
  ```

## 추가 리소스##additional-resources

* [Unity 에디터 커맨드 라인 인자 참조](/engine/6000.0/manual/unity-editor/command-line-arguments/editor.md)
* [Unity 플레이어 커맨드 라인 인자 참조](/engine/6000.0/manual/unity-editor/command-line-arguments/player.md)
