위크에서 제미나이 연결하기
Windows PC에서 Google 계정을 연결하고, 위크에 표시되는 Gemini 모델을 선택하는 안내서입니다. 위크 0.1.84의 버튼 이름을 기준으로 설명합니다. 공식 서비스의 제공 조건은 2026년 10월 14일에 확인했습니다.
처음 연결한다면 아래 순서대로 진행하십시오. 이미 연결했다면 6 모델 목록 새로 확인하기부터 살펴보면 됩니다.
먼저 알아둘 두 가지 로그인
위크 계정 로그인은 위크의 이용 기간과 등록된 PC를 확인하는 절차입니다. 홈페이지의 계정 관리와 PC 위크에는 같은 위크 계정으로 로그인하십시오.
Gemini 연결은 Google의 AI를 집필에 사용할 수 있도록 연결하는 별도 절차입니다. 위크에 로그인했다고 Gemini까지 연결되지는 않습니다. Gemini를 연결할 때는 Google AI를 사용할 수 있는 개인 Google 계정을 선택하십시오. 두 로그인의 목적이 다르므로, 위크 로그인 오류와 Gemini 연결 오류도 구별해서 확인해야 합니다.
현재 위크의 Gemini 연결에는 Google 공식 Antigravity CLI가 필요합니다. CLI는 위크가 Google AI와 통신할 때 사용하는 연결 도구이며, Windows에서는 agy 명령으로 확인합니다. 이전 Gemini CLI의 gemini 명령과는 다른 프로그램입니다.
1 연결에 사용할 Google 계정 확인하기
브라우저에서 본인이 사용할 Google 계정에 로그인하고, Google AI 구독이 어느 계정에 등록되어 있는지 확인하십시오. 브라우저에 계정이 여러 개 열려 있다면, 연결 승인 화면에서 다른 계정을 선택하지 않도록 주의하십시오.
Gemini 앱에서 보이는 모델이 위크에도 반드시 표시되는 것은 아닙니다. Google은 Gemini 4 Argon을 Gemini 앱의 Google AI Pro·Ultra 이용자에게 제공하고, Antigravity에서는 Google AI Ultra 이용자에게 제공한다고 안내했습니다. 따라서 Gemini 앱에서 아르곤을 사용하더라도 위크의 Antigravity 목록에는 없을 수 있습니다. 이 조건을 먼저 확인하고, 모델이 없다는 이유만으로 다시 설치하거나 더 비싼 구독을 구매하지 마십시오. Google 공식 발표
API의 공식 식별자는 gemini-4-argon입니다. 이는 API 식별자이며, 위크에서는 실제 연결 도구가 반환한 항목을 선택해야 합니다. API에 공개된 이름을 목록에 임의로 추가한다고 해당 계정의 사용 권한이 생기지는 않습니다. Google 모델 안내
2 공식 연결 도구 설치 확인하기
Windows 시작 메뉴에서 PowerShell을 검색해 엽니다. 다음 명령을 입력하고 Enter를 누르십시오.
agy --version
버전 번호가 나오면 연결 도구가 설치되어 있습니다. 이 단계는 버전 확인이며 AI 집필을 실행하는 명령이 아닙니다. 번호가 표시되더라도 최신 버전인지는 별도로 확인해야 합니다.
명령을 찾을 수 없다는 안내가 나오면, Antigravity CLI가 없거나 Windows가 실행 파일의 위치를 찾지 못한 것입니다. 설치하지 않았다면 아래 공식 설치 절차를 진행하십시오. 이미 설치했다면 PowerShell을 닫았다가 다시 열고 확인합니다.
공식 설치가 필요한 경우
Google의 Windows 설치 안내를 열어 출처를 확인하십시오. Google이 안내하는 PowerShell 명령은 다음과 같습니다.
irm https://antigravity.google/cli/install.ps1 | iex
이 명령은 Google의 설치 스크립트를 받아 실행합니다. 주소가 정확히 https://antigravity.google/cli/install.ps1인지 확인한 뒤 본인이 직접 실행하십시오. 모르는 사이트에서 받은 대체 설치 명령이나 인증 우회 프로그램은 사용하지 마십시오.
설치가 끝나면 PowerShell을 닫고 새로 엽니다. agy --version으로 설치 결과를 확인한 뒤, 위크도 닫았다가 다시 여십시오. 이미 실행 중인 프로그램에는 새 실행 파일의 위치가 바로 반영되지 않을 수 있습니다.
위크는 작업 중에 이 연결 도구를 자동 업데이트하지 않습니다. 공식 도구를 갱신했다면 위크를 다시 열어 모델 목록도 확인하십시오. 위크 업데이트와 Antigravity CLI 업데이트는 서로 다른 작업입니다.
이미 설치했지만 목록이 오래된 경우
- 위크에서 진행 중인 작업을 저장하고 위크와 로그인용 터미널을 닫습니다.
- 위의 Google 공식 Windows 설치 안내를 다시 열어 현재 절차를 확인합니다.
- 갱신이 필요하면 공식 설치 절차를 진행합니다. 확인되지 않은
agy update같은 명령을 추측해서 실행하지 마십시오. - 새 PowerShell에서
agy --version으로 바뀐 버전을 확인합니다. - 위크를 다시 열고, 아래 6 모델 목록 새로 확인하기를 진행합니다.
2026년 10월 14일 점검한 PC에는 1.3.1, Google 공식 Windows x64 설치 목록에는 1.3.4가 표시됐습니다. 이 번호는 점검 당시의 결과이며 이후 바뀔 수 있습니다. 최신 도구를 설치해도 특정 모델의 계정 제공 조건까지 바뀌는 것은 아닙니다. Google 공식 설치 스크립트
3 위크 계정과 이용 기간 확인하기
- PC 위크를 엽니다.
- 설정을 엽니다.
- 계정과 이용 기간에서 계정 관리를 누릅니다.
- 로그인 전이라면 위크의 Google 로그인을 완료합니다.
- 위크를 사용할 수 있는 기간이 표시되는지 확인합니다.
홈페이지의 계정 관리 주소는 week.ai.kr/account입니다. 홈페이지에서 쿠폰이나 이용 기간을 반영한 경우, PC 위크의 사용 기간 확인을 눌러 상태를 갱신하십시오.
이용 기간이 끝났거나 계정 확인이 필요하다는 안내가 나오면 이 문제를 먼저 처리해야 합니다. Gemini가 연결되어 있더라도 위크의 이용 기간 확인을 대신하지는 않습니다.
4 위크에서 Gemini 연결 시작하기
- 설정 → AI 구독 연결을 누릅니다.
- AI 연결 창에서 Gemini 항목을 찾습니다.
- 처음 연결한다면 Google 계정 연결을 누릅니다.
- 위크가 열어 준 Google 공식 연결 창의 안내를 따릅니다.
이미 연결되어 있다면 버튼이 연결 확인으로 표시될 수 있습니다. 이 경우 기존 연결을 조회하며, 새로운 로그인 창이 열리지 않는 것이 정상일 수 있습니다. 연결 상태와 모델 목록부터 확인하십시오.
모델 선택 메뉴 안에서도 AI 연결을 눌러 같은 연결 관리 창을 열 수 있습니다. 모델 메뉴의 연결 버튼은 Google AI 구독 연결로 표시됩니다.
5 Google 공식 연결 승인 마치기
처음 연결할 때는 Antigravity의 로그인용 터미널 창이 열릴 수 있습니다. 로그인 방법을 선택하라는 안내가 나오면 개인 계정을 사용하는 Google OAuth를 선택하십시오. Google Cloud 프로젝트를 사용하는 경로는 이 안내의 대상이 아닙니다.
브라우저에서는 Google AI를 사용할 계정을 선택하고, 표시된 서비스 이름과 권한을 확인한 뒤 본인이 직접 승인하십시오. 처음 이용할 때 약관이나 작업 폴더 확인이 나오면 내용을 읽고 판단해야 합니다.
폴더를 신뢰할지 묻는 경우에는 위크가 열어 준 연결용 작업 폴더인지 확인하십시오. 바탕화면 전체나 원고 보관 폴더를 임의로 신뢰시키거나, 권한 확인을 건너뛰도록 설정하지 마십시오. 경로가 낯설다면 중단하고 문의합니다.
브라우저가 인증 코드를 표시하고 터미널이 입력을 요구하는 경우에만, 그 코드를 해당 로그인용 터미널에 붙여 넣고 Enter를 누르십시오. 비밀번호·인증 코드·로그인 주소를 채팅, 원고, 고객지원 메시지에 보내지 마십시오. 코드 입력 없이 완료되는 버전도 있습니다. Google의 로그인 절차
승인한 뒤에는 위크로 돌아와 연결 상태가 바뀌었는지 확인하십시오. 브라우저에서 승인 버튼을 눌렀다는 사실만으로 위크 연결까지 완료됐다고 판단하지 마십시오.
6 모델 목록 새로 확인하기
- 채팅 입력창 아래에서 현재 AI와 모델 이름이 표시된 버튼을 누릅니다.
- 모델 메뉴에서 Gemini 항목을 펼칩니다.
- 하단의 새로고침을 누릅니다.
- 목록을 다시 확인합니다. 아르곤을 찾는다면 검색창에
argon을 입력합니다.
Gemini 항목을 펼친 뒤 새로고침을 눌러야 Gemini 목록을 조회합니다. Codex나 Claude 항목을 펼친 상태에서는 그 AI의 목록을 갱신합니다. 목록 전체를 다시 보려면 검색창의 입력을 지우십시오.
위크는 연결 도구에서 받은 Gemini 목록을 사용합니다. 인터넷에 공개된 모든 Gemini 모델을 그대로 나열하거나, 계정에 없는 모델을 만들어서 표시하지 않습니다. 일반 조회에는 짧은 캐시가 있지만, 메뉴의 새로고침은 캐시를 우회해 다시 확인합니다. 이미 조회 중이라면 해당 조회가 끝날 때까지 기다리십시오.
아르곤이 없는 경우
다음 순서로 확인하십시오.
- Google 승인 화면에서 구독이 등록된 계정을 선택했는지 확인합니다.
- Google AI Pro·Ultra 중 본인의 구독과 Antigravity의 제공 조건을 확인합니다.
- 공식 연결 도구의 설치·업데이트 상태를 확인합니다.
- 위크를 다시 열어 Gemini → 새로고침을 누르고 검색어도 확인합니다.
- 그래도 없으면 현재 모델 목록과 일반 오류 문구를 고객지원에 알려 확인을 요청합니다.
목록에 없다는 사실만으로 계정 등급, 출시 반영 시점, 연결 도구 버전 중 어느 하나가 원인이라고 단정할 수는 없습니다. 제공 조건을 확인하기 전에 유료 API로 바꾸거나 구독을 추가하지 마십시오.
PowerShell의 agy models로도 공식 도구의 목록을 확인할 수 있습니다. 다만 일반 터미널의 연결 설정과 위크 전용 설정은 다를 수 있으므로, 그 결과를 위크 목록과 동일하다고 단정하지 마십시오. 위크에서 사용할 목록은 위크의 Gemini → 새로고침 결과를 기준으로 확인합니다. Google의 모델 조회 안내
7 사용할 모델 선택하기
Gemini 목록에서 사용할 모델을 직접 누르십시오. 입력창 아래의 모델 이름과 현재 작성 AI가 Gemini로 바뀌었는지 확인합니다. 연결만 했다고 작성 AI가 자동으로 Gemini로 바뀌지는 않습니다.
작업별 자동을 선택하면 위크가 현재 목록 안에서 작업에 맞는 모델을 고릅니다. 이는 무조건 가장 최신 모델을 고른다는 뜻이 아닙니다. 특정 모델로 작성하려면 그 항목을 직접 선택하십시오.
추론 강도를 조절할 수 있는 항목에서는 위크에 표시되는 선택지를 사용합니다. 모델 이름 자체에 High·Medium·Low가 포함되어 있을 수도 있으므로, API 모델 이름과 같다고 보고 임의의 이름이나 강도를 입력하지 마십시오.
목록에 모델이 나타나는 것은 목록 조회 확인입니다. 해당 모델의 실제 응답이 완료되는지는 실행 과정에서 확인해야 합니다.
8 실제 응답 확인하기
실제 AI 요청은 연결한 서비스의 사용 한도를 소비할 수 있습니다. 연결 상태만 확인하려면 여기서 멈춰도 됩니다.
응답을 시험하려면 원본 책 대신 새 시험용 책을 만들고, Gemini와 모델을 선택한 뒤 짧은 확인 요청을 보냅니다. 예를 들어 다음처럼 요청할 수 있습니다.
원고를 작성하거나 수정하지 말고, 연결 확인용으로 짧게 답해 주세요.
답변이 완료됐는지, 현재 작성 AI가 Gemini였는지, 오류가 없는지 확인하십시오. 모델 목록 확인됨 · 실행 확인 전은 집필 성공을 뜻하지 않습니다. 실제 응답을 확인한 뒤에 기존 책의 작업을 이어가십시오.
연결 시험에서 계속해, 집필해, 오토모드 재개처럼 원고 작업을 시작하는 요청은 사용하지 마십시오. 기존 책의 단계 확정이나 윤문 지침 승인도 연결 시험과 별개입니다.
9 연결이 잘 되지 않을 때
로그인 창이 열리지 않는 경우
이미 연결되어 연결 확인으로 표시된다면 먼저 모델 목록을 확인하십시오. 새 로그인 창이 열리지 않아도 정상일 수 있습니다.
처음 연결하는데 창이 없다면 AI 연결 창의 안내 문구를 확인합니다. 공식 CLI 설치가 필요하다는 안내이면 2단계로 돌아갑니다. 연결 상태 새로 확인을 한 번 누르고 결과를 기다리십시오. 연결 버튼을 연속해서 누르면 같은 로그인 요청을 여러 번 시작하려 할 수 있습니다.
브라우저를 열지 못했다는 안내가 있다면, 열린 공식 로그인용 터미널의 안내를 확인하십시오. 주소를 직접 열어야 하는 상황에서는 출처가 Google의 공식 로그인 화면인지 확인해야 합니다. 주소 전체나 코드가 포함된 화면을 고객지원에 그대로 보내지 마십시오. 인증서 경고나 낯선 권한 요구가 나오면 진행을 멈춥니다.
브라우저에서는 승인했는데 위크에 반영되지 않는 경우
코드 입력을 요구했다면 로그인용 터미널에도 입력을 완료했는지 확인합니다. 위크의 AI 연결 → 연결 상태 새로 확인을 누르고, 모델 메뉴에서도 Gemini → 새로고침을 누르십시오.
반복해서 실패한다면 일반 오류 문구와 연결 도구 버전을 기록해 문의하십시오. 설정 파일이나 인증 파일을 삭제해서 해결하려고 하지 마십시오. 원고나 기존 연결을 잃을 수 있습니다.
모델 목록은 있지만 실행하지 못하는 경우
일반 오류가 인증 문제인지, 사용 한도인지, 선택한 모델의 제공 문제인지 구별하십시오. 인증 안내는 Gemini의 Google 연결을, 사용 한도 안내는 공식 서비스의 한도를 확인해야 합니다. 모델 오류이면 Gemini 목록을 새로 확인하고 선택을 대조합니다.
위크의 이용 기간 오류를 Gemini 로그인 문제로 처리하거나, 반대로 Gemini 연결 오류를 위크 쿠폰 등록으로 해결하려고 하지 마십시오. 위크는 이 연결 경로에서 별도 API 요금제로 자동 전환하지 않습니다.
일반 터미널에서는 되는데 위크에서는 안 되는 경우
두 프로그램의 연결 설정이 다를 수 있습니다. 위크의 Google 계정 연결 또는 연결 확인에서 확인하고, 일반 터미널의 인증 파일을 위크 폴더에 복사하지 마십시오.
10 문의할 때 준비할 정보
다음 정보만 정리하면 문제를 구분하는 데 도움이 됩니다.
- 위크 버전
agy --version으로 확인한 연결 도구 버전- 본인이 확인한 Google AI 구독 종류
- 위크의 Gemini 모델 목록
- 일반 오류 문구와 문제가 생긴 시각
- 로그인 창이 안 열린 것인지, 승인 후 반영이 안 된 것인지, 실행이 실패한 것인지
비밀번호·인증 코드·API 키·로그인 주소의 긴 매개변수·인증 파일은 보내지 마십시오. 화면을 첨부한다면 계정 주소와 인증 코드가 보이는 부분도 먼저 가리십시오.
문의 주소는 wcentury@week.ai.kr입니다.
완료 확인
- 위크의 이용 기간을 확인했다.
- Antigravity CLI 설치를 확인했다.
- 위크의 Gemini 연결에서 사용할 Google 계정을 확인했다.
- Gemini 항목을 펼쳐 모델 목록을 새로 확인했다.
- 실제 사용할 작성 AI와 모델을 선택했다.
- 실행까지 시험했다면 응답 완료 여부를 따로 확인했다.
목록 조회만 마쳤다면 연결 목록 확인, 응답까지 마쳤다면 실제 응답 확인으로 구분해 두십시오. 원본 책의 집필 재개와 단계 확정은 그다음에 진행합니다.
