Gemini 4 Argon을 지금 이용 가능합니다. 사용해 보기.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Google AI Studio에서 앱 빌드

이 페이지에서는 Google AI Studio를 사용하여 Nano Banana, Live API 같은 Gemini의 최신 기능을 테스트하는 앱을 빠르게 빌드 또는 '바이브 코딩'하고 배포하는 방법을 설명합니다. Google AI Studio는 자연어 프롬프트 작성을 통해 풀 스택 런타임을 사용하는 웹 앱과 Kotlin 및 Jetpack Compose를 사용하는 네이티브 Android 앱을 빌드할 수 있도록 지원합니다.

시작하기

Google AI Studio의 빌드 모드에서 바이브 코딩을 시작하세요. 다음과 같은 몇 가지 방법으로 빌드를 시작할 수 있습니다.

프롬프트로 시작: 빌드 모드에서 입력 상자를 사용하여 빌드하려는 항목에 대한 설명을 입력합니다. AI 칩을 선택하여 이미지 생성 또는 Google 지도 데이터와 같은 특정 기능을 프롬프트에 추가합니다. 음성 텍스트 변환 버튼을 사용하여 원하는 내용을 말할 수도 있습니다.
'운이 좋은 것 같아요' 버튼: 창의적인 아이디어가 필요하다면 '운이 좋은 것 같아요' 버튼을 사용하세요. Gemini가 프로젝트 아이디어가 포함된 프롬프트를 생성하여 시작할 수 있도록 도와줍니다.
갤러리에서 프로젝트 리믹스: 앱 갤러리에서 프로젝트를 열고 앱 복사를 선택합니다.
GitHub에서 프로젝트 가져오기: 빌드 모드에서 프롬프트 입력 상자의 파일 추가 (+ 아이콘) 메뉴에서 GitHub에서 가져오기를 선택하여 기존 코드를 가져옵니다.

프롬프트를 실행하면 필요한 코드와 파일이 생성되고, 앱의 실시간 미리보기가 오른쪽에 표시됩니다.

무엇이 생성되나요?

프롬프트를 실행하면 AI Studio에서 완전한 애플리케이션을 만듭니다. 플랫폼 선택 도구를 사용하여 웹 앱 또는 네이티브 Android 앱을 빌드할 수 있습니다.

웹 앱 (기본값)의 경우 AI Studio는 다음을 포함하는 풀 스택 환경을 만듭니다.

클라이언트 측: 웹 프런트엔드 (React가 기본값)
서버 측: 안전한 API 호출, 데이터베이스 연결, npm 패키지 사용을 허용하는 Node.js 런타임입니다.

Android 앱의 경우 AI Studio는 브라우저 기반 에뮬레이터에서 미리 보고, 실제 기기에 설치하고, 테스트를 위해 Play 스토어에 게시할 수 있는 Kotlin 및 Jetpack Compose 프로젝트를 생성합니다. Android 앱 빌드에 대해 자세히 알아보기

오른쪽 미리보기 창에서 코드 탭을 선택하여 생성된 코드를 볼 수 있습니다. Antigravity 에이전트는 스택 전반에서 여러 파일을 지능적으로 관리하여 변경사항이 올바르게 전파되도록 합니다.

Antigravity 에이전트

Antigravity 에이전트는 Google Antigravity의 주요 AI 기능이며, 이제 에이전트 하네스의 핵심 구성요소가 Google AI Studio의 빌드 모드 환경을 지원합니다. 단순한 코드 생성을 넘어 전체 프로젝트의 컨텍스트를 유지하고, 여러 파일을 관리하며, 복잡한 안내를 이해하여 강력한 풀 스택 애플리케이션을 빌드합니다.

주요 기능은 다음과 같습니다.

컨텍스트 인식: 이전 프롬프트 및 파일 상태의 컨텍스트를 유지합니다.
여러 파일 관리: 여러 파일 간의 종속 항목을 처리합니다.
확인된 실행: 코드 업데이트를 확인하여 할루시네이션을 줄입니다.

풀 스택 기능

Google AI Studio는 최신 웹 생태계의 강력한 기능을 활용하여 클라이언트 측 프로토타입 이상의 기능을 빌드할 수 있습니다.

서버 측 런타임 및 npm: 방대한 npm 패키지 라이브러리를 사용합니다. 에이전트는 앱에 필요한 패키지 (예: 데이터 시각화 또는 API 클라이언트를 위한 특정 라이브러리)를 자동으로 식별하고 설치합니다. 원하는 경우 특정 패키지를 요청할 수도 있습니다.
보안 비밀 관리: 설정 메뉴에 API 키와 보안 비밀을 안전하게 저장합니다. 이러한 변수는 서버 측 코드에서 액세스할 수 있으므로 클라이언트 측 노출로부터 안전하게 보호됩니다.
멀티플레이어: AI Studio 내에서 바로 실시간 공동작업 환경을 빌드합니다. 서버 측 런타임은 사용자가 함께 상호작용하는 데 필요한 상태와 연결을 관리합니다.
Firebase Firestore 및 인증: Firestore 데이터베이스 (영구 데이터 스토리지) 및 Firebase 인증 (로그인 흐름, 특히 'Google 계정으로 로그인')을 포함하여 Firebase를 자동으로 프로비저닝하고 설정합니다. 에이전트는 전체 설정 프로세스를 처리하고 이러한 서비스에 대한 앱의 코드까지 작성합니다.
Google Workspace 통합: 앱을 Gmail, Sheets, Docs, Drive, Calendar 등의 Google Workspace API에 연결합니다. AI Studio는 모든 OAuth 구성을 자동으로 처리합니다.

풀 스택 앱 개발에 대해 자세히 알아보기

Android 앱

Kotlin과 Jetpack Compose를 사용하여 네이티브 Android 앱을 빌드할 수도 있습니다. 브라우저 기반 Android Emulator에서 앱을 미리 보고, 브라우저에서 ADB를 사용하여 실제 기기에 설치하고, 내부 테스트를 위해 Play 스토어에 게시합니다.

AI Studio는 Android 앱용 Firebase와도 통합되어 Firebase AI Logic 및 Firebase 앱 체크 (원시 API 키를 노출하지 않고 안전한 클라이언트 측 Gemini API 호출을 위해)는 물론 Cloud Firestore 및 Firebase 인증을 자동으로 프로비저닝합니다.

Android 앱 빌드에 관해 자세히 알아보기

계속 빌드하세요

Google AI Studio에서 애플리케이션의 초기 코드를 생성하면 계속해서 코드를 미세 조정할 수 있습니다.

Google AI Studio에서 빌드

Gemini로 반복: 빌드 모드의 채팅 패널을 사용하여 Gemini에게 수정, 새 기능 추가, 스타일 변경을 요청합니다.
코드 직접 수정: 미리보기 패널에서 코드 탭을 열어 실시간으로 수정합니다.

외부에서 개발

고급 워크플로의 경우 코드를 동기화하거나 내보내 선호하는 환경에서 작업할 수 있습니다.

GitHub와 동기화: 앱을 GitHub 저장소에 연결하여 양방향 동기화를 사용 설정합니다. AI Studio에서 프롬프트된 변경사항을 AI 생성 커밋 메시지와 함께 저장소에 직접 푸시하거나 IDE에서 로컬로 또는 팀원이 수행한 변경사항을 AI Studio로 다시 가져올 수 있습니다. 설정의 GitHub 탭에서 언제든지 동기화 상태를 관리할 수 있습니다.
로컬에서 다운로드 및 개발: 생성된 코드를 ZIP 파일로 내보내고 코드 편집기로 가져옵니다.

주요 특징

Google AI Studio에는 빌드 프로세스를 직관적이고 시각적으로 만드는 여러 기능이 포함되어 있습니다.

풀 스택 앱 만들기 및 반복: 프롬프트만으로 풀 스택 앱을 만들고 채팅 또는 주석 모드를 통해 반복합니다. 주석 모드를 사용하면 앱 UI의 모든 부분을 강조 표시하고 원하는 변경사항을 설명할 수 있습니다.
앱 공유 및 배포: 창작물을 다른 사용자와 공유하여 공동작업하거나 작품을 선보일 수 있습니다. 공유 시 API 호출은 사용량 한도에 반영됩니다. 유료 모델을 사용하는 경우 비용이 부과될 수 있습니다. 그런 다음 앱이 준비되면 Cloud Run에 배포합니다.
앱 갤러리: 앱 갤러리는 프로젝트 아이디어의 시각적 라이브러리를 제공합니다. Gemini로 할 수 있는 작업을 둘러보고, 애플리케이션을 즉시 미리 보고, 리믹스하여 나만의 애플리케이션을 만들 수 있습니다.

앱 배포 또는 보관처리

애플리케이션이 준비되면 배포할 수 있습니다.

Cloud Run: 애플리케이션을 확장 가능한 서비스로 배포합니다. 사용량에 따라 Google Cloud Run 가격이 적용될 수 있습니다. 배포에 대해 자세히 알아보려면 Google AI Studio에서 배포를 참고하세요.
GitHub: 프로젝트를 새 GitHub 저장소 또는 기존 GitHub 저장소와 동기화하여 소스 코드를 관리하거나 팀원과 공동작업합니다.

제한사항

이 섹션에는 Google AI Studio의 빌드 모드에 대한 현재 제한사항이 나와 있습니다.

API 키 관리

Gemini API를 사용하는 새 웹 앱을 만들면 AI Studio가 Gemini API 키를 앱의 서버 측 환경에서 보안 비밀로 자동 구성합니다. 보안 비밀 패널에서 이 키를 확인하고 관리할 수 있습니다.

자동 설정: GEMINI_API_KEY가 자동으로 설정되므로 빌드를 시작하기 위해 수동으로 구성할 필요가 없습니다.
서버 측 전용: API 키가 서버 측 런타임에 삽입되며 클라이언트 측 코드에 포함되지 않습니다.
기존 앱: 2026년 5월 14일 이전에 빌드된 앱의 경우 다음에 앱의 Gemini 기능을 수정할 때 에이전트가 Gemini API 통합을 권장되는 서버 측 접근 방식으로 자동으로 업그레이드합니다.

Android 앱

Android 앱을 빌드할 때 AI Studio는 원시 API 키 대신 Firebase AI Logic 및 Firebase 앱 체크를 사용하므로 사용자 인증 정보가 APK에 삽입되지 않습니다.

Google AI Studio 외부 배포

Cloud Run: AI Studio에서 Cloud Run에 배포하면 API 키가 서버 측 환경에 안전하게 포함됩니다. 배포된 앱은 모든 사용자의 Gemini API 호출에 개발자의 API 키를 사용합니다.
ZIP 다운로드: 앱을 ZIP 파일로 다운로드하여 다른 곳에서 실행하려면 호스팅 환경에서 GEMINI_API_KEY 환경 변수를 설정해야 합니다. 앱의 Gemini API 호출은 서버 측 코드에서 이루어지므로 키가 최종 사용자에게 노출되지 않습니다.

앱 공유 시 오류

앱을 공유하고 최종 사용자가 공유 URL을 사용할 때 403 액세스 제한 오류가 발생하는 경우 다음 중 하나가 원인일 수 있습니다.

브라우저 확장 프로그램: Privacy Badger와 같은 개인 정보 보호 확장 프로그램이 앱을 차단하고 있을 수 있습니다. 오류를 방지하려면 확장 프로그램을 사용 중지하세요.
빌드 문제: 현재 코드에 문제가 있을 수 있습니다. 에이전트에게 '현재 코드의 빌드 문제를 해결'하라는 메시지를 표시한 후 URL을 다시 공유합니다.

FAQ

AI Studio에서 빌드란 무엇인가요?

AI Studio Build는 Gemini를 사용하여 간단한 프롬프트에서 프로덕션에 즉시 사용 가능한 AI 기반 애플리케이션으로 전환할 수 있도록 설계된 플랫폼입니다. 프롬프트로 빌드하려는 항목을 설명하면 Gemini가 앱을 생성합니다. 또한 갤러리를 둘러보며 Gemini API로 무엇을 할 수 있는지 알아보고 앱을 리믹스하여 나만의 앱을 만들 수도 있습니다.

Build는 내 Gemini API 키를 어떻게 처리하나요?

Gemini API를 사용하는 웹 앱을 만들면 AI Studio가 Gemini API 키를 서버 측 보안 비밀로 자동 설정합니다. 앱의 Gemini API 호출은 이 키를 사용하여 서버 측 코드에서 이루어지므로 브라우저에 노출되지 않습니다. 설정의 보안 비밀 패널에서 API 키를 볼 수 있습니다. Android 앱의 경우 AI Studio는 Firebase AI Logic 및 Firebase 앱 체크를 사용하여 앱 바이너리에 API 키를 삽입하지 않고도 안전한 클라이언트 측 호출을 수행합니다.

앱을 공유할 때 API 키가 노출되나요?

아니요. API 키는 서버 측 보안 비밀로 저장되며 클라이언트 측 코드에 포함되지 않습니다. 앱을 공유하면 다른 사용자가 앱을 사용할 수 있지만 API 키는 볼 수 없습니다.

앱을 다른 사용자와 공유할 때 API 호출은 사용량 한도에 포함됩니다. 유료 모델을 사용하는 경우 비용이 부과될 수 있습니다. AI Studio는 설정 중과 공유 전에 앱에 비용이 발생할 수 있는지 알려줍니다.

누가 내 앱을 볼 수 있나요?

기본적으로 앱은 비공개입니다. 다른 사용자와 앱을 공유하여 사용하도록 할 수 있습니다. 앱을 공유하는 사용자는 코드를 보고 자체 용도로 포크할 수 있습니다. 수정 권한이 있는 앱을 공유하면 다른 사용자가 앱의 코드를 수정할 수 있습니다.

AI Studio 외부에서 앱을 실행할 수 있나요?

예. AI Studio에서 Cloud Run에 앱을 배포할 수 있습니다. 그러면 서버 측 환경에 API 키가 안전하게 구성된 공개 URL이 앱에 제공됩니다. 앱을 ZIP 파일로 다운로드하여 다른 곳에서 호스팅할 수도 있습니다. 호스팅 환경에서 GEMINI_API_KEY 환경 변수를 설정해야 합니다. Gemini API 호출은 서버 측 코드에서 이루어지므로 키가 안전하게 유지됩니다.

배포 옵션에 대해 자세히 알아보려면 Google AI Studio에서 배포를 참고하세요.

자체 도구를 사용하여 로컬에서 앱을 개발한 후 여기에서 공유할 수 있나요?

예. AI Studio 앱을 GitHub 저장소에 연결하여 선호하는 코드 편집기 또는 CLI 도구를 사용하여 로컬에서 개발하고, 변경사항을 GitHub에 푸시한 다음, 설정의 GitHub 탭을 사용하여 해당 업데이트를 AI Studio로 직접 가져올 수 있습니다.

앱에서 데이터베이스나 다른 스토리지를 사용하려면 어떻게 해야 하나요?

AI Studio 앱은 Cloud Run 컨테이너에서 실행되는 표준 앱입니다. 동적 IP 범위에서 액세스를 차단하는 방화벽이 없는 한 네트워크를 통해 연결할 수 있는 모든 스토리지 솔루션을 사용할 수 있습니다.

향후 AI Studio 내에서 직접 구성할 수 있는 스토리지에 대한 직접 지원을 추가하기 위해 노력하고 있습니다.

마이크, 웹캠, 기타 Navigator API에 액세스하려면 어떻게 해야 하나요?

시청자가 앱의 웹캠 또는 기타 기기 사용을 인지할 수 있도록 앱이 이러한 Navigator API에 액세스하려면 추가 확인이 필요합니다. 앱 제작자는 이러한 권한 요청을 앱의 metadata.json 파일에 추가할 수 있습니다. 예를 들면 다음과 같습니다.

{
  "name": "My app",
  "requestFramePermissions": [
    "microphone",
    "camera",
    "display-capture",
    "geolocation",
    "bluetooth",
    "clipboard-read",
    "serial",
    "usb"
  ]
}

requestFramePermissions에 지원되는 값은 표준 정책 제어 기능의 하위 집합입니다.

앱에서 GitHub를 사용하려면 어떻게 해야 하나요?

AI Studio는 GitHub와의 양방향 동기화를 지원합니다.

저장소 가져오기: 빌드 모드에서 프롬프트 입력 상자의 파일 추가 (+ 아이콘) 메뉴에서 GitHub에서 가져오기를 선택하여 기존 코드를 가져옵니다.
저장소 연결: 설정에서 GitHub 탭을 열어 앱에서 새 GitHub 저장소를 만들거나 기존 저장소에 연결합니다.
양방향 동기화: AI Studio에서 프롬프트된 변경사항을 AI 생성 커밋 메시지와 함께 저장소에 직접 푸시하거나 외부에서 변경된 사항 (예: 로컬 IDE 수정사항 또는 팀원 pull 요청)을 AI Studio로 다시 가져옵니다.
병합 충돌 해결: GitHub와 동기화할 때 변경사항이 충돌하는 경우 AI Studio는 나란히 비교하는 차이 뷰어가 있는 충돌 해결 대화상자를 제공하여 차이점을 검토하고 충돌하는 각 파일에 대해 AI Studio 또는 GitHub 버전을 유지할지 선택할 수 있습니다.

다른 사용자에게 내 앱에 대한 수정 액세스 권한을 부여할 수 있나요?

AI Studio는 직접적인 실시간 공동작업 편집을 지원하지 않습니다. 하지만 앱을 공유 GitHub 저장소에 연결하여 팀원과 공동작업할 수 있습니다. 팀원이 GitHub에서 변경사항을 푸시하거나 pull 요청을 열면 AI Studio로 해당 업데이트를 가져올 수 있습니다.

내 앱이 정책 위반으로 신고된 이유는 무엇인가요?

Google은 앱이 Google 정책을 준수하는지 자동으로 검토하는 시스템을 갖추고 있습니다. 앱이 Google 정책을 위반하는 것으로 확인되면 해당 앱은 AI Studio에서 삭제됩니다. 정책 위반에는 다음이 포함되지만 이에 국한되지는 않습니다.

멀웨어, 피싱 또는 명의 도용이 포함된 앱
아동 성적 학대 이미지 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
괴롭힘 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
증오심 표현에 대한 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
인신매매 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
음란물 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
폭력 및 유혈 콘텐츠 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
유해하거나 위험한 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱

앱이 정책 위반으로 신고되었지만 오류라고 생각되면 이의신청을 제출할 수 있습니다. Google 정책을 반복적으로 위반하면 AI Studio에 대한 액세스 권한이 해지될 수 있습니다.

앱 개발자로서의 책임은 무엇인가요?

애플리케이션 소유자는 애플리케이션의 동작과 애플리케이션이 처리하는 모든 데이터에 대한 책임이 있습니다. 여기에는 다음이 포함됩니다.

법적 규정 준수 및 서드 파티 권리: 앱이 모든 관련 법률 및 규정을 준수하고 지식 재산권 및 개인 정보 보호 권리를 포함한 타인의 권리를 침해하지 않도록 합니다.
콘텐츠 모니터링: 앱에서 사용하는 다른 서비스에 추가 약관 준수가 적용될 수 있습니다. 예를 들어 Firestore에 적용되는 Google Cloud 서비스 약관에 따라 서드 파티 콘텐츠를 호스팅하는 고객은 금지되는 콘텐츠 (예: 불법 콘텐츠)를 정의하는 정책을 게시하고 해당 불법 콘텐츠의 존재 여부를 모니터링해야 합니다.
안전한 구현: 애플리케이션이 오용되지 않도록 필요한 보호 장치와 관리 도구를 구현합니다.

서비스 약관의 사용 제한을 숙지하세요.

AI Studio의 앱 갤러리에 있는 앱에는 어떤 약관이 적용되나요?

달리 명시되지 않는 한 AI Studio의 앱 갤러리에 표시된 앱을 사용하는 경우 Gemini API 추가 서비스 약관이 적용됩니다.

다음 단계

풀 스택 앱 개발 (웹)
Android 앱 빌드
앱 갤러리에서 예시를 확인하세요.