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

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

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

1. MARV 가 CLI 를 찾는 방식

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

1. 1

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

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

2. 2

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

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

3. 3

   3) PATH 에서 검색

   위 두 단계가 실패하면 마지막으로 로그인 셸에서 command -v 로 PATH 를 훑어봅니다.

2. 먼저 점검할 순서

1. 1

   터미널에서 직접 실행해 보기

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

   which gemini
   

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

2. 2

   MARV 데스크톱 앱을 완전 종료 후 재실행

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

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

3. 재설치하기

각 도구의 공식 설치 명령입니다. 모두 Node.js 18 이상 이 필요합니다. Node.js 가 없으시다면 먼저 Homebrew(brew install node) 또는 공식 사이트 에서 LTS 버전을 설치해 주세요.

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

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

MARV 는 macOS 에서 다음 디렉토리들을 우선 확인합니다.

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

• pnpm global: ~/Library/pnpm/
• Bun: ~/.bun/bin/
• fnm 으로 설치한 Node 의 npm 글로벌
• npm config set prefix 로 직접 변경한 사용자 경로

4.1 가장 간단한 해결: npm 으로 다시 설치

이미 다른 매니저로 설치하셨더라도, npm 글로벌로 한 번 더 설치 하시면 MARV 가 즉시 인식합니다. 같은 도구가 두 곳에 깔려 있어도 충돌은 없으며, 가장 빠르고 안전한 회복법입니다.

npm install -g @google/gemini-cli

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

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

이미 설치한 도구를 그대로 사용하고 싶으시다면, 해당 도구의 글로벌 bin 디렉토리를 PATH 에 추가해 주세요.

1. 1

   셸 설정 파일 열기

   기본 셸이 zsh 라면 ~/.zshrc, bash 라면 ~/.bash_profile 을 텍스트 에디터로 엽니다. 파일이 없다면 새로 만드셔도 됩니다.

2. 2

   PATH export 줄 추가

   파일 끝에 다음과 같은 줄을 추가합니다. (예: bun)

   export PATH="$HOME/.bun/bin:$PATH"
   

3. 3

   새 터미널에서 확인

   저장 후 새 터미널 창 을 열고 which gemini 로 경로가 나오는지 확인합니다.

4. 4

   MARV 재실행

   Dock 에서 MARV 를 완전 종료한 뒤 다시 실행해 주세요. 셸 설정의 PATH 가 적용된 상태로 시작되어야 인식됩니다.

5. 그래도 해결이 안 될 때

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

• macOS 버전 (예: macOS 14 Sonoma, Apple Silicon / Intel)
• 어떤 AI 가 인식되지 않는지 (Claude / Codex / Gemini / Antigravity)
• 터미널에서 which <이름> 의 출력 결과
• 사용 중인 Node 설치 방식 (Homebrew / nvm / Volta / pnpm / Bun / 공식 인스톨러 등)
• MARV 로그 (앱 메뉴 → 도움말 → 로그 폴더 열기, 또는 설정 → 진단)

다음 단계

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