첫 실행 필수: 데이터 디렉토리, 로그, 트레이 및 자동 시작
Antigravity Tools의 많은 "마법처럼 보이는" 능력(계정 풀, 할당량, 모니터링, 통계, 백그라운드 실행)은 결국 두 가지에 의존합니다: 데이터 디렉토리와 로그. 처음 실행할 때 이 두 부분을 명확히 하면 나중에 문제 해결에 많은 시간을 절약할 수 있습니다.
데이터 디렉토리란?
데이터 디렉토리는 Antigravity Tools가 로컬에 상태를 저장하는 폴더입니다: 계정 JSON, 할당량 관련 파일, 로그 파일, Token Stats/Proxy Monitor의 SQLite 데이터베이스가 모두 여기에 저장됩니다. 백업/마이그레이션/문제 해결을 할 때, 이 디렉토리를 먼저 찾으면 기본적으로 권위 있는 데이터 소스를 찾을 수 있습니다.
학습 완료 후 가능한 작업
- Antigravity Tools의 데이터 디렉토리 위치 파악 (한 번 클릭으로 열기)
- 백업할 파일과 로그/캐시 파일 구분
- 문제 해결이 필요할 때, 로그 및 모니터링 데이터베이스 빠르게 찾기
- "창 닫기"와 "프로그램 종료"의 차이 이해 (트레이 상주)
- 두 가지 자동 시작 유형 구별: 시작 시 자동 시작 vs 역방향 프록시 자동 시작
현재 겪고 있는 문제
- 백업/마이그레이션을 하고 싶지만 계정이 정확히 어디에 저장되는지 모름
- UI 오류/역방향 프록시 호출 실패지만 로그를 찾을 수 없음
- 창을 닫았는데 프로그램이 백그라운드에서 계속 실행 중인 줄 알았는데 실제로는 실행 중
이 기능을 언제 사용해야 할까
- Antigravity Tools를 방금 설치하고 "데이터가 어디에 있는지" 확인하고 싶을 때
- 컴퓨터 교체/시스템 재설치 전, 계정 및 통계 데이터를 백업하고 싶을 때
- OAuth 실패, 할당량 갱신 실패, 역방향 프록시 시작 실패, 401/429 호출 오류 해결이 필요할 때
🎒 시작 전 준비
- Antigravity Tools 설치 및 실행 가능한 상태
- Settings 페이지에 진입 가능 (오른쪽 위/사이드바의 설정 진입점)
- 시스템 계정이 Home 디렉토리에 액세스할 권한이 있음
알림
이 수업에서는 어떤 파일이 "진짜 데이터"인지 알려주지만, 이러한 파일을 수동으로 편집하는 것은 권장하지 않습니다. 설정을 변경하려면 UI에서 우선 변경하세요.
핵심 개념
한 문장을 기억하세요:
"데이터 디렉토리는 로컬 상태의 단일 진실 원천; 로그는 문제 해결의 첫 번째 진입점입니다."
Antigravity Tools는 Home 디렉토리 아래에 .antigravity_tools 데이터 디렉토리를 생성하고, 계정, 로그, 통계 데이터베이스 등의 내용을 모두 여기에 저장합니다 (디렉토리가 없으면 자동 생성).
동시에 기본적으로 트레이를 활성화합니다: 창을 닫으면 프로그램이 즉시 종료되지 않고 트레이에 숨겨진 채 백그라운드에서 계속 실행됩니다.
함께 실습
1단계: 설정 페이지에서 데이터 디렉토리 열기
이유 데이터 디렉토리 위치를 먼저 정확하게 파악하면, 이후 백업이나 문제 해결 시 "목표"가 있습니다.
Antigravity Tools에서 Settings를 열고 Advanced로 전환합니다.
"데이터 디렉토리"의 읽기 전용 입력 상자가 보입니다 (실제 경로 표시), 옆에 열기 버튼이 있습니다.
열기 버튼을 클릭합니다.
예상 화면: 시스템 파일 관리자가 디렉토리를 엽니다, 경로는 ~/.antigravity_tools/와 유사함.
2단계: 데이터 디렉토리 경로 확인 (크로스 플랫폼)
이유 나중에 백업 스크립트를 작성하거나 명령줄에서 문제 해결을 할 때, 시스템의 실제 경로를 알아야 합니다.
echo "$HOME/.antigravity_tools"
ls -la "$HOME/.antigravity_tools"$dataDir = Join-Path $HOME ".antigravity_tools"
$dataDir
Get-ChildItem -Force $dataDir예상 화면: 디렉토리가 존재함 (처음 설정 페이지를 열면 디렉토리가 자동으로 생성됨).
3단계: 데이터 디렉토리 내의 "핵심 파일" 이해
이유 모든 파일이 백업할 가치가 있는 것은 아닙니다. "계정 데이터", "통계 데이터베이스/로그"를 먼저 구분하세요.
다음 파일 이름은 프로젝트 소스 코드에서 오며 모두 고정됨:
| 보게 될 내용 | 용도 | 신경 써야 할 것 |
|---|---|---|
accounts.json | 계정 인덱스 (계정 목록/현재 계정 포함) | 계정 마이그레이션 시 함께 백업 권장 |
accounts/ | 각 계정마다 하나의 *.json 파일 | 이것이 계정 데이터 본체 |
logs/ | 애플리케이션 로그 디렉토리 | 문제 해결 시 우선 확인 |
token_stats.db | Token Stats의 SQLite 데이터베이스 | Token Stats 페이지의 데이터가 여기서 옴 |
proxy_logs.db | Proxy Monitor의 SQLite 데이터베이스 | Monitor 페이지의 요청 로그가 여기서 옴 |
warmup_history.json | Smart Warmup의 로컬 기록 | 주로 중복 warmup 방지용 |
update_settings.json | 업데이트 검사 설정 (자동 검사/간격 등) | 일반적으로 수동 조작 필요 없음 |
예상 화면: 최소한 logs/ 디렉토리가 존재함; 아직 계정을 추가하지 않았으면 accounts.json/accounts/가 아직 표시되지 않을 수 있음.
4단계: 로그 위치 기억하기 (문제 해결은 이것으로)
이유 UI의 오류 메시지는 보통 "현상"만 알려주고, 실제 실패 원인(예: 요청 실패, 파일 읽기/쓰기 실패)은 종종 로그에 있습니다.
Antigravity Tools는 로그를 데이터 디렉토리의 logs/에 작성합니다.
ls -la "$HOME/.antigravity_tools/logs"Get-ChildItem -Force (Join-Path $HOME ".antigravity_tools\logs")예상 화면: 디렉토리 아래 일일별로 롤링되는 로그 파일이 존재함 (파일 이름은 app.log로 시작).
5단계: "로그 정리"가 필요할 때, 설정 페이지의 원 클릭 정리 사용
이유 어떤 문제는 한 번만 재현하고 그 로그를 따로 남기고 싶음; 이때 먼저 로그를 비우면 더 좋게 비교 가능.
Settings -> Advanced에서 로그 영역을 찾고, "로그 정리" 클릭.
예상 화면: 확인 대화상자 표시; 확인 후 정리 성공 메시지 표시.
걱정할 두 가지
- 로그는 자동으로 "일일별 롤링"되며, 시작 시 7일 이상의 구 로그를 정리하려고 시도합니다.
- "로그 정리"는 로그 파일을 0바이트로 잘라, 실행 중인 프로세스가 동일한 파일 핸들에 계속 쓸 수 있게 합니다.
6단계: "창 닫기"와 "프로그램 종료"의 차이 이해 (트레이)
이유 Antigravity Tools는 기본적으로 트레이를 활성화합니다; 창 오른쪽 위 닫기를 클릭하면 프로그램이 트레이에 숨겨진 채 계속 실행됩니다. 종료했다고 착각하면 "포트 여전히 점유 중/백그라운드 여전히 실행 중"의 착각이 발생하기 쉽습니다.
다음 작은 프로세스로 확인 가능:
작업: 창 닫기 (종료 아님)
┌─────────────────────────────────────────────────────────────┐
│ 1단계 2단계 │
│ 창 닫기 클릭 → 시스템 트레이/메뉴 바에서 아이콘 찾기 │
└─────────────────────────────────────────────────────────────┘
예상 화면: 트레이 아이콘이 여전히 존재하고, 클릭하면 창이 다시 표시됨.트레이 메뉴에는 UI를 거치지 않을 때 편리한 두 가지 자주 사용하는 작업이 있습니다:
- 계정 전환: 다음 계정으로 전환
- 할당량 갱신: 현재 계정 할당량 갱신 (동시에 프론트엔드 표시 갱신 알림)
7단계: 시작 시 자동 시작 설정 (시작 후 최소화)
이유 "상주 서비스"처럼 작동하기를 원하는 경우 (트레이 상주 + 백그라운드 갱신), 시작 시 자동 시작이 매번 수동으로 여는 것을 절약합니다.
Settings -> General에서 "시작 시 자동 시작" 찾고, 활성화 선택.
예상 화면: 전환 후 활성화 성공 메시지 표시; 다음 시작 시 --minimized 매개변수와 함께 실행됨.
두 가지 "자동 시작" 혼동 금지
| 이름 | 의미 | 증거 |
|---|---|---|
| 시작 시 자동 시작 | 컴퓨터 시작 후 Antigravity Tools 자동 시작 (데스크톱 애플리케이션 자체) | 시작 매개변수에 --minimized 포함, toggle_auto_launch 명령 제공 |
| 역방향 프록시 자동 시작 | Antigravity Tools 시작 후, proxy.auto_start=true 구성되면 로컬 역방향 프록시 서비스 자동 시작 시도 | 애플리케이션 시작 시 구성 읽기 및 start_proxy_service(...) |
체크포인트 ✅
- [ ] Settings -> Advanced에서 데이터 디렉토리의 실제 경로 확인 가능
- [ ] 데이터 디렉토리를 열고 대략적으로
accounts.json,accounts/,logs/,token_stats.db,proxy_logs.db를 인식 - [ ] 로그가
logs/아래에 있고 명령줄로 빠르게 보는 법 파악 - [ ] 창 닫기 후 프로그램이 여전히 트레이에 있고, 종료하려면 트레이 Quit 사용
- [ ] "시작 시 자동 시작"과 "역방향 프록시 자동 시작" 구별 가능
흔한 오류
| 시나리오 | 잘못된 방법 (❌) | 권장 방법 (✓) |
|---|---|---|
| 데이터 디렉토리를 찾지 못함 | 시스템에서 앱 설치 디렉토리를 무작위 검색 | Settings -> Advanced에서 "데이터 디렉토리" 확인 및 한 번 클릭으로 열기 |
| 창 닫기 후 종료했다고 생각 | 창 닫기 후 설정/포트 변경 | 먼저 트레이 아이콘이 여전히 있는지 확인; 종료하려면 트레이 Quit 사용 |
| 로그가 너무 많아서 문제 해결 어려움 | 문제 재현 중 구 로그 뒤집기 | 먼저 "로그 정리" 후 재현 한 번, 마지막으로 이번 로그 파일만 확인 |
| 계정 데이터 변경하고 싶음 | accounts/*.json 수동 편집 | UI의 가져오기/내보내기/마이그레이션 프로세스 사용 (다음 섹션 관련 장에서 설명) |
이 수업 요약
- 데이터 디렉토리는 Home 아래
.antigravity_tools에 고정 (macOS/Linux에서 보통 숨김 디렉토리로 표시), 계정/로그/통계 데이터베이스가 모두 여기에 있음 - 로그 디렉토리는
logs/, 문제 해결 시 우선 확인; 필요 시 설정 페이지에서 한 번 클릭 정리 가능 - 창 닫기는 트레이에 숨겨진 채 계속 실행; 완전히 종료하려면 트레이 Quit 사용
- 자동 시작에는 두 가지 유형: 시작 시 자동 시작 (애플리케이션) 및 역방향 프록시 자동 시작 (Proxy)
다음 수업 예고
다음 수업에서 **계정 추가: OAuth/Refresh Token 이중 채널과 모범 사례**를 학습합니다.
부록: 소스 코드 참조
확장하여 소스 코드 위치 보기
업데이트 시간: 2026-01-23
| 기능 | 파일 경로 | 행 번호 |
|---|---|---|
데이터 디렉토리 위치 (~/.antigravity_tools) | src-tauri/src/modules/account.rs | 16-33 |
계정 인덱스 및 계정 파일 디렉토리 (accounts.json / accounts/) | src-tauri/src/modules/account.rs | 16-46 |
로그 디렉토리 및 일일별 롤링 (logs/ + app.log) | src-tauri/src/modules/logger.rs | 17-83 |
| 로그 정리 (파일 잘라내기) | src-tauri/src/modules/logger.rs | 149-169 |
| 설정 페이지 데이터 디렉토리 표시 + 한 번 클릭 열기 | src/pages/Settings.tsx | 525-576 |
| 설정 페이지 한 번 클릭 로그 정리 (버튼 + 대화상자 로직) | src/pages/Settings.tsx | 127-135 |
| 설정 페이지 한 번 클릭 로그 정리 (Advanced 탭 버튼) | src/pages/Settings.tsx | 732-747 |
| 트레이 메뉴 및 클릭 이벤트 (계정 전환/갱신/표시/종료) | src-tauri/src/modules/tray.rs | 9-158 |
| --- | --- | --- |
| --- | --- | --- |
시작 시 자동 시작 스위치 (toggle_auto_launch / is_auto_launch_enabled) | src-tauri/src/commands/autostart.rs | 4-39 |
| 한 번 클릭 데이터 디렉토리 열기 / 경로 가져오기 / 로그 정리 명령 | src-tauri/src/commands/mod.rs | 578-621 |
Token Stats 데이터베이스 파일명 (token_stats.db) | src-tauri/src/modules/token_stats.rs | 58-61 |
Proxy Monitor 데이터베이스 파일명 (proxy_logs.db) | src-tauri/src/modules/proxy_db.rs | 5-8 |
Warmup 기록 파일명 (warmup_history.json) | src-tauri/src/modules/scheduler.rs | 14-17 |
업데이트 설정 파일명 (update_settings.json) | src-tauri/src/modules/update_checker.rs | 150-177 |
역방향 프록시 자동 시작 (proxy.auto_start=true 시 서비스 시작) | src-tauri/src/lib.rs | 107-126 |
다음 수업 예고
다음 수업에서 **계정 추가: OAuth/Refresh Token 이중 채널과 모범 사례**를 학습합니다.
배울 내용:
- OAuth를 언제 사용하고, 언제 refresh_token 직접 사용
- 콜백 실패 및 refresh_token을 얻지 못할 때 처리 방법
- refresh_token 일괄 가져오기로 계정 풀 빠르게 구축