> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Replit에서 앱 실행하기

> GitHub 또는 GitLab 저장소의 개발 미리보기를 실행해 달라고 Replit에 요청하고, 설정 진행 상황을 확인하고, 첫 집중 변경 전에 앱을 사용해 보세요.

코드를 변경하기 전에 애플리케이션이 실행되는 모습을 확인하세요. 이 안내는 필수 데이터베이스, 자격 증명, 외부 서비스가 없는 작은 랜딩 페이지인 [Cloud Agent Demo](https://github.com/replit/cloud-agent-demo)를 사용합니다. 이미 저장소가 있다면 해당 URL을 대신 사용하세요.

> [!NOTE]
>
> 사용해 볼 저장소가 없나요? 접근 권한을 부여받았다면 Cloud Agent Demo를 사용할 수 있습니다. 이 예시 저장소는 현재 공개가 아니라 비공개입니다.

## 앱 실행하기

시작하기 전에 GitHub 또는 GitLab 계정이 아직 연결되어 있지 않다면 [저장소를 연결](https://docs.replit.com/ko/build/code/connect-your-repository.md)하세요.

**1. Replit에 앱 실행 요청하기**

데모의 경우 다음 프롬프트를 복사하세요.

Run [https://github.com/replit/cloud-agent-demo](https://github.com/replit/cloud-agent-demo) and show me a preview.
Do not push changes or open a pull request.

자신의 저장소가 있다면 데모 URL 대신 해당 링크를 붙여 넣으세요.

![변경 사항을 푸시하거나 pull request를 열지 않고 Cloud Agent Demo를 실행해 미리보기를 보여 달라는 프롬프트가 입력된 Replit 채팅 입력창.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/cloud-agent-demo-prompt.jpg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=d2961cd7d4183656174154ea0506a1aa)

Replit이 개발 설정을 준비하거나 재사용하고, 종속성을 설치하고, 앱을 시작합니다. 저장소의 지침을 활용해 설정 명령을 알아낼 수 있으므로 직접 파악할 필요가 없습니다.

앱은 클라우드 샌드박스에서 실행됩니다. 먼저 재사용 가능한 환경을 만들 필요는 없습니다. 차이점은 [파일 및 환경](https://docs.replit.com/ko/build/code/navigate-your-workspace.md#파일-및-환경)에서 설명합니다.

애플리케이션에 자격 증명이 필요하다면 메시지가 아니라 [보안 시크릿 흐름](https://docs.replit.com/ko/build/code/navigate-your-workspace.md#secrets)으로 입력하세요. Cloud Agent Demo에는 필요하지 않습니다.

**2. 미리보기 및 환경 저장**

실행 중인 미리보기를 사용해 보세요. 앱이 작동하면 선택적으로 설정을 저장해 이후 채팅이 저장소, 런타임, 도구, 종속성이 준비된 상태로 시작되도록 할 수 있습니다.

Replit이 저장을 제안하면 저장소, 브랜치, 제안된 설정을 Replit과 함께 확인하세요. 양식의 환경 이름과 설명을 검토한 다음 **Save environment**를 선택하세요.

![Replit이 Cloud Agent Demo 미리보기 옆에 이름, 설명, Save environment 버튼이 있는 Save environment 양식을 보여 줍니다.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/cloud-agent-demo-save-environment.jpg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=c58d0efa53f1824164e84ff86ec09665)

Replit이 저장된 설정을 빌드하고 새 샌드박스에서 앱을 확인합니다. 구성을 저장했다고 해서 빌드가 성공했다는 의미는 아닙니다. 빌드에 성공하면 이후 채팅에서 준비된 설정을 재사용할 수 있습니다.

> [!NOTE]
>
> 백그라운드 빌드에는 개인 Git 연결과 별개의 [워크스페이스 저장소 접근 권한](https://docs.replit.com/ko/build/code/manage-repository-access.md)이 필요합니다. 관리자가 구성해야 할 수 있습니다. 재사용 가능한 환경을 저장하지 않고도 현재 미리보기를 계속 사용할 수 있습니다.

저장해도 앱이 게시되거나 설정이 팀과 자동으로 공유되지는 않습니다. 이후 재빌드는 이미 사용 중인 샌드박스를 업데이트하지 않습니다. 작동 방식은 [파일 및 환경](https://docs.replit.com/ko/build/code/navigate-your-workspace.md#파일-및-환경)을 참조하세요.

양식이 나타나지 않으면 Replit에 작동하는 설정을 저장해 달라고 요청할 수 있습니다. 자세한 설정 안내는 [재사용 가능한 환경 만들기](https://docs.replit.com/ko/build/code/create-reusable-environment.md)에 있습니다.

**3. 새 탭에서 미리보기 열기**

미리보기 도구 모음 오른쪽 상단의 **Open in a new tab**을 선택하세요. 버튼 위에 마우스를 올리면 툴팁이 표시됩니다.

![Open in a new tab 버튼과 해당 툴팁이 강조 표시된 미리보기 도구 모음.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/open-preview-tab.jpg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=6a25f71d56825d3bba81068ee7786ba3)

애플리케이션이 별도의 브라우저 탭에서 열려 더 넓은 공간에서 사용해 볼 수 있습니다. 여전히 프로덕션 배포가 아닌 개발 미리보기를 보고 있는 것입니다.

![주변의 Replit 채팅과 사이드바 없이 표시된 Cloud Agent Demo 랜딩 페이지.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/cloud-agent-demo-browser-preview.jpg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=42295144489b57ee47f267524de5068e)

랜딩 페이지 데모에서는 다음을 해 볼 수 있습니다.

* **탐색 사용해 보기:** 링크를 선택해 페이지의 각 섹션으로 이동해 보세요.
* **콘텐츠 살펴보기:** 워크플로, 장점, 작동 방식 섹션을 찾아보세요.
* **레이아웃 확인하기:** 미리보기 크기를 조절해 더 작은 화면에서 페이지가 어떻게 적응하는지 확인하세요.

미리보기가 로드되지 않으면 Replit에 서버와 미리보기 엔드포인트를 확인해 달라고 요청하세요. 응답이 멈추면 Replit에 앱을 다시 시작하고 링크를 다시 확인해 달라고 요청하세요.

다음 단계: 앱을 개선하기 위해 [기여하기](https://docs.replit.com/ko/build/code/first-contribution.md).