Antigravity CLI 설정 바꾸기·확인·문제 해결

Antigravity CLI의 설정 하나를 바꾸고, 적용됐는지 확인하고, 설정 파일 문제를 푸는 순서다. 키 하나하나의 뜻은 Antigravity CLI 명령·설정 레퍼런스에 있다.

준비물(필요한 것)#

1. 바꿀 방법을 고른다#

근거: Antigravity CLI 설정 문서

2. 바꾼다#

/config로 바꾸기 (가장 쉬운 방법)

1. 대화 화면 입력창에 /config를 치고 Enter. 프롬프트 아래에 Settings 패널이 열리고, 설정마다 지금 값이 보인다.
2. ↑/↓로 이동하거나, 글자를 쳐서 Search로 거른다.
3. ←/→로 값을 바꾸거나, Enter로 선택지를 열어 값을 고르고 Enter. 바뀐 값은 바로 저장된다.
4. Esc로 닫는다. 검색어를 쳤다면 첫 Esc는 검색어를 지우고, 선택지 목록이 열려 있으면 Esc는 취소다.

근거: Antigravity CLI 설정 문서

파일을 직접 고치기

파일은 ~/.gemini/antigravity-cli/settings.json이다. 맨 위에 $schema 줄을 넣으면 지원 편집기가 자동 완성·설명·검증을 해 준다. CLI는 이 줄을 무시하고, 저장할 때도 지우지 않는다. 원본 예시: Antigravity CLI 설정 문서

{
  "$schema": "https://antigravity.google/schemas/v1/settings.json",
  "agentMode": "accept-edits",
  "colorScheme": "tokyo night",
  "notifications": true
}

알아 둘 저장 규칙(원본): CLI는 기본값과 다른 값만 저장하고, 시작할 때 파일을 자기 형식으로 다시 쓰면서 기본값과 같은 키를 지운다. 그래서 기본값으로 적어 둔 키가 다음 실행 뒤 파일에서 사라져도 정상이다. 모르는 키는 지우지 않는다. Antigravity CLI 설정 문서

이번 세션만 바꾸기

agy --sandbox --model="Gemini 3.8 Flash"

모델 이름은 원본 당시 예시다. 플래그 값은 그 세션에만 적용되고 settings.json에 저장되지 않는다. Antigravity CLI 설정 문서

3. 됐는지 확인한다#

• /config에서 지금 값 보기: /config 패널은 설정마다 지금 값을 보여 준다. 플래그가 설정을 덮고 있으면 값 뒤에 그 플래그를 적는다. 원본 예: Sandbox Mode on (overridden by --sandbox). Antigravity CLI 설정 문서
• 파일에 키가 없다면: 기본값을 쓰고 있다는 뜻이다. CLI는 기본값과 다른 값만 저장하기 때문이다. Antigravity CLI 설정 문서
• 파일이 잘못됐다면: 다음 실행 때 세션이 열리기 전에 Settings Error 화면이 뜬다(4절).
• 원본에는 "어느 설정 파일이 로드됐는지"를 따로 보여 주는 명령이 없다. 설정 밖의 요소는 명령으로 본다(CLI commands 문서): /skills는 로드된 스킬, /hooks는 활성 훅을 보여 준다. /mcp는 MCP 서버 관리자, /plugin list는 플러그인 목록, /agents는 Agent Manager 패널을 여는데, 그 화면에 무엇이 보이는지는 원본에 없다. Antigravity CLI 명령 레퍼런스

4. Settings Error 화면이 뜨면#

키의 타입이 틀렸거나, 모르는 값이거나(예: 없는 colorScheme 이름), 파일이 올바른 JSON이 아니면 CLI는 세션을 시작하기 전에 Settings Error 화면에 파일과 문제를 보여 준다. 사용자가 고를 때까지 파일은 바뀌지 않는다. Antigravity CLI 설정 문서

"언제 고르나" 칸은 원본의 각 선택지 설명에 기댄 편집자 해석이다. 원본은 어느 것을 고르라고 권하지 않는다.

5. 단축키를 바꾸거나 되돌린다#

/keybindings가 ~/.gemini/antigravity-cli/keybindings.json을 편집기에서 연다. 동작 이름에 키 배열을 대응시킨다. Antigravity CLI 설정 문서

{
  "cli.clear_screen": ["ctrl+l"],
  "prompt.insert_newline": ["shift+enter", "ctrl+j"],
  "edit.open_editor": ["ctrl+g"]
}

• 기본 단축키를 끄려면 그 동작을 빈 배열 []로 둔다.
• 형식이 틀린 동작은 기본값으로 돌아가고 나머지는 그대로 읽는다.
• 종료(cli.exit, Ctrl+D·Ctrl+C)와 Enter(cli.enter)는 끌 수 없다.
• 모두 기본으로 되돌리기:

rm ~/.gemini/antigravity-cli/keybindings.json

6. 설치·실행 문제를 푼다 (증상별)#

CLI troubleshooting 문서가 다루는 네 가지다. 원본은 해결 명령만 주고 "됐는지 확인하는 법"은 적지 않는다. 아래 "확인" 줄은 원본의 증상 문장을 거꾸로 읽은 편집자 해석이다: 해결 뒤 같은 동작을 다시 해서 원본이 적은 증상이 사라졌는지 본다. Antigravity CLI 문제 해결 문서

6-1. agy: command not found (경로 문제)#

설치 도구는 실행 파일을 ~/.local/bin(Windows는 C:\Users\<username>\AppData\Local\agy\bin)에 둔다. 셸이 이 폴더를 찾도록 PATH(명령을 찾아보는 폴더 목록, 용어 사전)에 넣는다. Antigravity CLI 문제 해결 문서

macOS·Linux:

1. 셸 설정 파일(~/.bashrc 또는 ~/.zshrc)을 연다.
2. 파일 끝에 아래 줄이 있는지 보고, 없으면 넣는다.

export PATH="~/.local/bin:$PATH"

3. 설정을 다시 읽는다(zsh 예).

source ~/.zshrc

Windows(PowerShell):

1. PowerShell을 관리자로 열고 아래 명령을 실행한다(원본 그대로).

[System.Environment]::SetEnvironmentVariable("Path", [System.Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Program Files\Google\antigravity-cli", "User")

2. 터미널을 다시 연다.

확인(편집자 해석): 새 터미널에서 agy를 다시 실행해 command not found가 나오지 않는지 본다.

6-2. 키링이 잠겨 토큰을 못 읽을 때#

Antigravity CLI는 세션 토큰을 운영체제 보안 저장소(macOS Apple Keychain, Linux는 D-Bus를 통한 secret-service, Windows Credential Manager)에 암호화해 둔다. 이 저장소가 잠겨 있거나 화면 없는 환경이면 자격 증명을 읽지 못한다. Antigravity CLI 문제 해결 문서

macOS:

1. 키체인 접근(Keychain Access) 앱을 연다.
2. Antigravity CLI 항목을 찾는다.
3. 오른쪽 클릭 → 정보 가져오기(Get Info) → 접근 제어(Access Control) 탭에서 agy가 허용된 앱 목록에 있는지 본다.
4. 화면 없는 SSH 세션이라면 자동 잠금 시간을 정하고(예: 5분 = 300초) 키체인을 직접 연다.

security set-keychain-settings -l -u -t 300 ~/Library/Keychains/login.keychain-db
security unlock-keychain ~/Library/Keychains/login.keychain-db

5. 작업이 끝나면 원본은 바로 다시 잠글 수 있다고 적는다(선택).

security lock-keychain ~/Library/Keychains/login.keychain-db

Linux:

1. 시스템 키링(GNOME Keyring, KWallet 등)이 열려 있고 접근할 수 있는지 본다.
2. 화면 없는 환경이나 SSH라면 D-Bus 세션이 있고 키링 데몬이 도는지 본다. D-Bus 세션은 보통 아래로 시작한다.

export $(dbus-launch)

3. 그래도 안 되면 내 사용자 계정에 키링 서비스 접근 권한이 있는지 보거나 지원팀에 문의한다(원본).

Windows: 원본은 Windows Credential Manager를 쓴다고만 하고 Windows용 해결 단계는 따로 주지 않는다.

확인(편집자 해석): agy를 다시 시작해 멈춤이나 secret keyring is locked 오류가 없어졌는지 본다.

6-3. SSH에서 이미지 붙여넣기가 안 될 때#

1. 고급 클립보드 채널을 지원하는 터미널(iTerm2 또는 Ghostty)을 쓴다.
2. iTerm2라면 환경설정(Cmd+,) → General → Selection → Applications in terminal may access clipboard를 켠다(OSC 52 쓰기 채널).
3. tmux 안에서 쓴다면 tmux 설정에 아래 줄을 둔다.

set -s set-clipboard on

근거: Antigravity CLI 문제 해결 문서. 확인(편집자 해석): SSH 세션에서 Ctrl+V로 다시 붙여 넣어 local pasteboard is empty or unreachable 오류가 나오지 않는지 본다.

6-4. 자동 업데이트가 잠겼을 때#

Antigravity CLI에는 백그라운드에서 도는 자동 업데이트가 들어 있다. ~/.gemini/antigravity-cli/updater/ 안에 15분 확인 간격 표시(last_check.timestamp)와 잠금 파일(update.lock)을 둬 업데이트가 겹치지 않게 한다. 업데이트 프로세스가 멈추거나 잠금을 풀지 못하고 죽으면, 또는 설치 폴더에 쓸 권한이 없으면 다음 업데이트가 막힌다. 아래 중 하나를 한다. Antigravity CLI 문제 해결 문서

• 잠금 파일을 지운다.

rm -f ~/.gemini/antigravity-cli/updater/update.lock

• 자동 업데이트를 끈다. 셸 설정 파일(~/.bashrc 또는 ~/.zshrc)에 넣는다.

export AGY_CLI_DISABLE_AUTO_UPDATE=true

• 설치 폴더(Unix ~/.local/bin/, Windows %LOCALAPPDATA%\agy\bin)를 내 사용자가 소유하고 쓸 수 있는지 본다.

자동 업데이트를 끈 뒤 직접 업데이트하는 방법은 이 원본에 없다(CLI commands 문서는 Installation and auth 문서로 넘기는데, 이 위키에는 이 사이트에서 아직 다루지 않는다). Antigravity CLI 명령 레퍼런스 확인(편집자 해석): agy를 다시 시작해 update.lock 경고가 사라졌는지 본다.

언제 쓰고 언제 쓰지 않는가#

• 쓴다: 화면 모드·테마·알림처럼 매일 쓰는 환경을 맞출 때, 권한 모드를 바꿀 때(조건 확인 뒤), 설정 파일이 깨져 시작이 막혔을 때, agy가 실행되지 않거나 키링·업데이트 문제로 멈출 때(6절).
• 쓰지 않는다: 훅·MCP 서버·플러그인을 settings.json에 넣으려 할 때. Settings 문서는 이것들을 각자 파일에 둔다고 말한다(훅을 settings.json에서 읽는지는 다른 공식 문서와 말이 달랐는데, 이 위키는 Settings 문서 기준으로 "읽지 않는다"로 정리했다. Antigravity CLI의 "설정 파일" 절). Antigravity CLI 설정 문서
• Gemini CLI에서 옮기는 중이라면 먼저 Gemini CLI에서 Antigravity CLI로 옮기기를 따른다.