gemini cli 삭제 — 완전 삭제와 안 지워질 때
Gemini CLI를 지우는 명령은 설치 방법에 따라 셋으로 갈립니다. 전역 설치였다면 npm uninstall -g @google/gemini-cli, npx로만 써 왔다면 npm 캐시 안의 _npx 폴더를 비우는 것, Homebrew로 깔았다면 brew uninstall gemini-cli입니다. 그리고 어느 쪽이든 설정 폴더 ~/.gemini는 남습니다 — "지웠는데 기록이 그대로"인 이유가 이것입니다. 아래는 node 24.16.0 / npm 11.13.0 환경에서 실제로 깔고 지워 본 결과입니다.
1. 먼저 확인 — 나는 어떻게 깔았나
지우는 명령을 고르기 전에 지금 무엇이 어디에 깔려 있는지부터 봅니다. 전역 설치라면 아래 두 줄에 잡힙니다.
npm ls -g --depth=0
# +-- @google/gemini-cli@0.56.0
gemini --version
# 0.56.0여기에 안 잡히는데 gemini 명령이 먹힌다면 전역 설치가 아닙니다. Homebrew(3번)거나, 매번 npx로 받아 쓰고 있는 것(4번)입니다.
| 설치 방법 | 확인 | 지우는 명령 |
|---|---|---|
| npm 전역 | npm ls -g에 보임 |
npm uninstall -g @google/gemini-cli |
| Homebrew | brew list gemini-cli에 보임 |
brew uninstall gemini-cli |
| npx만 사용 | 둘 다 안 보임 | npx 캐시에서 해당 항목 삭제 |
2. npm 전역 설치 지우기 — 지우기 전에 dry-run
공식 문서가 안내하는 명령은 한 줄입니다.
npm uninstall -g @google/gemini-cli바로 실행하기 전에 --dry-run을 붙이면 무엇이 같이 지워지는지 미리 보여 주고 실제로는 아무것도 건드리지 않습니다. 실측 결과입니다.
npm uninstall -g @google/gemini-cli --dry-run
remove @google/gemini-cli 0.56.0
remove @lydell/node-pty-win32-x64 1.1.0
remove @lydell/node-pty 1.1.0
remove @github/keytar 7.10.6
remove node-addon-api 8.9.2
removed 5 packages in 821msremoved 5 packages라고 나오지만 실제로는 안 지워집니다. 위 명령을 돌린 뒤 npm ls -g로 다시 보면 0.56.0이 그대로 있습니다. 출력 문구가 헷갈릴 뿐이니 놀라지 마세요.
3. 지운 뒤에 남는 것 두 가지
임시 폴더에 따로 설치해 똑같이 지워 봤습니다. 삭제는 913ms 만에 끝났고, 실행 파일은 사라지지만 두 가지가 남습니다.
# 설치 직후 (윈도우 · npm 전역 폴더)
gemini gemini.cmd gemini.ps1 node_modules
# npm uninstall -g 이후
node_modules <- 안에 @google 빈 폴더만 남음
npm ls -g --depth=0 -> (empty)남는 것 ①: 빈 node_modules/@google 폴더. 스코프 폴더(@로 시작하는 폴더)가 껍데기로 남는 것으로, 안은 비어 있습니다. 정상이니 그냥 두거나 손으로 지우면 됩니다.
남는 것 ②: 설정 폴더. 이게 "완전 삭제"를 검색하게 만드는 진짜 이유입니다. 두 폴더의 위치를 보면 왜 안 지워지는지 바로 보입니다.
| 폴더 | 위치(윈도우 실측) | npm이 지우나 |
|---|---|---|
| 설치 폴더 | C:\Users\<사용자>\AppData\Roaming\npm |
✅ 지운다 |
| 설정 폴더 | C:\Users\<사용자>\.gemini |
❌ 안 건드린다 |
npm은 npm config get prefix가 가리키는 설치 폴더 안만 정리합니다. 설정 폴더는 홈 디렉터리에 따로 있으니 손이 닿지 않습니다. 이 PC의 .gemini는 39KB였고 안에 history, installation_id, projects.json, tmp가 들어 있었습니다. 대화 기록과 프로젝트 목록이 여기 남는 셈입니다.
# 완전 삭제 — 설정 폴더까지 (macOS / 리눅스)
rm -rf ~/.gemini
# 완전 삭제 — 윈도우 PowerShell
Remove-Item -Recurse -Force "$env:USERPROFILE\.gemini"4. npx로만 썼다면 — 통째로 비우지 마세요
npx @google/gemini-cli처럼 써 왔다면 설치된 게 없으니 지울 것도 없습니다. 다만 실행할 때마다 받아 둔 캐시가 _npx 폴더에 쌓입니다. 공식 문서는 이 폴더를 통째로 지우라고 안내하면서, "npx로 실행했던 다른 패키지도 함께 지워진다"고 경고를 붙여 두었습니다.
이 경고가 빈말이 아닙니다. 제 PC의 _npx에는 해시 이름의 폴더가 14개 있었고, 안을 열어 보니 전부 다른 도구였습니다.
eslint vitest tsx tsc
serve ccusage create-next-app create-react-app
update-browserslist-db @openai/codex ...통째로 지우면 이것들이 같이 날아가고, 다음에 쓸 때 전부 다시 내려받습니다. 해시 폴더 안의 package.json에 어떤 패키지인지 적혀 있으니, gemini 것만 골라 지우는 편이 낫습니다.
# 캐시 폴더 위치 확인
npm config get cache
# C:\Users\<사용자>\AppData\Local\npm-cache (윈도우)
# ~/.npm (macOS / 리눅스)
# 어느 폴더가 gemini 것인지 찾기 (macOS / 리눅스)
grep -l "gemini-cli" "$(npm config get cache)"/_npx/*/package.json찾은 폴더만 지우면 다른 도구의 캐시는 그대로 남습니다. 그래도 전부 비우고 싶다면 공식 문서대로 _npx 폴더를 지우면 되고, 없어진 캐시는 다음 실행 때 자동으로 다시 만들어집니다.
5. 지웠는데 gemini 명령이 계속 먹힐 때
가장 흔한 원인은 지운 곳과 실제로 실행되는 곳이 다른 것입니다. 어느 파일이 실행되고 있는지부터 확인하세요.
# macOS / 리눅스
which -a gemini
# 윈도우 PowerShell
Get-Command gemini -All여기서 나온 경로가 npm config get prefix 결과와 다르면 다른 경로에 또 깔려 있다는 뜻입니다. Homebrew 경로(/opt/homebrew/bin 등)가 나오면 brew uninstall gemini-cli로 지웁니다. 공식 삭제 문서에는 Homebrew 항목이 없지만 정식 formula가 존재하기 때문에, brew로 깔았다면 npm 명령을 아무리 돌려도 소용이 없습니다.
경로가 맞는데도 먹힌다면 셸이 예전 위치를 외우고 있는 것입니다. 터미널을 새로 열거나 hash -r(bash·zsh)로 기억을 비우면 됩니다.
자주 묻는 질문 (FAQ)
Q. 서비스가 끝났다던데 패키지가 내려간 건가요?
아닙니다. npm 레지스트리를 확인하면 @google/gemini-cli는 지금도 올라와 있고(확인 시점 최신 0.58.0), 사용 중단(deprecated) 표시도 없습니다. 다만 무료·Pro·Ultra 계정의 요청 처리는 종료돼 후속 도구로 옮겨 가는 흐름입니다. 배경과 이전 절차는 gemini cli 서비스 종료 글에 정리해 두었습니다.
Q. 지우고 Antigravity CLI로 갈아타려면요?
설정을 옮긴 뒤에 지우는 순서가 안전합니다. 새 도구에서 남은 한도를 보는 방법은 antigravity cli 사용량 확인 글에 있습니다.
Q. npm uninstall에서 권한 오류가 납니다.
전역 폴더가 관리자 영역에 있을 때 납니다. 윈도우는 관리자 권한 터미널에서, macOS·리눅스는 sudo를 붙여 다시 실행하세요. 다만 sudo가 필요하다는 건 애초에 sudo로 깔았다는 뜻이라, 앞으로는 전역 폴더를 홈 아래로 옮겨 두는 편이 편합니다.
Q. 지운 버전으로 되돌리고 싶습니다.
버전을 지정해 다시 깔면 됩니다. npm install -g @google/gemini-cli@0.56.0처럼 @버전을 붙이세요. 설정 폴더를 안 지웠다면 로그인 상태와 프로젝트 목록도 그대로 돌아옵니다.
마무리
정리하면 세 가지입니다. ① 지우기 전에 npm ls -g와 which -a gemini로 어디에 깔렸는지 확인한다. ② npm 전역이면 npm uninstall -g @google/gemini-cli, Homebrew면 brew uninstall gemini-cli. ③ 기록까지 없애는 "완전 삭제"는 설정 폴더 ~/.gemini를 따로 지워야 끝난다. 다시 깔 생각이라면 이 폴더는 남겨 두는 편이 낫습니다.
📚 참고 출처 (2026년 9월 7일 확인)
· Gemini CLI 공식 문서 — Uninstalling the CLI
· Homebrew formula — gemini-cli
· 버전·명령 출력은 node 24.16.0 / npm 11.13.0 / gemini-cli 0.56.0 환경에서 직접 실행해 확인
COMMENTS