# iOS 앱

cmux iOS 앱은 Mac을 위한 동반 앱입니다. iPhone 또는 iPad를 cmux가 실행 중인 Mac과 페어링하면 휴대폰에서 터미널에 연결할 수 있으며, 터미널 알림을 선택적으로 전달할 수 있습니다.

[Set up cmux on iPhone and iPad](https://cmux.com/ko/docs/ios#setup)

iOS 앱은 베타 버전입니다. TestFlight에서 cmux BETA로 배포됩니다.

## 액세스 받기

앱은 TestFlight를 통해 배포됩니다. 앞서 사용해 볼 수 있는 권한은 다른 초기 기능과 함께 [cmux Founders Edition](https://github.com/manaflow-ai/cmux#founders-edition)에 포함됩니다.

## Set up cmux on iPhone and iPad

cmux on iOS connects to cmux running on your Mac. Your shells and agents continue running on the Mac while you view and control their workspaces from your phone or tablet.

### Before you start

-   Install the latest cmux on your Mac and keep it open with at least one workspace. If the phone requests a newer Mac version, update the specific cmux app you are connecting to.
-   Install cmux on your iPhone or iPad. For the beta, accept your TestFlight invitation and install cmux BETA through TestFlight.
-   Have both devices connected to the internet and use the same cmux account. If you use teams, select the same team on both devices.

[Download cmux for Mac](https://cmux.com/ko) · [Get cmux for iOS](https://cmux.com/ko/ios)

### 1\. Enable pairing on your Mac

1.  Open cmux on the Mac and sign in to your cmux account.
2.  Open cmux Settings, select Mobile, and turn on Enable iOS pairing. Do this in each cmux Mac app you want to access from your phone.
3.  Keep cmux running and the Mac awake. If the Mac sleeps, shuts down, or loses its connection, the phone cannot reach its terminals.

Pairing is off by default. While it is off, that Mac stays hidden from iOS. Signing in alone does not enable pairing.

### 2\. Sign in and connect from iOS

1.  Open cmux on your iPhone or iPad and sign in with the same cmux account as the Mac. Check the email on both devices if you have more than one account.
2.  Follow the introduction. Enable Notifications when asked, or choose Not Now and enable them later. On the pairing page, confirm that you enabled iOS pairing on your Mac.
3.  Choose Auto-Connect and tap Check for My Mac. This discovers compatible Macs signed in to your account. Auto-Connect does not require you to install Tailscale.
4.  When the Mac is connected, tap Open Workspaces. Choose a workspace, then a terminal to view output and send input. Use All Computers at the top to change the selected Mac.

Allow Local Network access if iOS asks. If you previously denied it, open the iPhone or iPad Settings app, find cmux, and enable Local Network. Then return to cmux and tap Retry.

### Optional: connect with Tailscale Only

1.  Install Tailscale on the Mac and iPhone or iPad, sign both into the same Tailscale network, and confirm Tailscale is connected on both.
2.  Keep Enable iOS pairing on in cmux Settings > Mobile. On iOS, select Tailscale Only in the connection options, then choose Scan Pairing Code.
3.  Open Mobile Connect in cmux on the Mac and scan its pairing code with the phone. Allow camera access when requested and follow the pairing prompts.
4.  Keep Tailscale connected on both devices when using this mode, including when the phone switches from Wi-Fi to cellular. Your Tailscale access rules must allow the phone to reach the Mac.

### 3\. Enable agent notifications

1.  Tap Enable Notifications during the introduction and allow notifications in the iOS prompt. If you skipped or denied it, open iOS Settings > Notifications > cmux and enable Allow Notifications.
2.  Check notification settings in cmux on both devices and enable forwarding where offered. Keep the Mac running and connected so it can send new agent alerts.
3.  Open a workspace with a configured coding agent and trigger an alert. Check the Notifications tab in cmux, then check delivery to your phone. Focus modes and Scheduled Summary can delay or silence alerts.

[Configure terminal and agent notifications](https://cmux.com/ko/docs/notifications)

### 4\. Verify your connection

1.  Open a terminal from the phone and run a harmless command such as pwd. Confirm the output appears on the phone and in the same Mac workspace.
2.  Switch to another workspace, then return. If you plan to connect away from home, test on cellular before leaving the Mac.
3.  Keep the Mac plugged in and awake for remote access. A keep-awake option may be offered during setup; use it if you want the Mac to remain reachable.

### If no workspaces appear

After correcting a setup issue, return to Workspaces and tap Retry. Retry reconnects to a saved Mac or refreshes the workspace list and account-backed connection information.

### The Mac is missing

Check Enable iOS pairing in Settings > Mobile on the exact Mac app you opened. Confirm the same cmux account and team on both devices, and keep that Mac app running. Use the Computers button to inspect available Macs and check whether you hid the computer.

### cmux asks for a newer Mac app

Update cmux on the Mac, then quit and reopen that app. If you run several cmux versions, confirm the phone is selecting the updated one. Follow the minimum version shown by the iOS app.

### The Mac appears but will not connect

Wake the Mac and check internet access on both devices. Allow Local Network access on iOS if requested. For Tailscale Only, check that both Tailscale apps are connected to the same network and that access rules permit the connection. Then tap Retry.

### The connection works but the list is empty

Create or open a workspace in cmux on the Mac. On the phone, choose All Computers and clear workspace search or filters. Pull down to refresh the list, or tap Retry in the empty state.

### Still need help?

Include your cmux versions on Mac and iOS, your connection mode, the exact error, and whether the Mac appears under Computers. Never include passwords or pairing codes.

[Contact cmux support](https://cmux.com/ko/support)

## 사전 요구 사항

시작하기 전에 다음이 필요합니다:

-   cmux가 실행 중이고 로그인된 Mac.
-   TestFlight에서 cmux BETA 앱이 설치된 iPhone 또는 iPad.
-   휴대폰에서 Mac으로의 네트워크 경로(아래 직접 구성하는 네트워크 참조).

## 직접 구성하는 네트워크

cmux는 기본적으로 네트워크를 제공하지 않습니다. 터미널 스트림은 휴대폰과 Mac 사이에서 직접 흐르므로, 휴대폰이 네트워크에서 Mac에 연결할 수 있어야 합니다. 가장 간단한 방법은 사설 오버레이 네트워크입니다.

### Tailscale (권장)

Mac과 휴대폰 모두에 [Tailscale](https://tailscale.com)을 설치하고 동일한 tailnet에 로그인하세요. 그러면 휴대폰이 어디에서나 포트 포워딩 없이 Mac의 tailnet 주소로 연결할 수 있습니다.

### WireGuard

이미 [WireGuard](https://www.wireguard.com)를 사용 중이라면, Mac과 휴대폰을 동일한 네트워크에 두고 Mac의 WireGuard 주소를 사용하세요.

어느 것을 선택하든 연결은 사용자의 것입니다. cmux는 사용자 기기 사이의 터미널 트래픽을 프록시하거나 중계하지 않습니다.

## 페어링 및 연결

1.  Mac에서 cmux의 Mobile Connect 창을 엽니다.
2.  휴대폰에서 cmux BETA 앱을 열고 Mobile Connect에 표시된 페어링을 확인합니다.
3.  페어링되면 작업 공간과 터미널이 네트워크를 통해 휴대폰에 나타납니다.

페어링은 기기별로 이루어집니다. 새 기기나 다시 설치한 앱은 다시 페어링합니다.

## 알림

터미널 알림을 휴대폰으로 전달하도록 선택할 수 있으며, 그러면 주의가 필요한 패널이 기기로 푸시됩니다. 전달이 켜져 있으면 알림 텍스트(제목과 본문, 터미널 출력에서 가져옴)가 cmux 서버를 거쳐 Apple의 푸시 서비스로 전송되어 전달됩니다. 알림 설정에서 Hide content를 켜면 대신 일반 메시지를 보내고 터미널 텍스트를 사용자 기기에 보관합니다. cmux가 알림을 어떻게 생성하는지는 [알림](https://cmux.com/ko/docs/notifications)을 참조하세요.

## 저장되는 데이터

cmux는 터미널이 사용자 기기 사이에만 머물도록 설계되었습니다. cmux 서버에는 로그인과 기기 연결에 필요한 것만 저장합니다:

-   로그인 시 사용한 계정(이메일), 여러 기기에서 사용자를 식별하기 위함.
-   기기의 푸시 토큰, 전달된 터미널 알림을 전달하기 위함.
-   페어링 및 기기 메타데이터, 휴대폰을 Mac에 연결하기 위함.

사용자의 대화형 터미널 세션과 그 내용 및 키 입력은 사용자 자신의 네트워크를 통해 휴대폰과 Mac 사이에서 직접 흐르며, cmux 서버를 거쳐 중계되거나 거기에 저장되지 않습니다. 유일한 예외는 전달된 알림 텍스트로, Hide content를 켜지 않는 한 휴대폰에 도달하기 위해 cmux와 Apple의 푸시 서비스를 거칩니다(위의 알림 참조).

## 기업 및 자체 호스팅

자체 호스팅 또는 에어갭 배포는 [founders@cmux.com](mailto:founders@cmux.com?subject=cmux%20enterprise)으로 문의하세요.

Canonical: https://cmux.com/ko/docs/ios

Documentation index: https://cmux.com/llms.txt