Antigravity 브라우저 안 열릴 때? Playwright $HOME 오류 1분 해결법

 

PowerShell '$HOME environment variable is not set' 오류 해결 가이드! Google Antigravity 환경에서 Playwright 실행 시 발생하는 브라우저 구동 문제를 단 1분 만에 해결하는 3가지 방법을 상세히 소개합니다. 😊

 

개발자라면 한 번쯤 겪게 되는 환경 변수 오류, 특히 윈도우 환경에서 Google Antigravity나 Playwright 기반의 AI 에이전트를 사용하려 할 때 "$HOME environment variable is not set"이라는 메시지를 마주하면 당황스럽기 마련이죠. 윈도우는 기본적으로 사용자 폴더를 인식하지만, 리눅스 기반 도구들은 명시적인 'HOME' 변수를 찾지 못해 작동을 멈추기 때문이에요. 오늘은 이 문제를 깔끔하게 해결하고 다시 개발에 집중할 수 있도록 도와드릴게요! 😊

오류가 발생하는 근본적인 이유 🤔

이 오류는 윈도우 시스템과 유닉스(Unix) 계열 도구 사이의 표준 차이에서 비롯됩니다. Playwright와 같은 브라우저 자동화 도구는 원래 리눅스와 macOS 환경을 염두에 두고 설계되었기 때문에 사용자 홈 디렉토리를 가리키는 $HOME 변수를 필수적으로 요구합니다.

하지만 윈도우는 전통적으로 사용자 경로를 %USERPROFILE%이라는 이름으로 저장하죠. 따라서 Antigravity의 Browser Subagent가 브라우저를 설치하거나 실행하려 할 때 "집(HOME)"이 어디인지 몰라 패닉 상태에 빠지게 되는 것입니다.

💡 핵심 포인트!
Antigravity는 Playwright를 통해 브라우저를 구동하며, 이 과정에서 브라우저 프로필과 캐시를 저장할 정확한 경로($HOME)가 정의되어야 합니다.

 

방법 1: PowerShell을 이용한 영구 해결 (추천) 🚀

가장 빠르고 권장되는 방법입니다. PowerShell의 .NET API를 활용하면 제어판을 뒤질 필요 없이 명령어 한 줄로 사용자 환경 변수에 HOME을 영구 등록할 수 있습니다.

📝 해결 명령어: HOME 변수 생성

아래 코드를 복사하여 PowerShell 창에 입력하고 엔터를 누르세요.

[System.Environment]::SetEnvironmentVariable("HOME", $env:USERPROFILE, "User")

결과 설명: 이 명령은 %USERPROFILE%(예: C:\Users\YourName)의 값을 HOME이라는 이름으로 사용자 변수에 저장합니다. 실행 후 Antigravity나 터미널을 완전히 종료한 뒤 다시 실행해야 적용됩니다.

 

방법 2: 시스템 설정 UI를 통한 수동 해결 📊

명령어 입력이 익숙하지 않다면 윈도우의 GUI 설정을 통해 직접 변수를 추가할 수 있습니다. 이 방식은 시각적으로 설정을 확인할 수 있어 안정적입니다.

환경 변수 수동 추가 단계

단계	작업 내용	비고
1. 검색	'시스템 환경 변수 편집' 검색 및 실행	윈도우 키 활용
2. 메뉴 진입	[환경 변수] 버튼 클릭	하단 위치
3. 신규 생성	사용자 변수 섹션에서 [새로 만들기] 클릭	상단 영역
4. 값 입력	이름: HOME / 값: %USERPROFILE%	오타 주의!

⚠️ 주의하세요!
변수 값을 입력할 때 양옆에 공백이 들어가지 않도록 주의하세요. 설정 후에는 반드시 열려있는 모든 프로그램(특히 Antigravity)을 재시작해야 합니다.

 

방법 3: 현재 세션 임시 해결 (급할 때) 🧮

시스템 전체 설정을 건드리고 싶지 않거나, 지금 당장 테스트만 해보고 싶을 때 사용하는 방법입니다. 다만 창을 닫으면 설정이 증발하므로 임시 방편으로만 추천해요.

📝 세션 임시 할당 코드

PowerShell 창에 아래 줄을 입력하고 바로 실행하세요.

$env:HOME = $env:USERPROFILE

 

Antigravity 사용자를 위한 실전 팁 👩‍💼👨‍💻

HOME 변수를 설정했음에도 오류가 지속된다면 아래 사항을 점검해 보세요. 특히 Antigravity 1.15.8 이후 버전에서는 브라우저 확장 프로그램과의 연동이 매우 중요합니다.

📌 점검 체크리스트
- PowerShell에서 echo $env:HOME을 입력했을 때 경로가 정상 출력되나요?
- Antigravity Browser Extension이 최신 버전으로 설치되어 있나요?
- Antigravity의 통합 터미널 대신 외부 PowerShell 창에서 먼저 테스트해 보셨나요?

 

실전 예시: 환경 변수 적용 후 검증 📚

정상적으로 설정되었는지 확인하는 과정을 통해 불필요한 삽질(?)을 줄일 수 있습니다.

검증 프로세스

• 단계 1: 새 PowerShell 창 열기 (필수)
• 단계 2: Get-ChildItem Env:HOME 입력
• 결과: C:\Users\사용자명 형태의 경로가 보이면 성공!

최종 결과: 이제 Antigravity에서 브라우저를 요청하면 오류 없이 Chrome 창이 스르륵 열리는 것을 볼 수 있습니다. 쾌적한 AI 개발 환경 완성! 🎉

 

마무리: 핵심 내용 요약 📝

오늘은 윈도우 환경에서 Playwright와 Antigravity의 발목을 잡던 $HOME 환경 변수 오류를 해결하는 방법을 알아보았습니다.

단순히 이름을 맞추는 작업이지만, AI 에이전트가 브라우저를 자유롭게 제어하기 위한 가장 기초적인 토대이기도 합니다. 해결 과정에서 어려움이 있거나 다른 오류 메시지가 나온다면 언제든 댓글로 남겨주세요! 함께 해결해 봐요~ 😊

 

✅

핵심 요약 포인트

1️⃣ 원인: 윈도우는 %USERPROFILE%을 쓰지만, Playwright는 $HOME을 찾음.

2️⃣ 명령어: [Environment]::SetEnvironmentVariable("HOME", $env:USERPROFILE, "User")

3️⃣ 필수 단계: 설정 후 반드시 프로그램 재시작 (VS Code, 터미널 등).

환경 변수 하나로 해결하는 Antigravity 브라우저 구동 가이드