그록 CLI 설치 방법 — 공식 Grok Build 명령어와 사용법

그록 CLI(공식 명칭 Grok Build)는 xAI의 터미널 AI 에이전트입니다. 시작하기 전에 하나만 조심하세요 — npm에는 이름이 비슷한 비공식 패키지가 여럿 있습니다. 공식은 xAI 보안팀(security@x.ai)이 관리하는 @xai-official/grok 하나뿐입니다.

npm install -g @xai-official/grok

설치 — 윈도우와 맥

윈도우·맥·리눅스 모두 위 npm 명령으로 설치됩니다(Node.js LTS 필요 — 윈도우 winget install OpenJS.NodeJS.LTS, 맥 brew install node). 맥·리눅스는 공식 스크립트도 있습니다:

curl -fsSL https://x.ai/cli/install.sh | bash

설치 확인은 grok --version. 업데이트는 전용 명령이 따로 있습니다:

grok update

첫 실행 — 로그인과 시작 메뉴

터미널에서 grok을 입력하면 시작됩니다. 첫 실행 시 브라우저가 열리며 X(그록) 계정으로 로그인합니다. 서버나 자동화 환경처럼 브라우저가 없는 곳에서는 console.x.ai에서 API 키를 발급받아 환경변수로 넣으면 됩니다:

export XAI_API_KEY="xai-..."

기본 사용법

• 시작 메뉴에서 New worktree로 새 작업을 열고, Resume session으로 지난 작업을 이어갑니다.
• 대화형이 아니라 한 번만 시키려면: grok -p "이 코드베이스 설명해줘"
• /model — 사용할 그록 모델을 바꿉니다.
• /feedback — 버그를 만나면 앱 안에서 바로 제보할 수 있습니다.

설치가 안 될 때

• “grok을 찾을 수 없습니다” — 터미널 재시작(PATH 갱신).
• 엉뚱한 프로그램이 실행됨 — 비공식 유사 패키지를 깔았을 가능성이 큽니다. @xai-official/grok인지 다시 확인하세요.
• 로그인 실패 — 브라우저 로그인이 막힌 환경이면 API 키 방식으로 우회하면 됩니다.

같이 보면 좋은 글

Claude Code·Codex·Gemini까지 네 가지 CLI 설치 명령을 한 번에 보려면 AI 코딩 CLI 설치 총정리를 참고하세요.

참고: @xai-official/grok — npm 공식 패키지