Antigravity 키보드 단축키: CLI 가이드

‘Antigravity 키보드 단축키’가 가리키는 범위

Antigravity 키보드 단축키를 검색하면 여러 화면의 동작이 섞이기 쉽습니다. 어떤 조합은 에디터 화면을 열고, 터미널에 포커스를 주고, 에이전트 패널을 열거나 운영체제 동작을 실행합니다. CLI에는 또 다른 계층이 있습니다. agy --help, /help, /diff, /settings는 키 조합이 아니라 입력하는 명령어입니다.

변경하기 전에 대상 화면을 먼저 정하세요. 파일 이동은 에디터 키 바인딩, 에이전트 세션은 CLI와 셸, 채팅 포커스는 데스크톱 IDE의 설정에 속합니다. 이렇게 구분하면 잘못된 JSON을 수정한 뒤 Antigravity가 변경을 무시한다고 판단하는 실수를 줄일 수 있습니다.

먼저 확인할 Antigravity 키보드 단축키

아래 표는 현재 공식 CLI 참조의 터미널 사용자 인터페이스를 기준으로 정리했습니다. 데스크톱 에디터의 단축키와는 별개입니다. IDE, 통합 터미널, 독립 CLI 중 어디에 포커스가 있느냐에 따라 같은 물리 키의 의미가 달라질 수 있습니다. 프로필, 키보드 배열, 원격 세션과 이후 버전도 결과에 영향을 줍니다.

셸에서 agy --version 또는 agy --help로 설치된 명령어를 확인하고 세션을 연 뒤 /help로 도움말을 여세요. /keybindings로 단축키 편집기를 열고 JSON을 수정하기 전에 동작 이름과 적용 범위를 비교하세요.

단축키를 안전하게 찾고 테스트하는 방법

단축키가 작동하지 않을 때는 제품 버그보다 먼저 컨텍스트를 확인하세요. 에디터에 포커스가 없거나 터미널이 키를 가로채거나 워크스페이스 프로필이 다른 바인딩을 사용할 수 있습니다. 짧은 절차를 따르면 여러 설정을 한꺼번에 바꾸지 않고 원인을 확인할 수 있습니다.

단축키가 에이전트를 실행하거나 파일을 쓰거나 명령어를 실행하거나 네트워크 도구를 여는 경우 되돌릴 수 있는 테스트 프로젝트에서 사용하세요. 동작과 권한 경계를 따로 확인하고 원래 바인딩으로 복구하는 방법을 기록하세요.

1. 1. 화면을 정하기키 바인딩을 편집하기 전에 에디터, 터미널, 에이전트 패널, 독립 CLI 중 무엇을 테스트하는지 결정합니다.
2. 2. 현재 명령어 찾기명령 팔레트에서 동작을 검색하고 단축키, 충돌, 적용 프로필을 확인합니다.
3. 3. 안전한 동작으로 테스트하기파일 열기, 도움말 보기, 상태 확인처럼 쓰기나 실행이 없는 동작부터 시작합니다.
4. 4. 작동 상태 기록하기운영체제, 키보드 배열, 화면, 제품과 CLI 버전, 워크스페이스와 적용 범위를 기록합니다.

• 대체 경로 남기기 — 명령 팔레트, 사이드바, 메뉴와 CLI 도움말을 복구 경로로 사용할 수 있게 두세요.
• 한 번에 하나만 변경하기 — 하나의 명령어 때문에 전체 키 바인딩 파일을 가져오지 말고 작은 변경을 쉽게 되돌릴 수 있게 하세요.
• 에이전트 권한 확인하기 — 에이전트를 시작하는 단축키는 셸, 파일, 브라우저, 네트워크 작업으로 이어질 수 있으므로 검토 설정을 표시해 두세요.

통제력을 잃지 않고 Antigravity 키 바인딩 변경하기

JSON을 편집하기 전에 /keybindings 또는 키보드 단축키 편집기에서 명령어, 현재 키와 충돌을 확인하세요. 올바른 JSON도 사용자, 워크스페이스, 원격 세션, 프로필의 범위가 다르면 적용되지 않는 것처럼 보일 수 있습니다. 먼저 UI에서 시작하고 최소한만 변경하세요.

키보드 설정과 CLI 설정은 분리하세요. 키 바인딩은 ~/.gemini/antigravity-cli/keybindings.json에 있고 CLI 환경설정과 권한은 ~/.gemini/antigravity-cli/settings.json에 있습니다. 두 파일을 백업하고 제품 코드를 바꾸지 않는 동작으로 테스트하세요.

Antigravity 단축키 문제 해결

단축키가 실패하면 포커스, 범위, 충돌, 제품 화면 순서로 확인하세요. 다른 계층이 키를 가로챈 경우 재설치로 해결되지 않는 경우가 많습니다.

단축키가 아무 동작도 하지 않음

에디터나 터미널을 클릭하고 다시 시도한 뒤 명령 팔레트를 사용하세요. 팔레트에서 작동한다면 포커스나 충돌이 원인일 가능성이 높습니다.

잘못된 동작이 열림

명령어를 검색하고 중복 바인딩을 확인한 뒤 충돌하는 확장 규칙을 변경하세요. 전역 설정을 바꾸기 전에 깨끗한 워크스페이스에서 테스트하세요.

에이전트 패널이 보이지 않음

사이드바나 명령 팔레트를 사용하고 데스크톱 IDE에 있는지 확인하세요. 독립 CLI 세션에서는 이 패널을 열 수 없습니다.

CLI 명령어를 찾을 수 없음

실제로 사용하는 터미널의 PATH를 확인하고 agy --version을 공식 설치 방법과 비교하세요. 세션을 연 뒤 /help 또는 /keybindings를 사용하세요.

로컬에서는 작동하지만 원격에서는 작동하지 않음

원격 프로필, 키보드 배열, 에디터 컨텍스트와 워크스페이스 범위를 비교하세요. 원격 세션은 다른 설정 파일을 읽을 수 있습니다.

단축키가 위험한 작업을 실행함

바인딩을 제거하고 셸과 파일 쓰기 검토 설정을 복원한 뒤 버려도 되는 프로젝트에서 재현하세요.

단축키가 바뀌었을 때 기록할 내용

단축키 동작은 버전에 따라 달라집니다. 호스트 화면과 CLI를 따로 기록하세요. IDE 업데이트로 명령어가 바뀌어도 셸 바이너리는 그대로일 수 있습니다.

이 안내는 최신 버전을 주장하지 않습니다. 회귀 문제를 보고하기 전에 공식 참조를 확인하고 날짜, 플랫폼, 배열, 프로필, 워크스페이스와 실패한 동작을 기록하세요. 최종 기준은 설치된 build입니다.

설명용 미디어입니다. 설치된 제품에서 키를 확인하세요.