AI CLI 가 인식되지 않을 때 (Windows)

Windows 데스크톱 앱에서 AI CLI(Claude / Codex / Gemini / Antigravity) 를 어떻게 찾는지 설명하고, 분명히 설치하셨는데도 "(미설치)" 로 표시될 때 직접 점검하실 수 있는 순서를 안내합니다. 데스크톱 앱

macOS 를 사용하신다면 AI CLI 가 인식되지 않을 때 (macOS) 를 참고해 주세요.

1. MARV 가 CLI 를 찾는 방식

새 채팅을 만들 때 MARV 는 선택하신 AI 의 실행 파일이 시스템에 있는지 확인합니다. 검색은 다음 순서로 진행됩니다.

1. 1

   1) 이전에 찾은 경로를 캐시에서 확인

   한 번이라도 발견에 성공했다면 그 경로를 기억해 두고, 다음 부팅부터는 그 파일이 그대로 있는지만 확인합니다.

2. 2

   2) 알려진 설치 경로 직접 점검

   Windows 에서 표준적으로 사용되는 글로벌 명령 경로들을 차례로 살펴봅니다. (자세한 목록은 아래 4번)

3. 3

   3) PATH 에서 검색

   위 두 단계가 실패하면 마지막으로 where.exe 로 PATH 를 훑어봅니다.

세 단계 모두 실패하면 "미설치" 로 표시됩니다. 즉, 실행 파일은 분명히 있지만 MARV 가 그 위치를 모르거나 PATH 에 잡히지 않는 경우가 대부분입니다.

2. 먼저 점검할 순서

1. 1

   PowerShell 에서 직접 실행해 보기

   먼저 CLI 가 정말로 설치되어 있는지 확인합니다. PowerShell 을 열고 다음을 입력해 주세요. (Gemini 자리에는 claude / codex / agy 를 그대로 넣어 적용할 수 있습니다.)

   where.exe gemini
   

   아무 경로도 나오지 않으면 PATH 에서 인식되지 않는 상태입니다 → 3. 재설치하기 로 진행해 주세요. 경로가 출력되면 그 경로를 잠시 기억해 두시고 다음 단계로 가시면 됩니다.

2. 2

   MARV 를 트레이까지 완전히 종료 후 재실행

   CLI 를 설치하신 직후라면, MARV 는 켜져 있던 시점의 PATH 를 그대로 들고 있어 새로 추가된 CLI 가 보이지 않을 수 있습니다. 시스템 트레이에서도 완전히 종료한 뒤 다시 실행해 주세요.

3. 3

   Windows 로그아웃 또는 재부팅

   설치 프로그램이 PATH 를 갱신했더라도, 이미 로그인되어 있던 세션의 환경 변수는 즉시 반영되지 않는 경우가 많습니다. 로그아웃 후 재로그인하시거나 재부팅을 권장합니다.

대부분의 케이스는 여기까지로 해결됩니다. 그래도 안 되면 아래 단계로 진행해 주세요.

3. 재설치하기

각 도구의 공식 설치 명령입니다. PowerShell 인스톨러 방식은 Node.js 가 필요 없고, npm 방식은 Node.js 18 이상 이 필요합니다. Node.js 가 없으시다면 먼저 공식 사이트 에서 LTS 버전을 설치해 주세요.

설치 후 새 PowerShell 창 을 열어 gemini --version (또는 다른 CLI 이름) 을 실행해 정상 동작을 확인해 주세요. 같은 창에서 바로 시도하면 PATH 갱신이 반영되지 않을 수 있습니다.

4. 설치는 됐는데 MARV 가 못 찾을 때 — 패키지 매니저별 안내

MARV 는 Windows 에서 다음 디렉토리들을 차례로 확인합니다. 대부분의 패키지 매니저가 자동 인식되도록 보강되어 있습니다.

각 디렉토리에서 .cmd → .exe → .bat → (확장자 없음) 순으로 찾아, Windows 에서 안전하게 실행 가능한 shim 을 우선합니다.

위 목록에도 포함되지 않는 위치 (=수동 PATH 등록 필요) 는 대표적으로:

• winget 패키지: %LOCALAPPDATA%\Microsoft\WinGet\Packages\...
• fnm 으로 설치한 Node 의 npm 글로벌 (%LOCALAPPDATA%\fnm_multishells\...)
• npm config set prefix 로 사용자 임의 경로로 변경한 경우

4.1 가장 간단한 해결: 위 표의 매니저로 재설치

목록 밖의 위치에 설치하셨다면, 위 표에 있는 매니저 (특히 npm 글로벌) 로 한 번 더 설치하시면 MARV 가 즉시 인식합니다. 같은 도구가 두 곳에 깔려 있어도 충돌은 없으며, 가장 빠르고 안전한 회복법입니다.

npm install -g @google/gemini-cli

설치 후에는 2. 먼저 점검할 순서 의 두 번째 단계(MARV 재실행) 부터 다시 진행해 주세요.

4.2 (선택) 기존 설치를 그대로 두고 PATH 에 수동 등록

목록 밖의 도구를 그대로 사용하고 싶으시다면, 해당 도구의 글로벌 bin 디렉토리를 PATH 에 추가해 주세요. (목록 안의 매니저라면 이 단계는 필요 없습니다.)

1. 1

   환경 변수 편집기 열기

   시작 메뉴에서 "환경 변수" 를 검색해 시스템 환경 변수 편집 을 엽니다.

2. 2

   사용자 변수의 Path 편집

   환경 변수 버튼을 누르고, 위쪽 "사용자 변수" 목록에서 Path 를 선택한 뒤 편집 을 누릅니다.

3. 3

   bin 경로 추가

   새로 만들기 를 누르고 글로벌 bin 경로를 입력합니다. 예시:

   • fnm: %LOCALAPPDATA%\fnm_multishells\<id>
   • winget 으로 설치한 도구의 실제 설치 경로
   • npm config set prefix 로 변경한 사용자 임의 경로

   확인을 모두 눌러 닫습니다.

4. 4

   로그아웃 또는 재부팅

   환경 변수 변경은 새 세션부터 적용됩니다. 로그아웃 후 재로그인하시거나 재부팅해 주세요.

5. 5

   확인 후 MARV 재실행

   새 PowerShell 창에서 where.exe gemini 로 경로가 나오는지 확인하고, MARV 를 재실행합니다.

5. 그래도 해결이 안 될 때

위 단계를 모두 거치셨는데도 "미설치" 로 표시되면 의견 남기기 로 다음 정보와 함께 알려주세요. 빠르게 회신해 드립니다.

• 사용 Windows 버전 (예: Windows 11 23H2)
• 어떤 AI 가 인식되지 않는지 (Claude / Codex / Gemini / Antigravity)
• PowerShell 에서 where.exe <이름> 의 출력 결과
• 사용 중인 Node 설치 방식 (공식 인스톨러 / nvm-windows / Volta / Scoop / pnpm / Bun / Chocolatey 등)
• MARV 로그 (앱 메뉴 → 도움말 → 로그 폴더 열기, 또는 설정 → 진단)

다음 단계

• AI CLI 가 인식되지 않을 때 (macOS) — macOS 사용자용 가이드
• 문제 해결 — 발행 실패·OAuth 등 다른 문제의 대응법
• 자주 묻는 질문 — 빠른 답이 필요한 경우 먼저 확인하실 수 있습니다.