이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Gemini Code Assist 설정하기

Gemini Code Assist를 사용하려면 먼저 팀에서 이 문서에 설명된 설정 단계를 수행해야 합니다.

Gemini Code Assist 구독을 구매합니다.
조직의 개별 사용자에게 라이선스를 할당합니다.
Google Cloud 프로젝트에서 Google Cloud를 위한 Gemini API를 사용 설정합니다.
Google Cloud 프로젝트에서 Identity and Access Management(IAM) 역할을 부여합니다.
조직의 사용자가 Gemini Code Assist 플러그인을 설치하여 IDE에서 Gemini Code Assist를 사용합니다.

Gemini Code Assist 구독 구매

각 버전에서 사용할 수 있는 기능 목록은 지원되는 기능을 참고하세요.

Gemini Code Assist Enterprise는 2025년 3월 31일까지 12개월 약정으로 사용자당 월 19달러에 사용 가능합니다. 이 프로모션 코드를 활용하려면 Google 영업팀에 문의하세요.

Google Cloud와 기존 계약이 있으면 구독을 구매하기 전에 Google 영업팀에 문의하세요.

참고: Gemini 구독을 구매하려면 결제 계정에 consumerprocurement.orders.place Identity and Access Management (IAM) 권한이 있어야 합니다. consumerprocurement.orders.place 권한은 roles/billing.admin IAM 역할 또는 roles/consumerprocurement.orderAdmin 역할에 포함되어 있습니다. 또는 권한을 커스텀 역할에 추가할 수도 있습니다.

Google Cloud를 위한 Gemini 페이지로 이동합니다.

Google Cloud를 위한 Gemini로 이동

Google Cloud를 위한 Gemini 페이지가 열립니다.
Gemini Code Assist 구매하기를 선택합니다. 프로젝트에 이미 Gemini Code Assist가 있으면 이 텍스트에 Gemini Code Assist 관리가 표시됩니다.

Gemini Code Assist 구독 구매하기 페이지가 열립니다.
Gemini Code Assist 구독 버전 선택에서 Gemini Code Assist 버전을 선택합니다. Gemini Code Assist 버전 비교를 선택하여 각 버전에서 사용할 수 있는 기능의 세부 목록을 확인하세요.

그런 다음 계속을 선택합니다.
구독 구성에서 다음을 포함하여 필드를 작성해 구독을 구성합니다.
- 구독 이름
- 구독의 라이선스 수 Enterprise 버전을 구매하는 경우 라이선스를 10개 이상 구매해야 합니다.
- 구독 기간(월간 또는 연간). 연간 구독의 경우 할인율이 적용되며 수시 입금이 아닌 월별로 청구됩니다.
- 약정 기간(월간 또는 연간)이 종료된 후 구독 자동 갱신. 자동 갱신을 사용하면 구독 및 라이선스가 활성 상태로 유지됩니다. 구독이 자동 갱신되지 않으면 현재 기간 종료 시 구독이 종료되며 구매 프로세스를 다시 진행하고 라이선스를 재할당해야 합니다.
구독을 확인하려면 계속을 선택합니다.
약관에 동의하면 구매 약관에 동의합니다를 선택한 후 구독 확인을 선택합니다.
다음: Gemini 라이선스 할당 관리를 선택합니다.

이제 Gemini Code Assist 구독이 구매되었습니다. 이제 조직에서 Gemini 라이선스 할당을 관리해야 합니다.

라이선스 할당

Gemini Code Assist를 사용하려면 조직의 각 사용자에게 라이선스가 필요합니다.

콘솔

Google Cloud 콘솔에서 개별 사용자에게 Gemini 라이선스를 할당하려면 다음 권한이 있어야 합니다.

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign

Gemini 관리자 페이지로 이동합니다.

Gemini 관리자로 이동
변경하려는 구독을 선택한 후 구독 수정을 클릭합니다.
'라이선스 할당'을 클릭합니다. 사용자 선택 대화상자가 표시됩니다. 특정 사용자를 검색하려면 검색창에 사용자 이름을 입력합니다.
목록에서 사용자를 한 명 이상 선택한 후 다음을 클릭합니다.
라이선스를 할당할 Gemini 서비스를 선택합니다.
'라이선스 할당'을 클릭합니다.

API

API로 Gemini 라이선스를 할당하려면 consumerprocurement.licensePools.assign 권한이 있어야 합니다.

HTTP 메서드: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

다음을 바꿉니다.

BILLING_ACCOUNT_ID: 결제 계정 ID
ORDER_ID: IAM 정책

요청 본문:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

출력은 다음과 비슷합니다.

{}

라이선스가 할당되면 응답은 비어 있습니다.

이제 이 결제 계정과 연결된 프로젝트 하나 이상에서 Google Cloud를 위한 Gemini API를 사용 설정해야 합니다. 프로젝트 최소 하나 이상에서 Gemini Code Assist를 활성화하기 전까지는 사용자에게 Gemini Code Assist가 표시되지 않습니다.

Google Cloud 프로젝트에서 Google Cloud를 위한 Gemini API 사용 설정

이 섹션에서는 Google Cloud 프로젝트에서 Google Cloud를 위한 Gemini API를 사용 설정하는 데 필요한 단계를 설명합니다.

콘솔

Google Cloud를 위한 Gemini API를 사용 설정하려면 Google Cloud를 위한 Gemini 페이지로 이동합니다.

Google Cloud를 위한 Gemini로 이동
프로젝트 선택기에서 프로젝트를 선택합니다.
사용 설정을 클릭합니다.

페이지가 업데이트되고 사용 설정됨 상태가 표시됩니다. 이제 선택한 Google Cloud 프로젝트에서 필요한 IAM 역할을 가진 모든 사용자가 Gemini를 사용할 수 있습니다.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell
프로젝트 선택기 메뉴에서 프로젝트를 선택합니다.
gcloud services enable 명령어를 사용하여 Gemini에 Google Cloud를 위한 Gemini API를 사용 설정합니다.
```
gcloud services enable cloudaicompanion.googleapis.com
```
다른 Google Cloud 프로젝트에서 Google Cloud를 위한 Gemini API를 사용 설정하려면 --project 파라미터를 추가합니다.
```
gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
```
PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

출력은 다음과 비슷합니다.
```
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.
```

이제 지정된 Google Cloud 프로젝트에서 필요한 IAM 역할이 있는 모든 사용자가 Gemini for Google Cloud를 사용할 수 있습니다.

방화벽 뒤에 있는 사용자에게 필요한 API

방화벽 뒤에 있는 사용자는 Google Cloud API용 Gemini를 사용 설정하는 것 외에도 다음 API를 사용 설정해야 할 수도 있습니다.

oauth2.googleapis.com: Google Cloud에 로그인하는 데 사용됩니다.
serviceusage.googleapis.com: 사용자의 Gemini Code Assist 프로젝트가 올바르게 구성되었는지 확인하는 데 사용됩니다.
cloudaicompanion.googleapis.com: Google Cloud API용 기본 Gemini 엔드포인트입니다.
cloudcode-pa.googleapis.com: IDE 관련 기능을 제공하는 내부 API입니다.
cloudresourcemanager.googleapis.com: 프로젝트 선택 도구의 IDE에서 사용됩니다. 프로젝트가 settings.json 파일에서 명시적으로 구성된 경우 Resource Manager API가 필요하지 않을 수 있습니다.
people.googleapis.com: 프로필 및 연락처에 대한 정보에 대한 액세스를 제공합니다.
firebaselogging-pa.googleapis.com: 추천이 수락되었는지에 관한 이벤트를 비롯한 제품 원격 분석을 전송하는 데 사용되는 내부 API입니다.
feedback-pa.googleapis.com: IDE 내 의견 제출에 사용되는 내부 API입니다.
apihub.googleapis.com: Cloud Code API 브라우저 기능에서 사용합니다.

선택사항: VPC 서비스 제어 구성

조직에 서비스 경계가 있는 경우 다음 리소스를 경계에 추가해야 합니다.

Google Cloud API용 Gemini
Gemini Code Assist API

서비스 경계 외부에서 Gemini Code Assist를 사용하는 경우 이러한 서비스에 대한 액세스를 허용하도록 인그레스 정책도 수정해야 합니다.

자세한 내용은 Gemini용 VPC 서비스 제어 구성을 참고하세요.

Google Cloud 프로젝트에서 IAM 역할 부여

이 섹션에서는 Google Cloud를 위한 Gemini 사용자 및 서비스 사용량 소비자 IAM 역할을 사용자에게 부여하는 데 필요한 단계를 설명합니다.

콘솔

Gemini 사용에 필요한 IAM 역할을 부여하려면 IAM 및 관리자 페이지로 이동합니다.

IAM 및 관리자로 이동
주 구성원 열에서 Gemini에 대한 액세스 권한을 부여하려는 주 구성원을 찾은 후 해당 행에서 주 구성원 수정을 클릭합니다.
액세스 수정 창에서 다른 역할 추가를 클릭합니다.
역할 선택에서 Google Cloud를 위한 Gemini 사용자를 선택합니다.
다른 역할 추가를 클릭하고 서비스 사용량 소비자를 선택합니다.
저장을 클릭합니다.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell
프로젝트 선택기 메뉴에서 프로젝트를 선택합니다.
Google Cloud를 위한 Gemini 사용자 역할을 부여합니다.
```
gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/cloudaicompanion.user
```
PRINCIPAL을 주 구성원 식별자로 바꿉니다. 식별자는 user|group|serviceAccount:email 또는domain:domain 형식을 취합니다(예:user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com 또는 domain:example.domain.com).

다음을 포함하는 정책 바인딩 목록이 출력됩니다.
```
- members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user
```

서비스 사용량 소비자 역할을 부여합니다.

gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer

다음을 포함하는 정책 바인딩 목록이 출력됩니다.

- members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageConsumer

자세한 내용은 단일 역할 부여 및 gcloud projects add-iam-policy-binding을 참조하세요.

이러한 역할이 부여된 모든 사용자가 지정된 프로젝트 내에서 Google Cloud 콘솔의 Google Cloud용 Gemini 기능에 액세스할 수 있습니다. 자세한 내용은 Google Cloud용 Gemini 개요를 참조하세요.

IDE에 Gemini Code Assist 플러그인 설치

조직의 사용자가 선호하는 IDE에 Gemini Code Assist를 설치합니다. 자세한 내용은 다음을 참조하세요.

Cloud Workstations: Gemini Code Assist를 사용한 코드
Cloud Shell 편집기: Gemini Code Assist를 사용한 코드
VS Code: Gemini Code Assist를 사용한 코드
IntelliJ 및 기타 JetBrains IDE: Gemini Code Assist를 사용한 코드

고급 설정 태스크

Google Cloud 콘솔이나 gcloud CLI를 사용하여 사전 정의된 IAM 역할을 부여하는 대신 다음 중 하나를 수행할 수 있습니다.

IAM REST API 또는 IAM 클라이언트 라이브러리를 사용하여 역할을 부여합니다.

이러한 인터페이스를 사용하는 경우 정규화된 역할 이름을 사용합니다.
- roles/cloudaicompanion.user
- roles/serviceusage.serviceUsageConsumer
역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할을 만들고 부여합니다.

생성된 모든 커스텀 역할에서 Gemini Code Assist에 액세스하려면 다음 권한이 필요합니다.
- cloudaicompanion.companions.generateChat
- cloudaicompanion.companions.generateCode
- cloudaicompanion.instances.completeCode
- cloudaicompanion.instances.completeTask
- cloudaicompanion.instances.generateCode
- cloudaicompanion.instances.generateText
- serviceusage.services.enable
라이선스를 할당하고 관리합니다.

생성된 모든 커스텀 역할에서 Gemini Code Assist에 액세스하려면 다음 권한이 필요합니다.
- consumerprocurement.orders.get
- consumerprocurement.orders.licensePools..*
- consumerprocurement.orders.licensePools.update
- consumerprocurement.orders.licensePools.get
- consumerprocurement.orders.licensePools.assign
- consumerprocurement.orders.licensePools.unassign
- consumerprocurement.orders.licensePools.enumerateLicensedUsers

또한 앞선 권한이 작동하려면 각 권한을 할당한 동일한 Google Cloud 프로젝트에서 Google Cloud를 위한 Gemini API를 사용 설정해야 합니다.

다음 단계

Google Cloud를 위한 Gemini에서 사용할 수 있는 생성형 AI 지원 유형에 대해 자세히 알아보세요.
Google Cloud를 위한 Gemini에서 사용자 데이터를 사용하는 방법을 알아보세요.
Gemini Code Assist 관리자 제어에 액세스하고 관리하는 방법을 알아보세요.
코드 맞춤설정을 구성하는 방법을 알아보세요.
Gemini용 VPC 서비스 제어 구성