메인 콘텐츠로 건너뛰기

​
무엇인가요

로컬로 빌드하기(Build locally)를 사용하면 Manus가 내 컴퓨터의 폴더에서 웹사이트, 웹 앱, 모바일 앱 또는 게임을 빌드합니다. 작업은 macOS(Apple Silicon) 및 Windows용 Manus 데스크톱 앱인 Manus Studio에서 진행합니다. Manus가 코드를 작성하고, 프로젝트를 실행하고, 실시간 미리보기를 보여 줍니다. 이때 컴퓨터에 이미 있는 파일, 폴더, 도구를 사용합니다. Manus Studio가 내 컴퓨터에서 할 수 있는 일은 Manus Studio를 참고하세요. 다음과 같은 경우에 이 기능을 사용하세요.
  • 프로젝트가 이미 내 컴퓨터에 있는 경우
  • 기존 Git 워크플로를 그대로 유지하고 싶은 경우
  • Manus와 함께 내 도구를 사용하고 싶은 경우
같은 워크플로를 Cloud Computer에서도 사용할 수 있습니다. 이 경우 프로젝트 폴더는 내 컴퓨터가 아닌 Cloud Computer에 있습니다. 웹사이트나 모바일 앱마다 다음 두 가지 프로젝트 유형 중 하나를 선택합니다. 다음 표는 프로젝트 종류별로 선택할 수 있는 항목을 보여 줍니다.

​
사용 방법

​
Manus Studio 설정하기

1

Manus Studio 다운로드하기

manus.im/desktop을 엽니다. macOS (Apple Silicon) 또는 Windows를 선택한 다음 설치 프로그램을 실행하세요.
2

로그인하기

Manus Studio를 열고 Manus 계정으로 로그인합니다. 로컬 폴더를 사용하기 전에 업데이트하라는 메시지가 표시되면 최신 버전을 설치하세요.
3

로컬 작업을 켜고 폴더 선택하기

채팅 상자에서 로컬 작업(Work locally)을 켭니다. 폴더 선택(Choose a folder)을 클릭하고 프로젝트가 있는 폴더 또는 Manus가 프로젝트를 만들 폴더를 선택하세요. 권한 모드와 폴더 액세스에 대해서는 Manus Studio를 참고하세요.

​
내 컴퓨터에서 새 웹사이트 시작하기

1

웹사이트와 위치 설명하기

Manus Studio에서 작업을 시작합니다. 웹사이트를 설명하고, 내 컴퓨터의 어디에 빌드할지 Manus에게 알려 주세요.
2

프로젝트 유형 선택하기

Manus가 웹사이트를 어떻게 설정할지 묻습니다. Manus 호스팅, 데이터베이스, 로그인, 버전 기록, 게시를 사용하려면 Manus 관리형(Manus-managed)을 선택하세요. 내 도구와 서비스만 사용하려면 일반 로컬(plain local)을 선택하세요.
3

폴더가 비어 있지 않으면 코드 저장소 허용하기

Manus 관리형 프로젝트의 경우 Manus가 폴더를 확인합니다. 폴더에 이미 파일이 있으면 Manus가 프로젝트 코드 저장소(Project code storage) 카드를 표시합니다. 카드에는 “Allow Manus to sync your project’s code?”(Manus가 프로젝트 코드를 동기화하도록 허용하시겠습니까?)라는 질문이 나옵니다. 계속하려면 허용 및 초기화(Allow and initialize)를 클릭하세요. 취소하면 Manus는 프로젝트를 설정하지 않습니다.
4

계획 검토하기

Manus가 웹사이트 계획을 제시합니다. Manus가 빌드를 시작하기 전에 변경 사항을 요청하세요.
5

미리보기 및 수정하기

Manus가 내 컴퓨터에서 웹사이트를 실행하고 Manus Studio에서 실시간 미리보기를 엽니다. 같은 작업에서 원하는 변경 사항을 설명하세요.
프롬프트 예시:
“로컬로 유지하고 Manus 호스팅은 사용하지 마”처럼 프롬프트에서 이미 프로젝트 유형을 선택했다면 Manus는 다시 묻지 않습니다.

​
내 컴퓨터에 있는 웹사이트 이어서 작업하기

1

Manus에게 폴더 알려 주기

Manus Studio에서 어떤 프로젝트를 이어서 작업할지 Manus에게 알려 주세요. 가능하면 전체 폴더 경로를 제공하세요.
2

올바른 사본 확인하기

Manus가 해당 폴더와 주변 폴더에서 Manus 웹사이트를 찾습니다. 일치하는 항목이 둘 이상이거나 불분명하면 어느 것을 말하는지 묻습니다.
3

기존 코드 연결 방식 선택하기

폴더에 아직 Manus에 연결되지 않은 코드가 있을 수 있습니다. 이 경우 Manus가 Manus 관리형 또는 일반 로컬 중 하나를 선택하라고 요청합니다. Manus는 기존 파일을 그대로 유지하며, 그 위에 스타터 템플릿을 적용하지 않습니다.

​
더 큰 프로젝트에 웹사이트 추가하기

게임의 공식 사이트처럼 웹사이트가 아닌 프로젝트에 웹사이트를 추가할 수 있습니다.
  1. 더 큰 프로젝트 안에 별도의 웹사이트를 원한다고 Manus에게 알려 주세요. 예: “이 게임의 공식 웹사이트를 추가해 줘.”
  2. Manus가 website/와 같은 별도의 하위 폴더에 웹사이트를 만듭니다.
  3. 해당 하위 폴더만 웹사이트에 속합니다. Manus는 프로젝트의 나머지 부분을 웹사이트 버전에 포함하지 않습니다.

​
모바일 앱 빌드하기

1

앱 설명하기

Manus Studio에서 빌드하려는 모바일 앱을 설명하세요.
2

프로젝트 유형 선택하기

Manus가 시작하기 전에 선택하라고 요청합니다. Manus 관리형(Manus-managed)을 선택하면 백엔드, 데이터베이스, 로그인, AI 기능, 버전 기록, 앱 빌드를 사용할 수 있습니다. 일반 로컬(Plain local)을 선택하면 내 백엔드와 서비스를 사용해 내 컴퓨터에서 개발을 진행합니다.
3

Manus Cloud로의 이동 확인하기

Manus 관리형 모바일 앱은 현재 Manus Cloud에서 실행됩니다. 이를 선택하면 개발을 시작하기 전에 Manus가 작업을 내 컴퓨터에서 Manus Cloud로 옮깁니다. Manus는 선택하기 전에 이 이동에 대해 알려 줍니다.
로컬 폴더의 파일은 작업과 함께 Manus Cloud로 옮겨지지 않을 수 있습니다. 기존 코드가 있다면 선택하기 전에 Manus에게 알려 주세요. 그러면 Manus가 코드를 옮길 방법을 계획할 수 있습니다.

​
게임 빌드하기

  1. Manus Studio에서 게임을 설명하고, 내 컴퓨터의 어디에 빌드할지 Manus에게 알려 주세요.
  2. Manus가 게임을 Manus 관리형 프로젝트로 설정합니다. 프로젝트 유형을 선택하라고 묻지 않습니다.
  3. 일반적인 Game Dev 워크플로를 계속 진행하세요. Game Developer를 참고하세요.

​
Manus 관리형 프로젝트의 버전 저장 및 게시하기

1

Manus에게 버전 저장 요청하기

변경 사항이 마음에 들면 Manus에게 버전을 저장해 달라고 요청하세요. Manus가 웹사이트 폴더의 코드 사본을 Manus가 관리하는 비공개 저장소에 업로드합니다. Manus는 이 사본을 버전 기록과 게시에만 사용합니다.
2

준비되면 게시하기

Manus에게 게시를 요청하거나 게시에 설명된 대로 게시하세요. Manus가 “Allow Manus to publish?”(Manus가 게시하도록 허용하시겠습니까?)라고 묻습니다. 한 번 허용(Allow once)을 선택하거나, 다음부터 이 질문을 건너뛰려면 이 웹사이트에 대해 항상 허용(Always allow for this website)을 선택하세요. 로컬 프로젝트는 프로젝트 소유자만 게시할 수 있습니다. 자동 게시를 켜지 않았다면 버전을 저장하는 것만으로는 웹사이트가 게시되지 않습니다.
내 Git 저장소의 커밋은 Manus 버전을 만들지 않으며 웹사이트를 게시하지도 않습니다.

​
로컬 프로젝트에서 Stripe 결제 테스트하기

  1. Manus에게 결제 기능 추가를 요청하세요. Manus가 Stripe를 테스트 모드로 설정합니다. 결제를 참고하세요.
  2. Stripe 테스트 카드 4242 4242 4242 4242로 결제 절차(체크아웃)를 테스트하세요.
  3. 결제를 완전히 테스트하려면 Stripe가 앱에 결제 이벤트(webhook)를 보내야 합니다. 내 컴퓨터의 미리보기는 이러한 이벤트를 받을 수 없습니다. 이 테스트를 위해 프로젝트를 임시 클라우드 샌드박스로 옮겨 달라고 Manus에게 요청하세요. Manus가 먼저 승인을 요청합니다.
  4. 처음 게시하기 전에 클라우드 미리보기에서 Stripe webhook을 연결해 달라고 Manus에게 요청하세요.

​
나중에 일반 로컬 프로젝트를 Manus에 연결하기

  1. Manus Studio에서 프로젝트 폴더를 엽니다.
  2. Manus에게 웹사이트를 Manus에 연결해 달라고 요청하세요.
  3. Manus가 기존 폴더를 새 Manus 관리형 프로젝트에 연결합니다. 소스 파일은 그대로 유지되며 웹사이트를 다시 빌드하지 않습니다.
이는 웹사이트와 웹 앱에 적용됩니다. 일반 로컬 모바일 앱을 Manus 관리형으로 전환하려면 Manus가 작업을 Manus Cloud로 옮기고 코드를 옮길 방법을 검토합니다.

​
알아야 할 사항

​
실행 위치

  • 미리보기는 내 컴퓨터에서 실행됩니다. Manus Studio는 내 컴퓨터의 로컬 주소에서 미리보기를 엽니다. 다른 기기에서는 이 주소를 열 수 없습니다.
  • 다른 사람과 공유하려면 게시하세요. 다른 사람이 웹사이트를 볼 수 있게 하려면 게시하거나 Manus Cloud에서 작업을 이어서 진행하세요.
  • 클라우드에서 이어서 작업하기 전에 동기화하세요. 새 클라우드 작업은 가장 최근에 동기화된 버전에서 시작합니다. 내 컴퓨터에만 있는 변경 사항은 포함되지 않습니다. 먼저 Manus에게 동기화를 요청한 다음 새 클라우드 작업에서 계속(Continue in a new cloud task)을 선택하세요.
  • 로컬 파일은 소유자만 사용할 수 있습니다. 로컬 파일, 로컬 게시, 새 작업에서 계속하기는 프로젝트 소유자만 사용할 수 있습니다.
  • 관리형 모바일 앱은 Manus Cloud에서 실행됩니다. 웹사이트, 웹 앱, 게임은 내 컴퓨터에 남아 있습니다. Manus 관리형 모바일 앱은 Manus Cloud로 옮겨집니다.

​
Manus가 업로드하는 항목

  • Manus 관리형 프로젝트: 버전을 저장하거나 동기화하면 Manus가 웹사이트 폴더의 코드를 업로드합니다. 부속 웹사이트를 둘러싼 게임처럼 더 큰 프로젝트의 나머지 부분은 업로드하지 않습니다.
  • 설정만으로는 코드가 업로드되지 않습니다. 폴더를 연결하거나 Manus 관리형 프로젝트를 설정하는 것만으로는 코드가 업로드되지 않습니다.
  • Manus 관리형을 선택해도 아무것도 게시되지 않습니다. 웹사이트는 직접 게시할 때만 공개됩니다.
  • 일반 로컬 프로젝트: Manus는 Manus 서비스를 설정하지 않으며 Manus에 버전을 저장하지 않습니다. 나중에 프로젝트를 Manus에 연결할 수 있습니다.

​
Manus와 Git 저장소의 관계

  • 두 개의 별도 기록. Manus는 Manus 관리형 프로젝트에 대해 자체 버전 기록을 보관합니다. 내 Git 저장소와 그 기록은 별개로 유지됩니다.
  • Git 설정은 그대로 유지됩니다. Manus는 원격 저장소(remote), 브랜치, hook, 자격 증명을 변경하지 않습니다. Git 기록을 가져오지도 않습니다.
  • 커밋은 서로 복사되지 않습니다. 내 커밋은 Manus 버전 기록에 나타나지 않으며, Manus 버전도 내 저장소에 커밋으로 나타나지 않습니다.
  • 공유 파일. 두 기록 모두 폴더의 같은 파일을 추적합니다. Manus가 자체 기록에서 변경 사항을 가져오면 해당 변경 사항은 내 Git 저장소에 커밋되지 않은 변경 사항으로 나타납니다.
  • 자체 Git 저장소가 없는 폴더. 웹사이트 폴더가 Git 저장소 안에 있지 않으면 Git 도구에 해당 폴더의 Manus 버전 기록이 표시됩니다. 그곳에서 별도의 저장소를 사용하려면 Manus에게 설정을 요청하세요. 해당 폴더에서 직접 git init을 실행하지 마세요.
  • Manus는 웹사이트 폴더에 두 가지 항목을 추가합니다. 작은 프로젝트 파일은 폴더를 Manus 프로젝트에 연결합니다. 숨김 폴더에는 Manus 버전 기록이 저장됩니다. 둘 다 삭제하지 마세요. 숨김 폴더를 내 저장소에 커밋하지 마세요.
  • Git worktree와 브랜치. 작은 프로젝트 파일은 내 저장소에 커밋할 수 있습니다. 그러면 새 브랜치나 worktree도 같은 Manus 프로젝트에 연결된 상태로 유지됩니다.
  • 클라우드 프로젝트와 GitHub. Manus Cloud에서 빌드하는 프로젝트의 경우 GitHub 통합 및 코드 제어를 참고하세요.

​
현재 제한 사항

  • 로컬 프로젝트에서는 아직 롤백을 사용할 수 없습니다. Manus 관리형 로컬 프로젝트를 이전에 저장한 버전으로 롤백할 수 없습니다. 변경 사항을 되돌리려면 내 Git 기록을 사용하세요.
  • Stripe webhook을 완전히 테스트하려면 클라우드 샌드박스가 필요합니다. 테스트 모드 체크아웃은 로컬에서 작동합니다. 결제 이벤트에는 임시 클라우드 샌드박스가 필요합니다.
  • 게임은 항상 Manus 관리형입니다. 게임에는 일반 로컬 옵션을 사용할 수 없습니다.
  • 관리형 모바일 앱에는 Manus Cloud가 필요합니다. Manus 관리형 모바일 앱은 내 컴퓨터에서 개발할 수 없습니다.

​
내 컴퓨터의 도구

  • Manus는 내가 가진 도구를 사용합니다. Manus는 내 컴퓨터에 설치된 프로그래밍 언어, 패키지 관리자 및 기타 도구를 사용합니다.
  • 프로젝트 패키지는 작업의 일부로 설치됩니다. Manus는 프로젝트 자체 설정을 사용해 프로젝트에 필요한 패키지를 설치합니다.
  • 시스템 변경에는 내 권한이 필요합니다. Manus는 컴퓨터 전체에 적용되는 도구를 설치하거나 복구하기 전에 변경 사항을 설명하고 권한을 요청합니다. 승인 없이 관리자 권한을 사용하지 않습니다.

​
프로젝트 폴더 이동 또는 복사

  • 폴더 전체를 이동하세요. 웹사이트 폴더 전체를 이동하거나 이름을 바꾸면 Manus 프로젝트와의 연결과 버전 기록이 그대로 유지됩니다.
  • 프로젝트 파일만 복사해서는 새 웹사이트가 만들어지지 않습니다. 복사본은 같은 Manus 프로젝트를 가리킵니다. 대신 Manus에게 새 프로젝트 설정을 요청하세요.

​
크레딧

내 컴퓨터에서 작업하는 작업은 클라우드의 동일한 작업과 같은 비율로 크레딧을 사용합니다. 비용은 파일 위치가 아니라 작업의 복잡도에 따라 결정됩니다. Understanding Credit Consumption in the Manus Desktop App을 참고하세요.

​
팁

  • Manus에게 전체 폴더 경로를 알려 주세요. ~/Documents/yoga-site와 같은 전체 경로를 알려 주면 Manus가 처음부터 올바른 프로젝트를 찾을 수 있습니다.
  • 새 웹사이트에는 비어 있는 새 폴더를 사용하세요. 그러면 Manus가 코드 저장소 확인을 요청하지 않고 프로젝트를 설정합니다.
  • 첫 프롬프트에서 프로젝트 유형을 밝히세요. “Manus 관리형” 또는 “로컬로 유지”라고 말하면 설정 질문을 건너뛸 수 있습니다.
  • Manus로 게시할 계획이라면 Manus 관리형을 선택하세요. 추가 설정 없이 호스팅, 버전 기록, 게시를 사용할 수 있습니다.
  • 부속 웹사이트는 별도의 하위 폴더에 두세요. 그러면 버전 기록과 업로드에 프로젝트 전체가 아닌 웹사이트만 포함됩니다.
  • 큰 변경 전에는 작업을 Git에 커밋하세요. Manus 관리형 로컬 프로젝트에서는 아직 롤백을 사용할 수 없으므로 내 Git 기록이 안전망 역할을 합니다.
  • 숨김 폴더가 아니라 작은 프로젝트 파일을 커밋하세요. 그러면 브랜치와 worktree가 같은 Manus 프로젝트에 연결된 상태로 유지됩니다.
  • 결제 테스트는 미리 계획하세요. 전체 결제 흐름을 테스트할 준비가 되면 Manus에게 임시 클라우드 샌드박스 설정을 요청하세요.
  • 공유하려면 게시하세요. 로컬 미리보기는 내 컴퓨터에서만 작동합니다. 다른 사람에게 링크를 보내려면 웹사이트를 게시하세요.

​
FAQ

네. 내 컴퓨터에서 빌드하려면 macOS(Apple Silicon) 또는 Windows용 Manus Studio가 필요합니다. manus.im/desktop에서 다운로드하세요. Cloud Computer에서도 같은 워크플로를 사용할 수 있습니다.
Manus 관리형 프로젝트는 호스팅, 데이터베이스, 로그인, 버전 기록, 게시 등 Manus 서비스에 연결됩니다. 일반 로컬 프로젝트는 내 컴퓨터에 있는 일반적인 프로젝트입니다. 내 도구와 서비스를 사용하며, Manus는 호스팅이나 게시를 설정하지 않습니다.
Manus 관리형 프로젝트의 경우 버전을 저장하거나 동기화할 때 Manus가 웹사이트 폴더의 코드를 업로드합니다. 프로젝트를 설정하는 것만으로는 코드가 업로드되지 않습니다. 일반 로컬 프로젝트의 경우 Manus는 Manus에 버전을 저장하지 않습니다.
아니요. Manus는 내 저장소와 별도로 자체 버전 기록을 보관합니다. 원격 저장소(remote), 브랜치, hook, 자격 증명을 변경하지 않습니다. Manus가 파일을 변경하면 해당 변경 사항은 내 저장소에 커밋되지 않은 변경 사항으로 나타납니다.
Manus 관리형 모바일 앱은 현재 Manus Cloud에서 실행됩니다. Manus는 선택하기 전에 이 사실을 알려 줍니다. 앱을 내 컴퓨터에 유지하려면 대신 일반 로컬 개발을 선택하세요.
로컬로 빌드하는 게임은 항상 Manus 관리형입니다. Manus가 Manus 서비스로 게임을 설정하고 다음 단계로 진행합니다.
아직은 할 수 없습니다. 이번 릴리스에서는 Manus 관리형 로컬 프로젝트에 롤백을 사용할 수 없습니다. 파일을 직접 복원할 수 있도록 큰 변경 전에 내 Git 저장소에 커밋하세요.
Stripe 테스트 모드에서 체크아웃을 테스트할 수 있습니다. 결제 이벤트(webhook)를 완전히 테스트하려면 임시 클라우드 샌드박스가 필요합니다. Manus에게 설정을 요청하세요. Manus는 프로젝트를 옮기기 전에 승인을 요청합니다.
아니요. 미리보기는 내 컴퓨터의 로컬 주소에서 실행됩니다. 웹사이트를 공유하려면 게시하거나 Manus Cloud에서 작업을 이어서 진행하세요.
네. Manus에게 웹사이트 연결을 요청하세요. Manus가 기존 폴더를 Manus 관리형 프로젝트에 연결하고 소스 파일을 그대로 유지합니다.
프로젝트에 필요한 도구가 내 컴퓨터에 없거나, 오래되었거나, 제대로 작동하지 않기 때문입니다. Manus는 컴퓨터 전체에 적용되는 도구를 설치하거나 복구하기 전에 변경 사항을 설명하고 권한을 요청합니다.
아니요. 내 컴퓨터에서 작업하는 작업은 클라우드의 동일한 작업과 같은 비율로 크레딧을 사용합니다. 요금제 및 가격을 참고하세요.