제미나이 CLI 설치 윈도우 초보용: 지금은 안티그래비티 CLI, 터미널 열기부터 첫 부탁까지

이 글 순서

1. 이게 뭔가요
2. 처음이라면: 준비물
3. 1단계 터미널 열기
4. 2단계 설치 명령
5. 3단계 설치 확인
6. 4단계 폴더에서 실행
7. 5단계 로그인
8. 6단계 첫 실행 설정
9. 7단계 첫 요청
10. 막혔을 때
11. 익숙해졌다면: 명령
12. 남은 양 보기
13. 더 깊이: 설정 파일
14. 지침 파일과 권한
15. 제미나이 CLI 는 누가
16. 클로드 코드·코덱스는
17. 한국에서 되나
18. 누구에게 맞을까
19. 참고한 자료

“제미나이 CLI 설치”를 찾아 따라 했는데 구글 로그인에서 막혔다면, 따라 한 글이 오래된 거예요. 구글은 2026년 6월 18일에 개인 계정 쪽 길을 닫고 그 자리를 안티그래비티(Antigravity) CLI 로 옮겼어요. 지금 개인이 처음 깔 도구는 안티그래비티 CLI 이고, 실행 명령은 agy 예요.

구글 개발자 블로그와 Gemini Code Assist 공지, 안티그래비티 문서, 제미나이 CLI 문서를 2026년 10월 8일에 다시 읽고 윈도우 기준으로 순서를 적었어요. 명령과 메뉴 이름은 문서의 영어 그대로예요. 터미널 그림 아홉 장은 이 PC 에서 돌린 출력을 옮긴 것인데, 설치 스크립트는 돌리지 않고 글만 읽었고, 실행 파일은 테스트 폴더에 따로 받아 버전과 도움말만 돌려 봤어요. 로그인부터의 화면은 문서에 적힌 글로만 옮겼어요. 처음이라면 7단계까지만 따라 하면 되고, 그 아래는 익숙해진 뒤에 읽어도 돼요.

이게 뭔가요

안티그래비티 CLI 는 구글이 만든 AI 코딩 도구예요. 제미나이 앱은 내가 붙여 넣은 글만 보지만, 이 도구는 내가 열어 준 폴더 안의 파일을 직접 읽고, 고치고, 필요한 명령을 대신 돌려요. 문서는 이렇게 스스로 여러 단계를 밟아 일하는 프로그램을 에이전트(agent)라고 불러요.

낯선 단어 세 개만 먼저 풀게요. 터미널은 마우스 대신 글자로 컴퓨터에 일을 시키는 창이에요. 윈도우에서는 PowerShell 이 그 창이에요. CLI 는 Command Line Interface 의 줄임말로, 그 창에서 글자로 쓰는 프로그램을 뜻해요. 문서에 자주 나오는 TUI 는 Terminal User Interface, 곧 터미널 창 안에 그려지는 화면이에요. agy 를 치면 뜨는 화면이 TUI 예요.

이름이 여럿이라 헷갈리기 쉬워요. 안티그래비티는 구글의 에이전트 개발 도구 묶음 이름이고, 그 안에 창과 버튼으로 쓰는 데스크톱 앱 안티그래비티 2.0, 터미널에서 쓰는 안티그래비티 CLI 가 있어요. 문서는 둘이 같은 에이전트 기반을 쓰고 설정도 서로 맞춰진다고 적었어요. 터미널이 영 부담스럽다면 데스크톱 앱이 다른 방법이에요. 이 글은 터미널 쪽만 다뤄요.

개발자만 쓰는 도구는 아니에요. 폴더에 쌓인 파일 이름을 규칙대로 바꾸거나, CSV 파일 여러 개를 하나로 묶거나, 텍스트 파일의 맞춤법을 고쳐 새 파일로 남기는 일도 말로 시킬 수 있어요. 코드를 배우는 분이라면 오류 글을 읽혀서 이유를 묻는 데 쓰기 좋아요.

예전 이름인 제미나이 CLI 를 지금도 쓸 수 있는 분이 누구인지는 아래 “제미나이 CLI 는 누가” 절에 따로 적었어요. 개인 구글 계정이라면 그대로 다음 단계로 가면 돼요.

처음이라면: 준비물

깔기 전에 세 가지를 봐요. 계정, 윈도우, 그리고 요금제예요.

항목	문서에 적힌 것	근거
계정	개인 구글 계정	FAQ
나이	만 18세 이상	FAQ
나라	목록에 있는 나라(한국 포함)	FAQ
요금제	없어도 됨(개인용 월 0달러)	가격 페이지
운영체제	macOS·Linux·Googlebook·Windows	설치 문서
윈도우 칩	x64(AMD64) 또는 ARM64	설치 스크립트
윈도우 버전 숫자	CLI 문서에 없음	공식 안내 없음
Node.js	설치 문서에 조건 없음	설치 문서

출처: 안티그래비티 문서 FAQ·Installation and auth, antigravity.google 가격 페이지, 설치 스크립트 install.ps1. 10월 8일 확인.

회사나 학교에서 받은 구글 계정(Google Workspace)으로는 로그인이 안 될 수 있어요. FAQ 는 그럴 때 @gmail.com 주소로 해 보라고 적었어요. 회사에서 쓰려면 Google Cloud 쪽 방법이 따로 있어요.

윈도우 버전 숫자는 조금 애매해요. 데스크톱 앱 안티그래비티 2.0 의 다운로드 표에는 “Windows 10 (64-bit)” 이라고 적혀 있는데, CLI 설치 문서에는 윈도우 몇 이상이라는 말이 없어요. 설치 스크립트가 보는 것은 칩 종류뿐이에요. x64(AMD64)나 ARM64 가 아니면 “Unsupported CPU architecture” 를 내고 멈춰요. 내 PC 가 어느 쪽인지는 PowerShell 에서 볼 수 있어요.

둘째 줄의 $env:PROCESSOR_ARCHITECTURE 는 윈도우가 적어 둔 칩 종류를 읽어 오는 명령이에요. AMD64 나 ARM64 가 나오면 돼요. 이렇게 프로그램이 읽어 가는 이름이 붙은 설정값을 환경 변수라고 불러요.

1단계 터미널 열기

설치 문서는 “PowerShell 을 열고” 설치 명령을 돌리라고 적었어요. 여는 법은 이래요.

1. 키보드의 윈도우 키를 누르고 powershell 이라고 쳐요.
2. 목록에 뜬 Windows PowerShell 을 눌러요.
3. 파란색이나 검은색 창이 뜨고 PS C:\Users\사용자이름> 같은 줄이 보이면 맞아요.

맨 앞의 PS 가 PowerShell 이라는 표시이고, 그 뒤 C:\Users\사용자이름 은 지금 서 있는 폴더예요. 폴더 위치를 글자로 적은 것을 경로라고 불러요. 이 줄 끝에 명령을 치고 Enter 를 누르면 실행돼요. 줄 앞에 PS 없이 C:\ 만 보이면 명령 프롬프트(CMD)라는 다른 창이에요. 그 창에는 다른 설치 명령을 써야 하니 닫고 PowerShell 을 다시 여세요.

2단계 설치 명령

문서에 나온 방법은 설치 스크립트 하나예요. 스크립트는 여러 명령을 한 파일에 적어 둔 것이고, 아래 한 줄이 그 파일을 받아서 돌려요.

irm https://antigravity.google/cli/install.ps1 | iex

이 줄이 하는 일은 두 부분이에요. irm 이 antigravity.google 에서 설치 스크립트를 다운로드하고, 가운데 파이프(|)가 그것을 iex 에 넘기고, iex 가 실행해요. 복사해서 PowerShell 창에 마우스 오른쪽 버튼으로 붙이고 Enter 를 누르면 돼요. Node.js 나 npm 은 필요 없어요.

인터넷에서 받은 스크립트를 바로 돌리는 게 꺼림칙하면 먼저 읽어 볼 수 있어요. 아래 그림은 iex 로 넘기지 않고, 받은 글에서 세 군데만 골라 본 것이에요.

스크립트 글을 처음부터 끝까지 읽어 보면 하는 일은 다섯 가지예요.

1. 칩 종류를 봐요. AMD64 나 ARM64 가 아니면 멈춰요.
2. 지금 버전의 번호, 다운로드할 주소, 파일 해시(sha512)이 적힌 목록을 받아요.
3. 실행 파일 agy.exe 를 임시 자리에 받고 해시를 맞춰 봐요. 다르면 “Security Halt: Checksum verification failed.” 를 내고 멈춰요.
4. agy.exe 를 C:\Users\사용자이름\AppData\Local\agy\bin 에 놓아요.
5. 방금 놓은 agy.exe 에게 install 을 시켜요. 도움말에는 이 명령이 “Configure environment paths and shell settings”, 곧 PATH 와 셸 설정을 맞추는 일이라고 적혀 있어요.

PATH 는 윈도우가 명령 이름을 찾아보는 폴더 목록이에요. 여기에 agy 폴더가 들어가야 어느 폴더에서든 agy 라고만 쳐도 실행돼요. 셸은 터미널 안에서 명령을 받아 돌리는 프로그램이고, 윈도우에서는 PowerShell 이 셸이에요.

3번의 해시 맞추기는 손으로도 해 볼 수 있어요. 아래 그림은 스크립트가 받는 것과 같은 파일을 테스트 폴더에 받아 확인한 출력이에요.

10월 8일에 받은 버전은 1.3.1 이었고, 파일 크기는 181MB, 해시는 목록과 같았고, 파일에 붙은 전자 서명은 Google LLC 였어요. 스크립트 글에는 성공했다는 안내 글이 따로 없으니, 잘 깔렸는지는 다음 3단계에서 확인해요.

이미 깔려 있는 PC 에서 같은 줄을 다시 돌리면 새로 깔지 않아요. 스크립트는 “Notice: ‘agy.exe’ is already installed at …” 과 “The Antigravity CLI automatically self-updates in the background.” 를 보여 주고 끝나요. 안티그래비티 CLI 는 뒤에서 알아서 새 버전으로 올라가고, 새로 깔고 싶으면 그 파일을 먼저 지우라는 안내예요.

3단계 설치 확인

잘 깔렸는지는 버전 번호를 물어보면 알아요. PowerShell 창을 새로 하나 열고 이렇게 쳐요.

agy --version

안티그래비티 CLI 가 자기 버전 번호를 한 줄로 답하는 명령이에요.

숫자만 한 줄 나오면 맞아요. 그림은 테스트 폴더에 받은 파일이라 앞에 .\ 와 .exe 를 붙였고, 설치 스크립트로 깔았다면 agy --version 만 치면 돼요.

agy 라는 이름을 찾을 수 없다는 빨간 글이 나오면 대개 설치 전에 열어 둔 창이라서예요. PATH 는 창이 열릴 때 읽어 오니, 창을 닫고 새로 열어 다시 쳐 보세요. 그래도 안 되면 아래 “막혔을 때” 절을 보세요.

무슨 명령이 있는지는 agy --help 로 볼 수 있어요.

처음에는 셋만 알아도 돼요. update 는 새 버전으로 올리기, changelog 는 버전마다 바뀐 점 보기, models 는 고를 수 있는 모델 목록이에요. 모델은 답을 만드는 AI 의 종류예요. install 은 2단계에서 스크립트가 대신 불러 준 그 명령이에요.

4단계 폴더에서 실행

안티그래비티 CLI 는 실행한 폴더를 작업 폴더로 삼아요. 지난 대화도 폴더마다 따로 모아 둔다고 문서에 나와 있어요. 그래서 아무 데서나 켜지 말고 연습용 폴더를 하나 만들어 그 안에서 켜는 게 좋아요.

mkdir agy-test
cd agy-test
agy

첫 줄은 agy-test 라는 새 폴더를 만들고, 둘째 줄은 그 폴더 안으로 들어가고, 셋째 줄이 안티그래비티 CLI 를 켜요. 문서의 튜토리얼은 mkdir agy-demo && cd agy-demo 처럼 두 명령을 한 줄에 이어 적었는데, 윈도우에 기본으로 든 PowerShell 5.1 은 && 를 알아듣지 못하니 위처럼 한 줄씩 치는 편이 안전해요.

내 문서 폴더 통째로나 사진이 몽땅 든 폴더처럼 잃으면 곤란한 곳에서 바로 켜지는 마세요. 연습은 복사본을 넣은 폴더에서 하는 편이 마음 편해요.

5단계 로그인

agy 를 처음 실행하면 저장된 로그인이 없으니 웹 브라우저가 자동으로 열려요. 문서의 설명은 짧아요.

1. agy 를 실행해요. 기본 웹 브라우저가 열려요.
2. 브라우저에서 개인 구글 계정으로 로그인해요.
3. 터미널 창으로 돌아와요.

로그인 정보는 윈도우의 자격 증명 관리자(Windows Credential Manager)에 들어가요. 운영체제가 비밀번호 같은 것을 맡아 두는 금고예요. 다음부터는 agy 를 쳐도 브라우저가 열리지 않고 바로 들어가요. 로그아웃은 입력 칸에 /logout 을 쳐요.

알아 둘 것이 하나 있어요. FAQ 는 안티그래비티 로그인을 클로드 코드, OpenClaw, OpenCode 같은 다른 회사 도구에 연동해 쓰는 것을 약관 위반이라고 적었고, 계정이 정지되거나 해지될 수 있다고 했어요. 안티그래비티 로그인은 안티그래비티에서만 쓰세요.

6단계 첫 실행 설정

처음 켜면 짧은 설정을 세 가지 물어봐요. 로그인과 어느 쪽이 먼저 뜨는지는 문서에 적혀 있지 않아요.

묻는 것	뜻	처음엔
Color scheme	화면 색 묶음	보기 편한 것
Rendering mode	화면을 그리는 방식	아무거나, 나중에 바꿈
Workspace trust	이 폴더를 믿는지	연습 폴더면 믿음

출처: 안티그래비티 문서 Getting started. 10월 8일 확인. “처음엔” 칸은 제 의견이에요.

Rendering mode 의 Alt-Screen 은 터미널 창 전체를 따로 쓰는 방식이고, Inline 은 앞서 친 명령들 아래로 이어서 흘러가는 방식이에요. 셋 다 나중에 /config 에서 바꿀 수 있어요. Workspace trust 에서 믿는다고 하면 에이전트가 폴더 안의 파일을 훑어보고 준비를 마친다고 문서에 나와 있어요. 그러니 남에게 받은 낯선 폴더에서는 바로 믿는다고 하지 마세요.

7단계 첫 요청

화면 맨 아래에 > 로 시작하는 입력 칸이 있어요. 거기에 하고 싶은 일을 적고 Enter 를 누르면 돼요. AI 에게 적어 보내는 이 글을 프롬프트라고 불러요. 문서가 든 첫 요청은 이 한 줄이에요.

Write a simple python script to fetch web page text

웹 페이지의 글을 가져오는 짧은 파이썬 프로그램을 써 달라는 뜻이에요. 문서의 튜토리얼은 이 요청을 끝까지 따라가요.

1. 요청을 보내면 에이전트가 폴더를 읽고 계획을 세워요. 하는 일이 화면에 줄줄이 보여요.
2. 파일을 다 만들면 알림이 떠요. Ctrl+R 을 누르면 만든 것을 살펴보는 Artifact Review 화면이 열려요.
3. 위아래 화살표로 main.py 를 고르고 내용을 읽어요. 괜찮으면 Y 로 승인하고 Esc 로 닫아요.
4. “Run the python script and show me the output” 이라고 보내면 에이전트가 실행할 명령을 내밀어요. Y 를 누르면 돌리고 결과를 보여 줘요.

파이썬이 깔려 있지 않은 PC 라면 4번에서 막힐 수 있어요. 처음에는 파일을 바꾸지 않는 요청이 마음 편해요. 한국어로 적어도 돼요. 아래는 요청을 적는 예시예요.

• 둘러보기: “이 폴더에 뭐가 있는지 설명해 줘. 아무것도 바꾸지는 마.”
• 파일 이름 바꾸기: “이 폴더의 사진 파일 이름을 날짜순으로 001 부터 붙여 줘. 바꾸기 전에 바꿀 목록부터 보여 줘.”
• CSV 묶기: “sales 로 시작하는 CSV 세 개를 한 파일로 합치고, 첫 줄 제목은 한 번만 남겨 줘.”
• 글 고치기: “report.txt 의 맞춤법을 고쳐서 report-fixed.txt 로 따로 저장해 줘. 원본은 그대로 둬.”
• 오류 읽기: “방금 난 오류가 무슨 뜻인지 설명하고, 고칠 곳을 알려 줘. 아직 고치지는 마.”

기본 설정에서는 파일을 만들거나 고치기 전에 멈추고 물어봐요. 문서에 실린 예시는 “Allow create this file? [y/n/f]” 예요. y 는 허락, n 은 거절, f 는 바뀌는 곳을 화면 가득 펼쳐 보기예요. 에이전트가 엉뚱한 길로 가면 Esc 를 누르면 바로 멈춰요.

나갈 때는 /exit 를 치거나 입력 칸이 빈 상태에서 Ctrl+D 를 눌러요. 문서에 따르면 나갈 때 이 대화를 이어 하는 명령을 화면에 적어 줘요. 여기까지 됐으면 설치는 끝이에요.

막혔을 때

문서의 Troubleshooting 과 FAQ, 설치 스크립트 글에서 설치와 로그인에 걸리는 것만 골랐어요.

이럴 때	문서·스크립트에 적힌 것
agy 를 못 찾는다고 나옴	새 창을 열기, 그래도 안 되면 PATH 에 설치 폴더 넣기
Unsupported CPU architecture	x64·ARM64 가 아닌 PC, 깔 수 없음
Security Halt: Checksum…	받은 파일이 깨졌거나 바뀜, 다시 받기
Failed to download…	네트워크나 DNS 문제인지 확인
already installed 안내	이미 깔려 있음, 알아서 올라감
회사·학교 계정 로그인 안 됨	@gmail.com 주소로
age unverified	만 18세 이상이면 나이 확인
update.lock 경고	잠금 파일 지우기 또는 자동 업데이트 끄기

출처: 안티그래비티 문서 Troubleshooting·FAQ, 설치 스크립트 install.ps1. 10월 8일 확인.

PATH 쪽은 문서끼리 폴더가 달라요. 설치 문서와 설치 스크립트는 agy.exe 를 C:\Users\사용자이름\AppData\Local\agy\bin 에 놓는다고 했는데, Troubleshooting 문서의 PowerShell 예시는 C:\Program Files\Google\antigravity-cli 를 PATH 에 더해요. 예시를 그대로 붙이지 말고, agy.exe 가 실제로 놓인 폴더를 먼저 확인하세요. 스크립트 글 기준으로는 AppData\Local\agy\bin 이고, 아래 줄로 물어볼 수 있어요.

Test-Path "$env:LOCALAPPDATA\agy\bin\agy.exe"

그 자리에 agy.exe 파일이 있는지만 묻는 명령이에요. True 가 나오면 파일은 제자리에 있고 PATH 만 빠진 것이고, False 면 설치가 끝까지 가지 못한 거예요.

보안 저장소(keyring) 오류와 update.lock 은 문서의 해결 방법이 macOS 와 Linux 명령으로만 적혀 있어요. 윈도우에서 자격 증명 관리자 쪽을 어떻게 푸는지는 문서에 없어요(공식 안내 없음). 자동 업데이트가 말썽이면 환경 변수 AGY_CLI_DISABLE_AUTO_UPDATE 를 true 로 두면 꺼진다고 적혀 있어요.

익숙해졌다면: 명령

여기부터는 며칠 써 본 뒤에 봐도 돼요. 입력 칸에서 / 를 치면 명령 목록이 떠요. 슬래시 명령이라고 부르고, 자주 쓰는 건 몇 개 안 돼요.

명령·키	하는 일
/model	모델 바꾸기(다음에도 남음)
/usage, /quota	모델별 한도 쓴 양 보기
/config, /settings	설정 화면 열기
/clear, /new	새 대화로 시작
/resume	지난 대화 골라 이어 하기
/rewind, /undo	대화를 앞 지점으로 되돌리기
/permissions	허락 규칙 보기·고치기
/logout	로그아웃
/exit, /quit	나가기
@	폴더 안 파일을 골라 요청에 넣기
!	맨 앞에 붙이면 터미널 명령을 바로 실행
Shift+Enter	보내지 않고 줄 바꾸기

출처: 안티그래비티 문서 CLI reference·Using Antigravity CLI·Prompting and interaction. 10월 8일 확인.

어제 하던 일을 이어 하고 싶으면 그 폴더에서 이렇게 켜요.

agy -c

이 폴더에서 가장 최근에 하던 대화를 바로 다시 여는 명령이에요. -c 는 --continue 의 줄임이에요.

매번 물어보는 게 번거로워지면 실행 모드를 바꿀 수 있어요. 입력 칸에서 Shift+Tab 을 누를 때마다 default → accept-edits → plan 순서로 돌아요.

default 는 파일을 건드리기 전마다 묻고, accept-edits 는 파일 고치기를 묻지 않고, plan 은 고치기 전에 계획부터 내놓아요. 문서는 셸 명령을 돌리는 일은 어느 모드에서든 허락 규칙(/permissions)을 따른다고 덧붙였어요. 처음 한동안은 default 로 두고 무엇을 고치는지 눈으로 보는 쪽을 권해요.

남은 양 보기

안티그래비티 CLI 는 요금제가 없어도 쓸 수 있고, Google AI Pro·Ultra 를 내면 한도가 늘어요. 한도가 초기화되는 시점은 요금제마다 달라요.

요금제	초기화 시점	요청 수 숫자
요금제 없음·AI Plus	주 단위	공개 안 됨
Google AI Pro	5시간마다, 주간 한도까지	공개 안 됨
Google AI Ultra	5시간마다	공개 안 됨

출처: 안티그래비티 문서 Plans·Models. 10월 8일 확인.

숫자가 없는 이유도 문서에 있어요. 한도는 요청 수가 아니라 에이전트가 한 일의 양에 따라 빠져서, 쉬운 일은 더 많이 시킬 수 있고 복잡한 일은 빨리 닳는다고 해요. 그래서 남은 양은 직접 보는 수밖에 없어요. 입력 칸에 /usage 를 치면 돼요.

문서에 실린 예시 화면에는 Gemini 모델 묶음과 Claude·GPT 모델 묶음이 따로 나오고, 묶음마다 남은 비율과 다시 찰 때까지 남은 시간이 적혀 있어요. 이 문서 글에는 “Gemini 3.5 Flash” 라는 이름이 예로 들어 있는데, 요금제별 모델 표(Models 문서)에 지금 올라 있는 것은 Gemini 3.8·3.7·3.6 Flash 와 Gemini 3.1 Pro 예요. 모델 이름은 Models 문서 쪽을 따르세요.

요금제별 값, 고를 수 있는 모델, AI 크레딧으로 이어 쓰는 설정은 안티그래비티 CLI 요금제별 한도 글에 표로 있어요. 제미나이 CLI 를 쓰던 분이 옛 설정을 옮기는 법도 그 글에 있어요. 제미나이 앱 쪽 한도는 제미나이 사용량 한도 확인 글에서 다뤘어요.

더 깊이: 설정 파일

매번 고르던 것을 파일에 적어 두면 켜질 때마다 그대로 따라요. 문서에 적힌 설정 파일 위치는 ~/.gemini/antigravity-cli/settings.json 이에요. 맨 앞의 ~ 는 홈 폴더를 뜻하는 표시이고, 윈도우에서는 보통 C:\Users\사용자이름 이에요. 윈도우 경로를 따로 적은 문장은 문서에 없어요.

{
  "toolPermission": "request-review",
  "enableTerminalSandbox": false,
  "agentMode": "default"
}

첫 줄은 언제 물어볼지, 둘째 줄은 명령을 샌드박스 안에서만 돌릴지, 셋째 줄은 켤 때의 실행 모드예요. 셋 다 문서에 적힌 기본값 그대로라서, 이 파일이 없어도 똑같이 움직여요. 이런 형식의 설정 글을 JSON 이라고 부르고, 쉼표나 따옴표 하나가 빠지면 읽지 못하니 처음에는 /config 화면에서 바꾸는 편이 안전해요.

설정 이름	기본값	뜻
toolPermission	request-review	쓰기·명령·웹 도구 앞에서 확인을 받음
artifactReviewPolicy	asks-for-review	코드를 쓰기 전에 늘 확인을 받음
enableTerminalSandbox	false	명령을 샌드박스 안에서만 실행
allowNonWorkspaceAccess	false	작업 폴더 밖 파일 읽기·쓰기
useG1Credits	false	한도를 다 쓰면 AI 크레딧 사용
enableTelemetry	true	사용 통계·오류 기록 보내기

출처: 안티그래비티 문서 CLI reference 의 Configuration keys. 10월 8일 확인.

기본값이 문서와 프로그램에서 다른 곳도 있어요. CLI reference 표는 verbosity(화면에 얼마나 자세히 보여 줄지)의 기본값을 “high” 로 적었는데, 프로그램에 든 바뀐 점 기록은 1.3.0 에서 기본값을 high 에서 medium 으로 바꿨다고 적었어요.

한 번만 다르게 켜고 싶을 때는 옵션을 붙여요.

agy --mode=plan

이번 실행만 plan 모드로 켜는 명령이에요. 도움말에 적힌 --mode 의 값은 accept-edits 와 plan 둘이에요. --sandbox 는 명령을 샌드박스 안에서만 돌리게 켜고, -p “질문” 은 화면을 열지 않고 한 번 묻고 답만 받고 끝나요. --dangerously-skip-permissions 는 모든 권한 확인 창을 건너뛰는 옵션이에요. 이름에 dangerously 가 붙은 그대로이니 내 PC 에서는 쓰지 않는 쪽이 맞아요.

지침 파일과 권한

폴더마다 “이 폴더에서는 이렇게 해 줘”를 적어 두는 파일이 있어요. 안티그래비티는 이것을 규칙(rules)이라고 부르고, 폴더 맨 위에 GEMINI.md 나 AGENTS.md 라는 이름으로 두면 켤 때 알아서 읽어요. .md 는 마크다운이라는 간단한 텍스트 파일 형식이에요.

# 이 폴더의 규칙
- 답은 한국어로.
- 원본 파일은 고치지 말고 새 파일로 저장.
- 파일을 지우기 전에 꼭 먼저 물어보기.

위는 GEMINI.md 에 적어 둘 만한 예시예요. 대화가 바뀌어도 남는 약속이라, 같은 말을 매번 반복하지 않아도 돼요. 문서에 따르면 모든 폴더에 두루 쓸 규칙은 ~/.gemini/GEMINI.md 에 두고, 폴더 규칙과 전역 규칙은 서로 지우지 않고 더해져요.

권한은 두 군데서 다뤄요. 큰 틀은 toolPermission 이고, 세세한 규칙은 /permissions 예요.

toolPermission 값	문서의 설명
request-review(기본)	쓰기·셸 명령·웹 도구 앞에서 확인을 받음
proceed-in-sandbox	샌드박스 안에서는 알아서 진행
strict	읽기가 아닌 모든 일에 확인을 받음
always-proceed	묻지 않음

출처: 안티그래비티 문서 CLI reference·Best practices. 10월 8일 확인.

샌드박스(sandbox)는 에이전트가 돌리는 명령이 손댈 수 있는 범위를 정해 두는 장치예요. /permissions 를 치면 규칙을 보고 고치는 화면이 열리고, 규칙은 action(target) 형식으로 적어요. 문서의 예는 command(git) 예요. git 으로 시작하는 명령은 묻지 않고 돌려도 된다는 뜻이에요. 규칙을 둘 자리는 이 프로젝트만(Project), 안티그래비티 제품 전체(Shared), 내 모든 대화(Global) 셋 가운데 골라요.

윈도우에서 헷갈리기 쉬운 부분이 있어요. Agent permissions 문서와 Terminal sandbox 문서에는 “새 권한 체계는 지금 macOS 와 Linux 에서만 되고, 윈도우는 예전 방식을 그대로 쓴다”는 알림이 있는데, 이 알림은 Antigravity 2.0(데스크톱 앱) 탭에만 있고 CLI 탭을 고르면 사라져요(10월 8일 탭을 바꿔 가며 확인). CLI 의 권한은 위의 settings.json 값과 /permissions 를 기준으로 보세요. 윈도우 샌드박스는 기본으로 꺼져 있고, 1.2.17 에서 관리자 권한 없이 돌게 고쳤다는 기록이 프로그램의 바뀐 점에 있어요.

더 해 볼 만한 것들은 이래요.

• API 키로 쓰기: API 는 프로그램이 다른 회사 서비스를 불러 쓰는 창구이고, API 키는 그 창구에서 쓰는 비밀번호 같은 글자예요. settings.json 에 “modelProvider”: “gemini” 를 넣고 환경 변수 GEMINI_API_KEY 에 키를 넣으면 계정 로그인 없이 Gemini API 로 바로 가요. 문서의 예는 export 로 시작하는 맥·리눅스 형식뿐이에요. PowerShell 형식($env:GEMINI_API_KEY=”…”)은 제미나이 CLI 문서에만 나와요.
• 자동으로 돌리기: agy -p “질문” --output-format json 처럼 쓰면 답을 프로그램이 읽기 쉬운 형식으로 받아요. 문서는 이것을 headless 모드라고 불러요.
• MCP 붙이기: MCP 는 Model Context Protocol 의 줄임말로, 에이전트에 바깥 도구를 붙이는 규격이에요. /mcp 나 agy mcp 로 다뤄요.
• 옛 제미나이 CLI 설정 옮기기: 처음 켤 때 한 번 가져오기를 물어봐요. 자세한 순서는 위에 링크한 글에 있어요.

제미나이 CLI 는 누가

제미나이 CLI 가 없어진 건 아니에요. 로그인하는 방법에 따라 달라요. 구글 공지는 2026년 6월 18일부터 개인용 Gemini Code Assist, Google AI Pro, Google AI Ultra 등급의 요청을 받지 않고, 제미나이 CLI 에서 “Login with Google” 을 더는 쓸 수 없다고 적었어요.

로그인 방법	6월 18일 뒤	근거
개인 구글 계정(무료)	안 됨	구글 공지·블로그
Google AI Pro·Ultra	안 됨	구글 공지·블로그
회사 Code Assist Standard·Enterprise	그대로	구글 공지 FAQ
유료 Gemini API 키	그대로	구글 블로그
유료 Gemini Enterprise Agent Platform API 키	그대로	구글 블로그
무료 Gemini API 키	미확인	문서끼리 다름
Workspace AI Ultra	미확인	문서끼리 다름

출처: 구글 개발자 블로그(5월 19일), Gemini Code Assist 공지(9월 2일 수정), 제미나이 CLI Quotas and pricing 문서(6월 18일 수정). 10월 8일 확인.

미확인 두 줄은 문서끼리 말이 달라서예요. 제미나이 CLI 의 Quotas and pricing 문서는 맨 위 초록 띠에 “무료 등급과 Google One 사용자: 제미나이 CLI 는 6월 18일에 Antigravity CLI 로 바뀌었다”고 띄워 놓고도, 표에는 구글 계정 하루 1,000회, AI Pro 1,500회, AI Ultra 2,000회를 그대로 두었어요. 무료 API 키 하루 250회와 Workspace AI Ultra 2,000회도 남아 있어요.

하나 더 있어요. 제미나이 CLI 의 로그인 문서(9월 18일 수정)는 지금도 “대부분의 사용자에게는 개인 구글 계정으로 로그인하기를 권한다”고 적어 두었어요. 구글 공지와 블로그는 그 길이 닫혔다고 하니, 두 쪽이 어긋나요. 개인 계정이라면 공지 쪽을 따르는 게 맞아요.

회사 라이선스나 API 키로 제미나이 CLI 를 쓸 분은 이렇게 깔아요.

npm install -g @google/gemini-cli

npm 에게 제미나이 CLI 를 이 PC 어디서나 쓰게(-g) 깔라고 시키는 줄이에요. npm 은 Node.js 라는 프로그램에 딸려 오는 설치 도구라서 Node.js 부터 깔려 있어야 해요. 제미나이 CLI 설치 문서는 Node.js 20 이상, 윈도우 11 24H2 이상을 권해요.

위 그림의 npm view 는 깔지 않고 패키지 정보만 물어보는 명령이에요. 10월 8일에 올라와 있던 버전은 0.63.0 이었어요. 깐 뒤에는 gemini 를 실행하고 Use Gemini API key 나 Vertex AI 를 고르라고 로그인 문서에 나와 있어요.

클로드 코드·코덱스는

같은 일을 하는 Anthropic 의 클로드 코드, OpenAI 의 코덱스 CLI 와 설치 쪽을 나란히 놓았어요. 칸마다 그 회사 문서에 적힌 것만 옮겼어요.

항목	안티그래비티 CLI	클로드 코드	코덱스 CLI
윈도우 설치	PowerShell 설치 스크립트	PowerShell 설치 스크립트	PowerShell 설치 스크립트
다른 방법	CMD 용 스크립트	WinGet, npm	npm
윈도우 조건	CLI 문서에 버전 숫자 없음, x64·ARM64	10 의 1809 이상	11 권장, 10 은 1809 이상
Node.js	설치 문서에 조건 없음	npm 설치만, 22 이상	npm 설치만, 16 이상(패키지 정보)
실행 명령	agy	claude	codex
윈도우 샌드박스	있음(기본 꺼짐)	윈도우는 지원 안 함, WSL2 는 됨	있음(관리자 승인 설정)

출처: 안티그래비티 문서 Installation and auth·CLI reference 와 설치 스크립트, 클로드 코드 Advanced setup 문서, OpenAI 코덱스 CLI·Windows 문서와 npm 패키지 정보. 10월 8일 확인.

항목	안티그래비티 CLI	클로드 코드	코덱스 CLI
로그인	브라우저, 개인 구글 계정	claude 실행 뒤 브라우저	Sign in with ChatGPT, 브라우저
되는 요금제	요금제 없이도 됨, AI Pro·Ultra 는 한도 더	Pro·Max·Team·Enterprise·Console	Plus·Pro·Business·Edu·Enterprise
무료로	됨(주 단위 한도)	안 됨	CLI 는 공식 안내 없음
한도 숫자	공개 안 됨	세션·주간 한도, 메시지 수는 문서에 없음	Plus 5시간 메시지 추정치 공개
남은 양 보기	/usage	/usage	/status, 사용량 대시보드
지침 파일	GEMINI.md, AGENTS.md	CLAUDE.md	AGENTS.md

출처: 안티그래비티 문서 Plans·FAQ·Rules·CLI reference, 클로드 코드 Advanced setup·Authentication·Manage costs·Memory 문서, OpenAI 코덱스 가격·인증·명령 문서. 10월 8일 확인.

셋 가운데 요금제 없이 개인 계정으로 바로 써 볼 수 있다고 문서에 딱 적힌 것은 안티그래비티 CLI 하나예요. 클로드 코드와 코덱스를 처음 까는 순서는 클로드 코드 윈도우 설치 글과 코덱스 CLI 윈도우 설치 글에 같은 형식으로 적어 두었어요. 대화 줄이기, 되돌리기, 프롬프트 캐시, 서브에이전트까지 비교한 표는 클로드 코드·코덱스·제미나이 CLI 비교 글에 있어요.

한국에서 되나

궁금한 것	공식 문서에 적힌 것
한국에서 되나	됨(FAQ 나라 목록 아시아 43곳에 South Korea)
언제부터	5월 19일부터 누구나, 한국 날짜는 공식 안내 없음
무슨 요금제	요금제 없이도 됨, AI Pro·Ultra 는 한도 더
계정 조건	개인 구글 계정, 만 18세 이상
한국어 문서	안티그래비티 문서는 영어
한국어 화면	공식 안내 없음

출처: 안티그래비티 문서 FAQ·Plans, 구글 개발자 블로그. 10월 8일 확인.

FAQ 는 목록에 없는 나라에서는 쓸 수 없다고 적었고, 구글 계정에 잡힌 나라가 다르면 구글 서비스 약관 페이지에서 나라를 확인해 바꿔 달라고 요청하라고 해요. 문서는 영어뿐이지만 구글 공지 쪽은 기계 번역된 한국어 화면이 떠요.

누구에게 맞을까

여기부터는 위 문서들을 놓고 본 제 생각이에요.

이런 분	맞는 쪽	이유
돈 안 들이고 먼저 써 보고 싶음	안티그래비티 CLI	요금제 없이 됨
Google AI Pro·Ultra 를 이미 냄	안티그래비티 CLI	터미널에선 구독 한도가 이쪽에 붙음
터미널이 아직 낯섦	안티그래비티 2.0 앱	창과 버튼, 설정은 서로 맞춰짐
회사 Code Assist 라이선스	제미나이 CLI 그대로	공지가 바뀌지 않는다고 적음

출처: 위 공식 문서들을 보고 고른 제 의견. 10월 8일 기준.

제 생각에는 터미널 코딩 도구를 처음 만져 보는 분에게 문턱이 가장 낮은 쪽이 안티그래비티 CLI 예요. 요금제도 Node.js 도 없이 명령 한 줄로 깔려요. 다만 한도 숫자가 공개돼 있지 않으니, 연습 폴더에서 며칠 써 보며 /usage 로 얼마나 닳는지 본 다음에 요금제를 정하는 편이 안전해요.

이 글의 내용은 2026년 10월 8일 기준이에요. 설치 명령과 버전 번호, 모델 이름은 자주 바뀌니 깔기 전에 안티그래비티 문서를 한 번 더 보세요.

같이 보면 좋은 글: 안티그래비티 CLI 설치·로그인: 제미나이 CLI 에서 옮기는 법과 요금제별 한도

같이 보면 좋은 글: 클로드 코드 설치 윈도우 초보용: PowerShell 한 줄, 로그인, 첫 질문까지 화면으로

같이 보면 좋은 글: 코덱스 CLI 설치, 윈도우에서 처음 해 본다면: 터미널 열기부터 로그인·첫 요청까지

같이 보면 좋은 글: 클로드 코드·코덱스·제미나이 CLI 비교: 압축·캐시·서브에이전트·요금제

같이 보면 좋은 글: AI 비교 2026: 클로드·챗GPT·제미나이 요금제·한도·기능 표

이 글이 들어간 총정리: 터미널 코딩 AI 처음 시작하기

같이 보면 좋은 글: 안티그래비티 CLI 사용법 처음부터: @ 로 파일 가리키기, 되돌리기, GEMINI.md 만들기

같이 보면 좋은 글: 제미나이 CLI 스킬 만들기: 안티그래비티 CLI 에서 SKILL.md 한 장으로 /명령까지

참고한 자료

2026년 10월 8일에 확인했어요.

• An important update: Transitioning Gemini CLI to Antigravity CLI (구글 개발자 블로그, 2026년 5월 19일)
• Gemini Code Assist consumer accounts (구글 공지, 9월 2일 수정, 6월 18일 종료·Login with Google)
• Gemini CLI: Quotas and pricing (제미나이 CLI 공식 문서, 6월 18일 수정, 맨 위 알림과 하루 요청 수 표)
• Gemini CLI authentication setup (제미나이 CLI 공식 문서, 9월 18일 수정, 로그인 방법)
• Gemini CLI installation, execution, and releases (제미나이 CLI 공식 문서, 권장 사양과 npm 설치)
• @google/gemini-cli (npm 패키지 정보, 0.63.0·Node 20 이상)
• Getting started (안티그래비티 공식 문서, CLI 설치와 첫 실행)
• Antigravity CLI overview (안티그래비티 공식 문서, 2.0 앱과 다른 점)
• Installation and auth (안티그래비티 공식 문서, 설치·로그인·Gemini API 키)
• install.ps1 (구글 윈도우 설치 스크립트, 설치 폴더와 안내 글)
• Tutorial (안티그래비티 공식 문서, 첫 요청 따라 하기)
• Using Antigravity CLI (안티그래비티 공식 문서, 설정·Quick tips·키)
• Prompting and interaction (안티그래비티 공식 문서, 입력 칸과 줄 바꾸기)
• Managing conversations (안티그래비티 공식 문서, 폴더마다 대화·이어 하기)
• Choose an execution mode (안티그래비티 공식 문서, default·accept-edits·plan)
• Model quotas /usage (안티그래비티 공식 문서)
• Permissions command /permissions (안티그래비티 공식 문서)
• CLI reference (안티그래비티 공식 문서, 명령 표와 설정 키)
• Best practices (안티그래비티 공식 문서, 규칙 파일·권한 값·-p)
• Troubleshooting (안티그래비티 공식 문서, PATH·보안 저장소·자동 업데이트)
• Headless mode (안티그래비티 공식 문서, -p 와 출력 형식)
• Rules (안티그래비티 공식 문서, GEMINI.md·AGENTS.md 두는 위치)
• Agent permissions (안티그래비티 공식 문서, 윈도우 알림은 2.0 앱 탭에만)
• Terminal sandbox (안티그래비티 공식 문서, 운영체제별 샌드박스)
• Plans (안티그래비티 공식 문서, 요금제별 한도)
• Models (안티그래비티 공식 문서, 요금제별 모델 표)
• FAQ (안티그래비티 공식 문서, 계정 조건·쓸 수 있는 나라·다른 회사 도구)
• Google Antigravity Pricing (구글, 개인용 월 0달러)
• Advanced setup (클로드 코드 공식 문서, 설치 명령·윈도우 조건·필요한 계정)
• Manage costs effectively (클로드 코드 공식 문서, /usage 와 요금제 한도)
• Memory (클로드 코드 공식 문서, CLAUDE.md)
• Codex CLI (OpenAI 코덱스 공식 문서, 설치 명령·로그인)
• Windows sandbox (OpenAI 코덱스 공식 문서, 윈도우 버전 표와 샌드박스)
• Pricing (OpenAI 코덱스 공식 문서, 요금제·5시간 메시지 추정)