Antigravity Agent 설정 가이드: 모든 옵션 한국어 번역과 상세 설명

 

1. Security (보안)

1-1. Strict Mode (엄격 모드)

항목	내용
원문 안내	When enabled, enforces settings that prevent the agent from autonomously running targeted exploits and requires human review for all agent actions.
한국어 번역	활성화하면 에이전트가 자율적으로 타깃 익스플로잇을 실행하는 것을 방지하는 설정을 강제 적용하며, 모든 에이전트 동작에 대해 사용자의 검토를 요구합니다.

설명

Strict Mode는 Agent의 전체 자율성을 한 단계 낮추는 마스터 스위치 역할을 합니다. 이 모드를 켜면 에이전트가 수행하는 모든 행동(파일 수정, 터미널 명령 실행 등)에 대해 사용자의 사전 승인이 필요해집니다. 보안에 민감한 프로젝트나, 에이전트의 동작을 완전히 통제하고 싶을 때 활성화하는 것이 좋습니다. 반대로, 빠른 작업 흐름이 중요한 개인 프로젝트에서는 비활성화해 두는 것이 생산성에 유리합니다.

---

2. Artifact (아티팩트)

2-1. Review Policy (검토 정책)

항목	내용
원문 안내	Specifies Agent's behavior when asking for review on artifacts, which are documents it creates to enable a richer conversation experience.
한국어 번역	아티팩트(에이전트가 대화 경험을 풍부하게 하기 위해 생성하는 문서)에 대해 검토를 요청하는 에이전트의 동작 방식을 지정합니다.

선택지 및 차이점

옵션	원문 설명	한국어 번역	효과
Always Proceeds	Agent never asks for review. This maximizes the autonomy of the Agent, but also has the highest risk of the Agent operating over unsafe or injected Artifact content.	에이전트가 검토를 요청하지 않습니다. 에이전트의 자율성이 극대화되지만, 안전하지 않거나 주입된 아티팩트 콘텐츠에 대해 에이전트가 그대로 작업할 위험이 가장 높습니다.	가장 빠른 작업 흐름. 프롬프트 인젝션 등 외부 공격에 취약할 수 있음.
Agent Decides	Agent will decide when to ask for review based on task complexity and user preference.	에이전트가 작업 복잡도와 사용자 선호도에 따라 검토 요청 여부를 스스로 판단합니다.	균형 잡힌 선택. 단순 작업은 자동 진행, 복잡하거나 위험한 작업은 검토 요청.
Asks for Review	Agent always asks for review.	에이전트가 항상 검토를 요청합니다.	가장 안전하지만 매번 승인해야 하므로 작업 속도가 느려질 수 있음.

설명

아티팩트란 에이전트가 대화 중 생성하는 코드 스니펫, 문서, 설정 파일 등의 산출물을 의미합니다. "Always Proceeds"는 에이전트가 생성한 모든 아티팩트를 사용자 확인 없이 바로 적용하므로 작업이 빠르지만, 악의적으로 주입된 콘텐츠가 그대로 반영될 위험이 있습니다. "Agent Decides"는 에이전트가 상황에 따라 판단하는 중간 지점이며, "Asks for Review"는 모든 아티팩트에 대해 사용자 검토를 거치므로 가장 안전합니다.

---

3. Terminal (터미널)

3-1. Terminal Command Auto Execution (터미널 명령 자동 실행)

항목	내용
원문 안내	(아래 선택지 참조)
한국어 번역	에이전트가 터미널 명령을 실행하기 전 확인을 요청하는 방식을 지정합니다.

선택지 및 차이점

옵션	원문 설명	한국어 번역	효과
Always Proceed	Agent never asks for confirmation before executing terminal commands (except those in the Deny list). This provides the Agent with the maximum ability to operate over long periods without intervention, but also has the highest risk of an Agent executing an unsafe terminal command.	에이전트가 터미널 명령 실행 전 확인을 요청하지 않습니다(거부 목록에 있는 명령 제외). 에이전트가 장시간 개입 없이 작업할 수 있는 최대 자율성을 제공하지만, 안전하지 않은 터미널 명령이 실행될 위험이 가장 높습니다.	장시간 자동 작업에 적합. 거부 목록(Deny List)을 반드시 함께 설정해야 안전.
Request Review	Agent always asks for confirmation before executing terminal commands (except those in the Allow list).	에이전트가 터미널 명령 실행 전 항상 확인을 요청합니다(허용 목록에 있는 명령 제외).	안전 우선. 허용 목록(Allow List)에 등록된 명령만 자동 실행.

참고: 이 설정 변경은 새로 보내는 메시지부터 적용됩니다. 진행 중인 응답에는 이전 설정값이 유지됩니다.

---

3-2. Enable Shell Integration (셸 통합 활성화)

항목	내용
원문 안내	When enabled, Agent will use IDE's shell integration to detect and report terminal command execution. When disabled, the agent will use its own shell. Restart the application for this to take effect.
한국어 번역	활성화하면 에이전트가 IDE의 셸 통합을 사용하여 터미널 명령 실행을 감지하고 보고합니다. 비활성화하면 에이전트가 자체 셸을 사용합니다. 적용하려면 애플리케이션을 재시작해야 합니다.

설명

셸 통합을 활성화하면 IDE에 내장된 터미널과 에이전트가 긴밀하게 연동되어, 명령 실행 결과를 IDE 내에서 바로 확인할 수 있습니다. 비활성화하면 에이전트가 독립적인 셸 환경을 사용하게 되므로 IDE 터미널과 분리됩니다. 대부분의 경우 활성화 상태를 유지하는 것이 편리합니다.

---

3-3. Allow List Terminal Commands (터미널 명령 허용 목록)

항목	내용
원문 안내	Agent auto-executes commands matched by an allow list entry. For Unix shells, an allow list entry matches a command if its space-separated tokens form a prefix of the command's tokens. For PowerShell, the entry tokens may match any contiguous subsequence of the command tokens.
한국어 번역	에이전트가 허용 목록에 일치하는 명령을 자동으로 실행합니다. Unix 셸에서는 허용 목록 항목의 공백으로 구분된 토큰이 명령 토큰의 접두사(prefix)를 이루면 일치합니다. PowerShell에서는 항목 토큰이 명령 토큰의 연속된 부분 시퀀스와 일치하면 됩니다.

기본 등록 명령어 목록 및 용도

명령어	용도
git status	Git 작업 트리 상태 확인
git diff	변경 사항 비교
git log	커밋 히스토리 조회
git show	특정 커밋의 상세 정보 표시
git branch	브랜치 목록 및 관리
git rev-parse	Git 참조를 SHA로 변환
git remote	원격 저장소 정보 확인
git ls-files	인덱스에 등록된 파일 목록
git fetch	원격 저장소에서 최신 정보 가져오기
git add	변경 파일을 스테이징 영역에 추가
git commit	스테이징된 변경 사항 커밋
npm install	Node.js 패키지 설치
npm run	package.json 스크립트 실행
npm test	테스트 스크립트 실행
npx	npm 패키지 임시 실행
yarn	Yarn 패키지 매니저 명령
pip install	Python 패키지 설치
pip list	설치된 Python 패키지 목록
python	Python 스크립트 실행
node	Node.js 스크립트 실행
tsc	TypeScript 컴파일러 실행
ls	디렉터리 내 파일 목록
cat	파일 내용 출력
head	파일 앞부분 출력
find	파일 검색
grep	텍스트 패턴 검색
pwd	현재 작업 디렉터리 경로 출력
cd	디렉터리 이동
mkdir	디렉터리 생성
cp	파일/디렉터리 복사
mv	파일/디렉터리 이동 또는 이름 변경
echo	텍스트 출력
eslint	JavaScript/TypeScript 린트 검사

설명

허용 목록에 등록된 명령은 "Request Review" 모드에서도 사용자 확인 없이 자동 실행됩니다. 기본값으로는 읽기 위주의 안전한 명령(git status, ls, cat 등)과 일반적인 개발 도구(npm, pip, python 등)가 등록되어 있습니다. 매칭 방식이 접두사 기반이므로, 예를 들어 git log가 등록되어 있으면 git log --oneline도 자동 실행됩니다.

---

3-4. Deny List Terminal Commands (터미널 명령 거부 목록)

항목	내용
원문 안내	Agent asks for permission before executing commands matched by a deny list entry. The deny list follows the same matching rules as the allow list and takes precedence over the allow list.
한국어 번역	에이전트가 거부 목록에 일치하는 명령을 실행하기 전 권한을 요청합니다. 거부 목록은 허용 목록과 동일한 매칭 규칙을 따르며, 허용 목록보다 우선합니다.

기본 등록 명령어 목록 및 차단 이유

명령어	차단 이유
rm	파일 삭제 (복구 불가능할 수 있음)
rmdir	디렉터리 삭제
del	Windows 파일 삭제
Remove-Item	PowerShell 항목 삭제
format	디스크 포맷
diskpart	디스크 파티션 관리 (시스템 손상 위험)
curl	외부 네트워크 요청 (악성 URL 접근 위험)
wget	외부 파일 다운로드 (악성 파일 유입 위험)
scp	원격 파일 전송
ssh	원격 서버 접속
sudo	관리자 권한 실행
su	사용자 전환
chmod 777	모든 사용자에게 전체 권한 부여 (보안 취약)
chown	파일 소유자 변경
reg	Windows 레지스트리 편집
netsh	Windows 네트워크 설정 변경
git reset	Git 히스토리 변경 (커밋 손실 위험)

설명

거부 목록은 허용 목록보다 우선 적용됩니다. 즉, 어떤 명령이 허용 목록과 거부 목록 모두에 해당하면 거부 목록이 이기며, 에이전트는 반드시 사용자에게 실행 허가를 요청합니다. 파일 삭제, 네트워크 접근, 시스템 권한 변경 등 돌이킬 수 없거나 보안에 민감한 명령들이 기본 등록되어 있습니다.

---

4. File Access (파일 접근)

4-1. Agent Gitignore Access (에이전트 .gitignore 파일 접근)

항목	내용
원문 안내	Allow Agent to view and edit the files in .gitignore automatically. Use with caution if your .gitignore lists files containing credentials, secrets, or other sensitive information.
한국어 번역	에이전트가 .gitignore에 나열된 파일을 자동으로 열람하고 편집할 수 있도록 허용합니다. .gitignore에 자격 증명, 시크릿 또는 기타 민감한 정보가 포함된 파일이 나열되어 있다면 주의하여 사용하세요.

설명

.gitignore에는 보통 .env, 인증서 파일, API 키 파일 등 Git에 추적되지 않아야 할 민감한 파일들이 등록됩니다. 이 설정을 활성화하면 에이전트가 이러한 파일도 읽고 수정할 수 있게 되므로, 프로젝트에 민감한 시크릿이 포함된 경우 비활성화 상태를 유지하는 것이 안전합니다.

4-2. Agent Non-Workspace File Access (에이전트 워크스페이스 외부 파일 접근)

항목	내용
원문 안내	Allow Agent to view and edit files outside of the current workspace automatically. Use with caution: this provides the Agent access to additional potentially-relevant information, but also allows the Agent to access credential files, secrets, and other files outside of the workspace that could be targeted in prompt injection attacks or other exploits by malicious actors.
한국어 번역	에이전트가 현재 워크스페이스 외부의 파일을 자동으로 열람하고 편집할 수 있도록 허용합니다. 주의하여 사용하세요: 에이전트가 추가적인 관련 정보에 접근할 수 있게 되지만, 동시에 워크스페이스 외부의 자격 증명 파일, 시크릿 등에 접근할 수 있으며, 이는 악의적인 행위자의 프롬프트 인젝션 공격이나 기타 익스플로잇의 표적이 될 수 있습니다.

설명

워크스페이스 외부 파일 접근을 허용하면 에이전트가 시스템 설정 파일, 다른 프로젝트 파일, 홈 디렉터리의 설정 파일(예: ~/.ssh/config, ~/.aws/credentials) 등에도 접근할 수 있습니다. 여러 프로젝트를 넘나드는 작업에는 유용하지만, 보안 위험이 크므로 필요한 경우에만 일시적으로 활성화하는 것을 권장합니다.

4-3. Auto-Open Edited Files (편집된 파일 자동 열기)

항목	내용
원문 안내	Open files in the background if Agent creates or edits them.
한국어 번역	에이전트가 파일을 생성하거나 편집하면 해당 파일을 백그라운드에서 자동으로 엽니다.

설명

이 옵션을 켜면 에이전트가 수정한 파일이 IDE 에디터 탭에 자동으로 열리므로, 어떤 파일이 변경되었는지 즉시 확인할 수 있습니다. 변경 사항을 놓치고 싶지 않다면 활성화하는 것이 좋습니다.

---

5. Automation (자동화)

5-1. Agent Auto-Fix Lints (에이전트 린트 자동 수정)

항목	내용
원문 안내	When enabled, Agent is given awareness of lint errors created by its edits and may fix them without explicit user prompting.
한국어 번역	활성화하면 에이전트가 자신의 편집으로 발생한 린트 오류를 인식하고, 사용자의 명시적 요청 없이도 이를 자동으로 수정할 수 있습니다.

설명

에이전트가 코드를 작성하거나 수정한 후 발생하는 ESLint, Pylint 등의 린트 경고/오류를 스스로 감지하고 즉시 수정합니다. 코드 품질을 자동으로 유지할 수 있어 편리하지만, 에이전트가 의도치 않은 수정을 연쇄적으로 수행할 가능성도 있으므로 주의가 필요합니다.

---

6. History (히스토리)

6-1. Conversation History (대화 기록)

항목	내용
원문 안내	When enabled, the agent will be able to access past conversations to inform its responses.
한국어 번역	활성화하면 에이전트가 과거 대화 기록에 접근하여 응답에 참고할 수 있습니다.

설명

이전 대화의 맥락을 에이전트가 기억하고 활용할 수 있게 됩니다. 예를 들어, 이전 대화에서 논의한 아키텍처 결정이나 코딩 스타일을 이후 대화에서도 일관되게 적용할 수 있습니다. 프라이버시가 우려된다면 비활성화할 수 있습니다.

---

7. Knowledge (지식)

항목	내용
원문 안내	When enabled, the agent will be able to access its knowledge base to inform its responses and automatically generate knowledge items in the background. Disabling this will prevent the agent from accessing existing knowledge items, but will not delete them.
한국어 번역	활성화하면 에이전트가 지식 기반에 접근하여 응답에 참고하고, 백그라운드에서 자동으로 지식 항목을 생성할 수 있습니다. 비활성화하면 에이전트가 기존 지식 항목에 접근하지 못하지만, 항목이 삭제되지는 않습니다.

설명

에이전트가 프로젝트 관련 지식(코드 패턴, 기술 스택 정보, 반복적으로 사용되는 설정 등)을 자동으로 학습하고 축적합니다. 비활성화해도 이미 축적된 지식이 삭제되지는 않으므로, 필요할 때 다시 켜면 기존 지식을 그대로 활용할 수 있습니다.

---

8. General (일반)

8-1. Explain and Fix in Current Conversation (현재 대화에서 설명 및 수정)

항목	내용
원문 안내	When enabled, "Explain and Fix" actions will continue in the current conversation instead of starting a new one.
한국어 번역	활성화하면 "설명 및 수정(Explain and Fix)" 동작이 새 대화를 시작하지 않고 현재 대화에서 이어집니다.

설명

코드 오류에 대한 "Explain and Fix" 기능을 사용할 때, 기존 대화의 맥락을 유지한 채 이어서 진행할지, 아니면 새로운 대화를 열지를 결정합니다. 기존 대화의 컨텍스트가 중요한 작업 중이라면 활성화하는 것이 효율적입니다.

8-2. Open Agent on Reload (새로고침 시 Agent 패널 열기)

항목	내용
원문 안내	Open Agent panel on window reload.
한국어 번역	창을 새로고침할 때 Agent 패널을 자동으로 엽니다.

설명

IDE 창을 새로고침하거나 재시작했을 때 Agent 패널이 자동으로 표시됩니다. Agent를 상시 사용하는 워크플로라면 켜두는 것이 편리합니다.

8-3. Follow Along by Default (기본 따라가기)

항목	내용
원문 안내	Automatically follow along the agent's current activity in new conversations.
한국어 번역	새 대화에서 에이전트의 현재 활동을 자동으로 따라갑니다.

설명

에이전트가 파일을 편집하거나 터미널 명령을 실행할 때, IDE의 포커스가 에이전트의 작업 위치를 자동으로 따라가도록 합니다. 에이전트의 작업 과정을 실시간으로 모니터링하고 싶다면 유용한 옵션입니다.

8-4. Enable Sounds for Agent (에이전트 사운드 활성화)

항목	내용
원문 안내	When enabled, Antigravity will play a sound when Agent finishes generating a response.
한국어 번역	활성화하면 에이전트가 응답 생성을 완료했을 때 Antigravity가 알림 소리를 재생합니다.

설명

에이전트에게 긴 작업을 맡겨 놓고 다른 일을 하고 있을 때, 완료 알림 소리로 작업 종료를 인지할 수 있어 편리합니다.

8-5. Auto-Expand Changes Overview (변경 사항 개요 자동 펼치기)

항목	내용
원문 안내	When enabled, the Changes Overview toolbar will automatically expand when Agent finishes generating a response.
한국어 번역	활성화하면 에이전트가 응답 생성을 완료했을 때 변경 사항 개요 툴바가 자동으로 펼쳐집니다.

설명

에이전트가 코드를 수정한 후, 어떤 파일이 어떻게 변경되었는지를 보여주는 Changes Overview 패널이 자동으로 펼쳐집니다. 변경 내역을 즉시 검토하고 싶다면 활성화해 두세요.

8-6. [Dev] GCP Project ID

항목	내용
원문 안내	GCP Project ID for enterprise features.
한국어 번역	엔터프라이즈 기능을 위한 GCP 프로젝트 ID입니다.

설명

Google Cloud Platform과 연동되는 엔터프라이즈 기능을 사용할 때 프로젝트 ID를 입력하는 고급 설정입니다. 일반 사용자는 별도로 설정할 필요가 없습니다.

---

설정 조합 시나리오 가이드

시나리오	권장 설정
보안 최우선 (기업 프로젝트, 민감 데이터)	Strict Mode ON, Review Policy: Asks for Review, Terminal: Request Review, Gitignore Access OFF, Non-Workspace Access OFF
균형 잡힌 일반 개발	Strict Mode OFF, Review Policy: Agent Decides, Terminal: Always Proceed (기본 Allow/Deny 목록 유지), Gitignore Access OFF, Auto-Fix Lints ON
최대 자율성 (개인 실험/프로토타이핑)	Strict Mode OFF, Review Policy: Always Proceeds, Terminal: Always Proceed, Auto-Fix Lints ON, Follow Along ON

---

마무리

Antigravity의 Agent 설정은 보안과 자율성 사이의 균형을 세밀하게 조정할 수 있도록 설계되어 있습니다. 핵심 원칙은 간단합니다: 에이전트에게 더 많은 자율성을 부여하면 작업 속도가 빨라지지만 위험도 커지고, 제한을 걸수록 안전하지만 사용자의 개입이 잦아집니다. 프로젝트의 민감도와 자신의 작업 스타일에 맞춰 적절한 지점을 찾아 설정하는 것이 가장 중요합니다.