# Macro Automation Studio 다운로드 및 설치 방법

> 64비트 Windows 또는 Apple Silicon Mac에 Macro Automation Studio를 다운로드해 설치하고, 이메일이나 Google로 로그인하며, 업데이트와 프로젝트 위치를 확인합니다.

Source: https://automationmacro.com/ko/docs/install (시작하기, updated 2026-09-05)

Macro Automation Studio(MAS)는 Windows와 Apple Silicon Mac용 데스크톱 앱입니다. 이 페이지에서는 Macro Automation Studio 다운로드, 각 시스템의 설치 프로그램, 로그인, 내장 업데이트 기능, 그리고 MAS가 파일을 보관하는 위치를 다룹니다.

## 시작하기 전에

- Windows: 64비트 Windows 10 또는 11 PC와 관리자 권한 요청을 승인할 수 있는 계정.
- Mac: macOS 12 Monterey 이상의 Apple Silicon Mac(M1부터 M5까지). Intel 빌드와 Linux 빌드는 없습니다.
- 다운로드 페이지 기준 권장 메모리는 Windows 8 GB(16 GB 권장), Mac 4 GB(8 GB 권장)입니다. 에뮬레이터는 그 위에 별도 메모리가 필요합니다.
- 로그인용 이메일 주소 또는 Google 계정.

> [!NOTE]
> Mac에서 MAS 자체는 Apple Silicon에서 네이티브로 실행됩니다. 다만 조작할 대상은 여전히 필요합니다: Mac에서 실행되는 Android 에뮬레이터, 클라우드 기기, 또는 본인의 휴대폰. [기기](/docs/devices)를 참고하세요.

## Macro Automation Studio 다운로드

[다운로드 페이지](/download)에서 설치 프로그램을 받습니다. Windows는 `MacroAutomationStudio-<version>.exe`, Mac은 Apple Silicon용으로 빌드된 DMG를 받습니다.

## Windows 또는 Apple Silicon Mac에 설치

<div class="doc-tabs" data-tabs="os">
<section data-tab="Windows">

1. 설치 프로그램을 실행하고 관리자 권한 요청을 승인합니다.
2. 이전 버전의 MAS가 설치되어 있으면 먼저 제거할지 묻습니다. **Yes**를 클릭합니다.
3. MAS가 실행 중이면 닫을지 묻습니다. 허용하거나 직접 MAS를 닫습니다.
4. 라이선스에 동의하고 바탕화면 아이콘을 만들지 선택합니다.
5. 파일이 `C:\MacroAutomationStudio`에 복사될 때까지 기다립니다. 그다음 설치 프로그램이 Python 환경을 만드는데, 몇 분 걸릴 수 있습니다.
6. 실행 옵션을 켜 둔 채 **Finish**를 클릭합니다.

설치 프로그램은 adb, Tesseract OCR, `uv` 패키지 관리자도 `C:\ProgramData\MacroAutomationStudio\3rdparty`에 넣습니다. 설치 중에 그 밖의 것을 내려받지는 않습니다.

</section>
<section data-tab="Mac">

1. DMG를 열고 **MacroAutomationStudio**를 **Applications**로 옮깁니다.
2. Applications에서 실행합니다. 앱은 서명과 공증을 거쳤습니다. macOS가 인터넷에서 받은 앱을 열지 확인하면 **Open**을 클릭합니다.
3. 첫 실행 시 MAS가 `~/Library/Application Support/MacroAutomationStudio/python_venv`에 Python 환경을 만듭니다. 몇 분 걸릴 수 있습니다.
4. adb, Tesseract OCR, `uv`는 앱 번들 안에 들어 있습니다. MAS가 "ADB executable not found"를 표시하면 Homebrew로 adb를 설치하고 MAS를 다시 시작합니다:

```bash
brew install android-platform-tools
```

MAS는 앱 번들 안에서 adb를 먼저 찾고, 그다음 PATH, 마지막으로 Homebrew 폴더를 찾습니다.

</section>
</div>

## 로그인

MAS는 두 가지 로그인 방식을 지원합니다. 둘 다 같은 계정으로 연결됩니다.

1. **Sign in with Google**을 클릭합니다. 브라우저에 Google 로그인 페이지가 열립니다. "Login Successful"이 표시되면 앱으로 돌아옵니다.
2. 또는 **Email address**와 **Password**를 입력하고 **Sign In**을 클릭합니다.

MAS가 처음이신가요? **Sign up**을 클릭하고 이메일과 비밀번호를 입력한 뒤, MAS가 이메일로 보낸 일회용 비밀번호를 입력합니다. 계정이 활성화되면 로그인합니다.

> [!TIP]
> Google로 만든 계정에는 비밀번호가 없습니다. 비밀번호 로그인이 "This email is registered with Google"로 실패하면 **Sign in with Google**을 사용하세요.

## 구독 확인

로그인 후 MAS가 이용 권한을 확인합니다. 무료 체험 또는 유료 요금제가 있으면 모든 페이지가 열립니다. 없으면 MAS가 **Subscription**을 열고 요금제를 고를 때까지 그 페이지에 머무릅니다. 요금제는 [가격 페이지](/pricing)에, 동작 방식은 [결제](/docs/billing) 페이지에 있습니다.

## 업데이트

MAS는 스스로 업데이트합니다. 릴리스마다 새 설치 프로그램을 내려받을 필요가 없습니다.

1. 로그인 후 MAS가 버전 서버에 최신 릴리스를 확인합니다.
2. 새 버전이 있으면 두 버전 번호와 릴리스 노트가 담긴 "New Update Available" 대화 상자가 열립니다.
3. **Update Now**를 클릭해 시작하거나 **Not Now**로 계속 작업합니다. 다운로드 중에는 **Minimize**를 클릭할 수 있습니다.
4. MAS가 업데이트 도우미를 받은 뒤 업데이트 패키지를 받고, SHA-256 해시로 패키지를 검증합니다. Mac에서는 도우미가 앱을 교체하기 전에 MAS Apple 팀의 코드 서명도 확인합니다.
5. 대화 상자에 "Update Complete"가 표시됩니다. **Restart Now**를 클릭하거나 자동 재시작을 기다립니다.

> [!NOTE]
> 아주 오래된 Mac 버전은 "This version has no in-app update package"를 표시합니다. [다운로드 페이지](/download)에서 최신 DMG를 받아 기존 앱 위에 설치하세요.

## MAS가 파일을 보관하는 위치

| 항목 | Windows | Mac |
|---|---|---|
| 앱 | `C:\MacroAutomationStudio` | `/Applications/MacroAutomationStudio.app` |
| 프로젝트 | `C:\ProgramData\MacroAutomationStudio\projects` | `~/Library/Application Support/MacroAutomationStudio/projects` |
| 로그 | `C:\ProgramData\MacroAutomationStudio\logs` | `~/Library/Application Support/MacroAutomationStudio/logs` |
| Python 환경 | `C:\ProgramData\MacroAutomationStudio\python_venv` | `~/Library/Application Support/MacroAutomationStudio/python_venv` |

각 프로젝트 폴더 이름은 `<id>_<name>` 형식이며, 이름은 소문자로 바뀌고 공백은 밑줄이 됩니다. 폴더 안에는 `src/app.py`, 프로젝트에 인수 폼이 있을 때 생성되는 `src/script_args.py`, 그리고 직접 추가한 에셋이 있습니다. 프로젝트는 git 저장소입니다. [Git 프로젝트와 코드 동기화](/docs/git-and-code-sync)를 참고하세요.

`C:\ProgramData`는 기본적으로 숨겨져 있습니다. 탐색기 주소창에 경로를 입력하면 열립니다.

## 문제 해결

### MacroAutomationStudio is currently running

설치 프로그램이 실행 중인 MAS를 발견했습니다. **Yes**를 클릭해 앱을 닫게 하거나, MAS 창에서 직접 종료한 뒤 설치 프로그램을 다시 실행하세요.

### Python 환경이 끝까지 만들어지지 않음

설치 프로그램은 경고를 기록하고 그대로 끝냅니다. MAS가 다음 실행 때 설정을 다시 시도합니다. 앱이 "uv package manager not found"를 표시하면 다운로드 페이지에서 MAS를 다시 설치하세요.

### ADB executable not found

Mac에서만 발생합니다. MAS가 앱 번들, PATH, `/opt/homebrew` 어디에서도 adb를 찾지 못했습니다. `brew install android-platform-tools`를 실행하고 MAS를 다시 시작하세요.

### 업데이트 실패

대화 상자에 원인이 표시됩니다. 네트워크 오류면 **Try Again**을 클릭합니다. "Not enough disk space"면 공간을 확보하고 다시 시도합니다. **Download Manually**가 제시되면 [다운로드 페이지](/download)에서 새 버전을 설치하세요.

## 다음 단계: Windows 또는 Apple Silicon Mac에 안드로이드 에뮬레이터 추가

[기기](/docs/devices) 페이지에서 Android 에뮬레이터, 클라우드 기기 또는 휴대폰을 추가한 뒤, [시작하기](/docs/getting-started)로 첫 매크로를 실행하세요.