GCP에 Vertex AI 채널을 설치하여 Gemini 4를 조정하는 방법 (OpenCode + CC Switch) 및 $300 크레딧 사용

원문 발행 2026. 11. 11. 18:13원문 언어 영어AI 한국어 번역X Claude/Anthropic 원문 보기

요약

본 문서는 GCP 환경에서 Vertex AI 채널을 설치하고 Gemini 4 모델을 조정하는 상세한 개발 가이드입니다. API 활성화, 전용 서비스 계정 생성 및 조직 정책 확인 등 복잡한 단계별 절차를 안내하며, $300 크레딧 사용 계획도 포함합니다.

핵심 포인트

설치 전 메모리/디스크 용량(1GB)을 반드시 확인해야 합니다.
전용 서비스 계정은 Agent Platform User 역할만 부여해야 합니다.
조직 정책 제한 사항이 있을 수 있어, 관리자 권한 및 수동 개입이 필요합니다.
개발 시 @ai-sdk/google-vertex 패키지와 특정 모델 ID를 사용해야 합니다.

GCP(Google Cloud Platform)에서 Vertex AI 채널을 설치하고 Gemini 4를 조정할 수 있도록 도와주세요 (OpenCode + CC Switch). 이 과정에 $300 체험 크레딧을 차감해 주시기 바랍니다.

제 환경:

Google 계정: [귀하의 Google 계정 이메일]
프로젝트: [귀하의 프로젝트명], 프로젝트 ID: [귀하의 프로젝트 ID]
조직: [귀하의 조직명], 조직 ID: [귀하의 조직 ID]
인스턴스: GCP 무료 e2-micro, Debian 12, 메모리 1GB, 디스크 30GB
로컬에는 이미 Xray가 실행 중입니다 (주요 프록시 라인이며, 중지하거나 설정을 변경하지 마세요); dae는 현재 정지 상태이므로 건드리지 마세요.
$300 체험 크레딧은 이미 수령했으니, 남은 금액과 만료일을 먼저 확인해 주세요.

목표 구성:

Vertex AI API (https://t.co/JDqyjMLo3n) 활성화
provider 패키지 @ai-sdk/google-vertex, location을 global로 설정
모델 gemini-4-argon과 gemini-3.8-flash. 모델 ID는 models/ 접두사를 붙이지 않으며, 기본 모델은 gemini-4-argon으로 설정.

아래 순서대로 진행해 주시고, 각 단계마다 먼저 확인한 후 추측하지 마세요:

메모리와 디스크 용량을 먼저 확인하세요. 기기는 메모리가 1GB밖에 없으므로, 설치 전에 충분한지 확인해야 합니다. 메모리가 가득 차면 중단하고, 무리하게 설치하려고 하지 마세요.
Vertex AI API를 활성화하고, 전용 서비스 계정 vertex-ai-opencode를 생성하세요. 이 계정에는 Agent Platform User 역할(roles/aiplatform.user)만 부여하고, Owner나 Editor 권한은 주지 마세요.
서비스 계정 JSON 키를 생성할 때, 조직 정책에 의해 차단될 가능성이 높습니다. 어떤 정책이 막고 있는지 먼저 확인해 주세요:
- 막는 것이 구 버전 제한인 iam.disableServiceAccountKeyCreation인지 확인하세요. 관리형(Managed) 버전에서 '미적용'으로 표시되면 건드리지 마세요. 관리형 버전을 수정하는 것은 소용없습니다.
- 정책을 변경하기 전에, 제 계정에 Organization Policy Administrator (roles/orgpolicy.policyAdmin) 역할이 있는지 먼저 확인해 주세요. Organization Administrator라는 역할 자체에는 조직 정책을 변경할 권한이 포함되어 있지 않으므로, 없다면 일단 멈추고, 제가 콘솔에서 수동으로 이 역할을 추가해야 한다고 알려주세요. 절대 임의로 계정을 바꾸거나 인증 코드를 입력하지 마세요.
- 만약 브라우저 자체적으로 조직이 이미 활성화한 보안 제한을 일시적으로 해제할 수 없다면 (이는 우회하는 행위입니다), 멈추고 저에게 알려주세요. 정책 변경 단계는 제가 콘솔에서 직접 수동으로 진행할 것이므로, 무리하게 시도하지 마세요.
- 제가 수동으로 수정할 방법(확인만 부탁드립니다. 대신 수정하지 마세요): 프로젝트 레벨에서 해당 제한의 정책 출처를 '부모 리소스 정책 덮어쓰기'로 변경하고, 새 규칙을 만들어 적용 설정을 '비활성화'로 설정한 후 완료 버튼을 누르고, 정책 저장 버튼을 누르세요. 이 프로젝트만 수정하고 조직 전체는 건드리지 마세요. 수정한 후에는 해당 프로젝트의 유효 정책이 실제로 강제 실행되지 않고, 여전히 조직 레벨에서 강제 실행되는지 먼저 확인해 주세요. 그 후에 다음 단계로 진행하세요.
키를 생성한 후에는 로컬 기기의 ~/.config/gcloud/application_default_credentials.json에만 저장하고 권한을 0600으로 설정하세요. 키 내용은 채팅, 보고서 또는 어떤 파일에도 절대로 붙여넣지 마세요. Cloud Shell의 임시 복사본은 생성하자마자 삭제하세요. 키를 만들기 전에, 해당 서비스 계정에 이미 몇 개의 키가 있는지 먼저 확인해 주세요: 만약 이번에 생성한 것이 아닌 다른 키가 발견되면, 삭제하지 말고 저에게 알려주세요. 제가 확인하도록 하겠습니다.
OpenCode와 CC Switch를 설치할 때는 공식 채널만 이용하세요:
- OpenCode는 https://t.co/dhrhqnZhBx 공식 스크립트를 사용하여 설치하고, 설치 후 버전과 경로 ~/.opencode/bin/opencode를 확인하세요.
- CC Switch는 farion1231/cc-switch의 공식 GitHub 릴리스에 있는 Debian x86_64 .deb 파일을 사용하여 설치하고, 설치 후 버전과 경로 /usr/bin/cc-switch를 확인하세요. 의존성은 apt를 통해 Debian 공식 저장소에서 보충하세요.
- 먼저 두 소프트웨어의 최신 버전 번호를 확인하고, 출처가 불분명한 패키지는 설치하지 마세요.
CC Switch 설정:
주의: CC Switch는 그래픽 프로그램이므로, 디스플레이가 없는 기기에서 --version을 실행하면 GTK 초기화 실패로 인해 작동하지 않는 것이 정상입니다. 이를 고장으로 간주하지 마세요. 직접 작성한 형식에 따라 로컬 기기의 ~/.config/opencode/opencode.json 파일을 만들어 주세요 (provider는 google-vertex, 패키지는 @ai-sdk/google-vertex, project에는 제 프로젝트 ID를 입력하고, location은 global로 입력하며, 두 모델을 모두 설정하고 기본값은 gemini-4-argon으로 합니다). 그 후 opencode models google-vertex 명령어를 사용하여 두 모델이 목록에 있는지 확인하세요. GUI 환경에서 CC Switch를 열 경우, 최초 실행 시 이 파일을 가져오게 되니 다시 한번 확인해 주세요.
실측 테스트: 17×23을 사용하여 아주 작은 규모의 테스트 호출을 수행합니다 (프롬프트는 숫자만 답하고 설명하지 않도록 지시). 두 모델 모두 시도하여 반환값, 소요 시간, 토큰 수, 그리고 비용을 기록해야 합니다. 참고 실측 결과: flash는 약 9초, argon은 약 30초가 소요되었으며, 네 번의 호출 합계 비용은 약 $0.05입니다. 입력 토큰 약 8000개는 OpenCode에 기본 포함된 시스템 프롬프트 및 도구 컨텍스트이므로 정상 범위입니다.

주의사항: gcloud compute ssh --command로 원격에서 opencode run을 실행할 때, 명령어 끝에 반드시 < /dev/null를 추가해야 합니다. 그렇지 않으면 opencode가 표준 입력(stdin)을 기다리느라 장시간 동안 출력이 없을 수 있습니다.

청구서 확인: 호출 비용이 실제로 $300 크레딧으로 상쇄되어 지불할 금액이 $0인지 확인합니다. 주의할 점은 당일 발생한 비용은 정산 보고서에 아직 반영되지 않았을 수 있다는 것입니다 (보고서는 보통 전날까지만 포함). 최종 확인은 다음 날 다시 봐야 합니다.
마무리 정리: Xray가 여전히 실행 중인지, SSH 연결이 여전히 가능한지, dae는 여전히 정지 상태인지 확인하고, 정적 IP(static IP)를 새로 생성하지 않았는지, 인스턴스/프로젝트/규칙을 삭제하지 않았는지 확인합니다. 조직 정책 복구 단계는 본인이 콘솔에서 수동으로 수행했습니다 (프로젝트 수준의 덮어쓰기 규칙을 강제 실행으로 되돌리거나 덮어쓰기 규칙을 삭제하고, '정책 설정 저장'을 누르며, 이 프로젝트만 수정). 복구 후에도 이미 생성된 키는 계속 사용할 수 있으니, 이 점은 보고서에 명시해 주십시오.
마지막으로 알려주세요: 프로젝트 ID, 두 소프트웨어의 버전 및 경로, 테스트 결과(반환값, 소요 시간, 비용), 크레딧 잔액 및 만료일, 그리고 제가 나중에 기기에서 실행할 구체적인 명령을 알려주십시오.

[금지 사항]: 절대 유료 정산 업그레이드를 진행하지 말 것, 정적 IP를 새로 생성하지 말 것, 인스턴스/프로젝트/규칙을 삭제하지 말 것, Xray와 dae는 건드리지 말 것, 방화벽 규칙을 이동시키지 말 것, 키(key)나 UUID 같은 자격 증명을 어떤 반환 내용에 붙여 넣지 말 것.

AI 자동 생성 콘텐츠

원문 바로가기

GCP에 Vertex AI 채널을 설치하여 Gemini 4를 조정하는 방법 (OpenCode + CC Switch) 및 $300 크레딧 사용

요약

핵심 포인트

댓글