윈도우에서 그록 CLI를 설치했는데 ‘grok을 인식할 수 없습니다’가 나온다면, 먼저 Get-Command grok -All로 실행 경로를 확인하세요. 버전이 정상 출력되는데 로그인에서 멈춘다면 설치보다는 인증·네트워크 쪽을 살펴볼 차례입니다. 이 글은 공식 Grok Build의 윈도우 PowerShell 환경을 기준으로, 증상에 맞는 확인 명령과 다음 행동을 정리합니다.
확인일: 2026년 9월 20일. PC Wise AI의 Windows 환경에서 Grok 1.0.13의 버전·실행 경로·로그인 도움말을 확인했습니다. 아래의 오류별 설명은 공식 문서와 해당 확인 결과를 바탕으로 작성했으며, 모든 오류를 직접 재현했다는 뜻은 아닙니다.
먼저 내 증상에 맞는 줄을 고르세요
| 보이는 증상 | 첫 확인 | 다음 행동 |
|---|---|---|
| grok 명령을 찾지 못함 | Get-Command grok -All | 설치 방식과 PATH 확인 |
| 업데이트했는데 예전 버전이 나옴 | 실행 경로가 몇 개인지 확인 | 어느 설치본을 업데이트했는지 대조 |
| grok.ps1 실행이 정책 때문에 차단됨 | 오류에 나온 파일명 확인 | 공식 npm 설치본의 grok.cmd 확인 |
| 버전은 나오지만 로그인에 실패함 | grok login –help | 브라우저·기기 코드 인증 경로 점검 |
| API 요청에서 401·429가 나옴 | 인증 방식과 응답 본문 확인 | 키·권한 또는 사용량 제한 확인 |
1. 공식 설치 안내에서 운영체제를 먼저 맞추기
현재 Grok Build 공식 문서에는 macOS/Linux/WSL과 Windows(PowerShell) 설치 탭이 따로 있습니다. 윈도우 PowerShell에서 작업한다면 Windows 탭을 선택하세요. WSL 터미널과 윈도우 PowerShell은 서로 다른 실행 환경이라, 한쪽에 설치한 명령이 다른 쪽에서도 바로 잡힌다고 볼 수 없습니다.
npm으로 설치하는 경우 공식 저장소가 안내하는 패키지는 @xai-official/grok입니다. 처음 설치하는 과정은 그록 CLI 설치 방법에서 보고, 이미 설치했다면 아래의 조회부터 진행하면 됩니다. 조회 명령만으로는 재설치나 업데이트가 일어나지 않습니다.
2. grok 명령을 찾지 못하면 설치 경로부터 확인
PowerShell에서 다음 두 줄을 각각 실행합니다.
Get-Command grok -All
where.exe grokGet-Command는 PowerShell이 찾는 명령을 보여 줍니다. -All을 붙이면 같은 이름으로 잡히는 다른 후보도 확인할 수 있습니다. 두 번째 줄은 where가 아닌 where.exe까지 입력해야 윈도우의 실행 파일 검색 도구를 확실히 호출합니다. Microsoft의 명령 우선순위 설명에 이 차이가 나옵니다.
아무 경로도 나오지 않는다면 설치 직후 열려 있던 터미널을 닫고 새 터미널에서 다시 확인합니다. 그래도 없다면 설치 완료 여부를 살펴보세요. npm 설치를 선택했다면 아래 결과에서 공식 패키지가 있는지와 전역 설치 위치를 확인할 수 있습니다.
npm.cmd list -g @xai-official/grok --depth=0
npm.cmd prefix -gnpm.cmd도 찾지 못하면 Node.js/npm을 설치했는지, 지금 터미널이 해당 설치를 인식하는지부터 확인해야 합니다. 반면 공식 단독 설치 프로그램을 사용했다면 npm 목록에 없다는 이유만으로 설치 실패라고 판단하지 마세요.
npm 공식 문서에 따르면 Windows의 전역 실행 파일은 npm의 prefix 폴더에 연결됩니다. 실제 prefix 폴더가 PATH에 들어 있는지가 핵심입니다. 다른 PC의 경로를 그대로 복사하거나 기존 PATH 전체를 덮어쓰지 말고, 내 PC에서 확인한 폴더를 기준으로 판단하세요.
3. 같은 grok이 여러 개 보이면 ‘실제로 실행되는 것’을 구분
설치 방식이 섞이면 동일한 명령 이름이 여러 경로에 나타날 수 있습니다. 확인 환경에서도 단독 실행 파일과 npm 실행용 파일이 함께 발견됐습니다. 다음은 실제 조회 결과에서 사용자 경로를 환경변수 표기로 바꾼 발췌입니다.
%USERPROFILE%\.grok\bin\grok.exe
%APPDATA%\npm\grok.ps1
%APPDATA%\npm\grok.cmd여러 파일이 있다는 사실만으로 충돌이나 비공식 설치를 확정할 수는 없습니다. npm의 .ps1과 .cmd는 같은 패키지를 실행하는 파일일 수도 있습니다. 우선 선택되는 경로는 다음 명령으로 따로 확인합니다.
Get-Command grok | Select-Object Name,Source
grok --version업데이트 전후의 경로와 버전을 같이 기록하면 “npm 설치본은 바뀌었지만 다른 경로의 grok이 먼저 실행되는 상황”을 구별할 수 있습니다. 사용하지 않을 설치본 정리는 경로와 설치 방식을 확인한 뒤 진행하세요. 세션·설정이 들어 있는 .grok 폴더 전체 삭제를 첫 해결책으로 삼을 이유는 없습니다.
4. PowerShell에서 grok.ps1이 차단될 때
오류에 grok.ps1 또는 npm.ps1과 함께 스크립트 실행 정책이 표시된다면, 명령 자체를 못 찾는 경우와 구분해야 합니다. 공식 npm 패키지를 설치했고 실행 파일도 그 설치본에 연결되어 있는지 확인한 다음, 해당 폴더의 grok.cmd로 버전 조회를 해볼 수 있습니다.
$grokPrefix = (npm.cmd prefix -g).Trim()
Test-Path (Join-Path $grokPrefix 'grok.cmd')
& (Join-Path $grokPrefix 'grok.cmd') --versionTest-Path가 True일 때 마지막 줄을 실행하세요. False라면 해당 위치에 파일이 없으므로 설치 경로를 다시 확인합니다. 이 확인은 PowerShell의 .ps1 선택 문제를 나누어 보는 절차이며, 조직에서 프로그램 실행 자체를 제한한 정책을 해제하는 방법은 아닙니다.
5. 버전은 나오는데 로그인에서 멈춘다면
버전 문자열이 정상적으로 나온다면 실행 파일을 찾는 단계는 통과한 것입니다. 현재 공식 문서는 브라우저 로그인과 기기 코드 로그인을 모두 안내합니다. 설치한 버전에서 지원하는 옵션은 먼저 도움말로 확인하세요.
grok login --help일반 브라우저 로그인은 grok login, 브라우저를 직접 열기 어려운 원격 환경의 기기 코드 방식은 grok login --device-auth입니다. 확인 환경의 1.0.13 도움말에서도 두 인증 경로를 확인했습니다.
회사 네트워크에서만 실패한다면 공식 네트워크·인증 안내와 오류 메시지를 관리자에게 전달하세요. 브라우저 인증에 사용하는 auth.x.ai, 추론 프록시 cli-chat-proxy.grok.com, API 키 경로의 api.x.ai는 역할이 다릅니다. 로그인 창이 안 열린다는 이유만으로 유료 API 키 경로로 바꾸기보다 어느 연결에서 멈췄는지 먼저 확인하는 편이 낫습니다.
API 방식에서 401은 인증 정보, 429는 요청 제한과 관련해 살펴볼 코드입니다. xAI API 오류 문서와 실제 응답 본문을 함께 확인하세요. 구독 로그인 화면에서 보이는 오류까지 API 오류표 하나로 해석할 수는 없습니다.
문의할 때 남길 정보 네 가지
- 사용한 터미널: Windows PowerShell, PowerShell 7, WSL 중 무엇인지
grok --version결과- 실행 파일 경로와 설치 방식: 공식 설치 프로그램 또는 npm
- 실패한 명령과 오류 문구: API 키·토큰·개인 경로는 가리고 전달
“설치가 안 된다”보다 이 네 가지를 함께 적으면 설치 실패, 실행 경로, 인증 실패 중 어디를 봐야 할지 훨씬 명확해집니다.
이어서 읽기
공식 패키지와 플랫폼 확인: xAI 공식 저장소의 Grok README. 안내 화면과 지원 명령은 버전에 따라 달라질 수 있습니다.
답글 남기기