Gemini CLI 를 설치해 버전을 확인하고, 인증 오류·조직 구독 검사·CI_ 변수로 대화형이 안 뜰 때의 원인과 디버그 모드 사용법을 정리합니다.
Gemini CLI 를 설치하고, 로그인 단계에서 자주 막히는 지점을 하나씩 점검합니다.
공식 문서에 「무료 등급·Google One 사용자에게는 2026년 6월 18일부로 Gemini CLI 가 Antigravity CLI 로 대체되었다」는 안내가 있습니다. 해당 계정이면 로그인이 안 되는 원인이 설정이 아닐 수 있으니 인증 문서 를 먼저 확인합니다.
[1] Node.js 버전을 확인합니다. 패키지는 Node 20 이상을 요구합니다.
console 복사 $ node -v v24.22.0 [2] 설치합니다. 전역 설치는 아래 명령이고, 설치 없이 한 번 실행하려면 npx @google/gemini-cli 를 씁니다.
console 복사 $ npm install -g @google/gemini-cli command not found: gemini 이면 npm 전역 bin 디렉터리가 PATH 에 없는 것입니다. 경로를 넣고 npm install -g @google/gemini-cli@latest 로 다시 설치합니다.[3] 버전을 확인합니다.
console 복사 $ gemini --version 0.64.0 [4] 인증 수단이 없으면 비대화형(-p) 실행은 아래 문구와 함께 종료 코드 41 로 끝납니다. 로그인 전의 정상적인 모습입니다.
console 복사 $ gemini -p "hi" </dev/null Please set an Auth method in your ~/.gemini/settings.json or specify one of the following environment variables before running: GEMINI_API_KEY, GOOGLE_GENAI_USE_VERTEXAI, GOOGLE_GENAI_USE_GCA $ echo $? 41 [5] gemini 를 실행해 「Sign in with Google」 을 고르면 브라우저가 열립니다. 브라우저가 터미널과 통신할 수 있는 같은 기기에서 해야 합니다(문서 ).
[6] 로그인 오류는 문구로 원인을 찾습니다. 공식 문제 해결 문서의 항목입니다(문서 ).
You must be a named user on your organization's Gemini Code Assist Standard edition subscription to use this service. — GOOGLE_CLOUD_PROJECT 또는 GOOGLE_CLOUD_PROJECT_ID 가 설정돼 있으면 조직 구독 검사가 걸립니다. 개인 계정이면 셸 설정 파일과 .env 에서 두 변수를 지웁니다. 그래도 안 되면 다른 Google 계정을 씁니다.Failed to sign in. Message: Request contains an invalid argument — Google Workspace 계정이나 Gmail 에 묶인 Google Cloud 계정은 무료 등급을 활성화하지 못할 수 있습니다. Google Cloud 계정이면 GOOGLE_CLOUD_PROJECT 에 프로젝트 ID 를 지정하거나, Google AI Studio 의 Gemini API 키를 씁니다.Failed to sign in. Message: Your current account is not eligible... because it is not currently available in your location. — 지원하지 않는 지역입니다.UNABLE_TO_GET_ISSUER_CERT_LOCALLY / unable to get local issuer certificate — 사내 방화벽이 TLS 를 검사하는 경우입니다. NODE_USE_SYSTEM_CA=1 을 먼저 설정하고, 안 되면 NODE_EXTRA_CA_CERTS 에 사내 루트 CA 파일의 절대 경로를 지정합니다.[7] 대화형 화면이 안 뜨면 CI · CONTINUOUS_INTEGRATION 이거나 CI_ 로 시작하는 환경 변수가 있는지 봅니다. 이런 변수가 있으면 비대화형 환경으로 판단합니다. 필요 없으면 그 명령에서만 뺍니다.
console 복사 $ env | grep '^CI' $ env -u CI_TOKEN gemini [8] 원인이 보이지 않으면 --debug 로 실행합니다. 대화형에서는 F12 로 디버그 콘솔을 엽니다.
console 복사 $ gemini --debug -p "hi" </dev/null DEBUG·DEBUG_MODE 는 프로젝트 .env 에서 읽지 않습니다. DEBUG_MODE=true 는 ~/.gemini/.env 에 두거나 advanced.excludedEnvVars 를 조정합니다.시험 범위: 0.64.0 에서 설치·버전 확인·인증 수단 없는 -p 실행(종료 코드 41)만 돌렸습니다. 로그인(계정 필요)과 6단계 오류 문구는 공식 문서 기준이고, 7단계의 CI_ 변수는 CI_TOKEN=x 만으로는 재현하지 못했습니다(같은 시작 화면이 떴습니다).