Grok Build는 추정 이름이나 비공식 래퍼가 아니다. xAI가 문서와 소스 저장소를 공개한 공식 코딩 에이전트이며 대화형 TUI, 헤드리스 실행, ACP 연동을 지원한다. 다만 2026년 8월 31일 현재 시작 문서는 Grok 4.6을 안내한다. 따라서 Grok 4.5가 지금도 기본 모델이라고 단정하지 말고, CLI 설치와 모델 선택을 별개로 확인해야 한다. 저장소의 조직명과 라이선스까지 대조하면 이름이 비슷한 제3자 패키지를 피할 수 있다.
설치 전 판정표
| 확인 대상 | 통과 증거 | 멈춰야 하는 경우 |
|---|---|---|
| 배포 주체 | docs.x.ai 설치 문서와 xai-org/grok-build 저장소가 일치 |
제3자 패키지명만 보임 |
| 실행 파일 | grok version과 grok update --check가 응답 |
경로가 낯선 바이너리를 가리킴 |
| 로드 범위 | grok inspect 결과를 설명할 수 있음 |
모르는 훅·MCP·플러그인이 로드됨 |
| 권한 | 첫 세션이 Ask이고 샌드박스를 따로 확인 | Always-approve가 켜진 이유를 모름 |
macOS·Linux·WSL의 공식 설치 명령은 아래와 같다. 설치 스크립트를 바로 셸에 넘기기 불편하다면 먼저 파일로 받아 내용을 확인해도 된다. Windows는 같은 문서의 PowerShell 탭을 따라야 한다.
curl -fsSL https://x.ai/cli/install.sh | bash
grok version
grok update --check첫 실행은 프로젝트 폴더에서 grok이다. 브라우저 인증을 열 수 없는 환경에서는 grok login --device-auth 또는 XAI_API_KEY를 쓴다. 키를 명령줄 인수나 저장소 파일에 적지 말고 환경 변수와 비밀 저장소로 분리한다.
첫 10분 검증 절차
- 빈 연습 저장소나 별도 worktree로 이동해
git status --short를 기록한다. grok inspect를 실행해 사용자·프로젝트 설정, 지침, 스킬, 플러그인, 훅, MCP의 출처를 적는다.- Ask 모드에서 “파일을 수정하지 말고 구조와 테스트 명령만 요약하라”고 요청한다.
- 설명이 실제 경로와 맞을 때 문구 한 줄처럼 원복 가능한 변경만 맡긴다.
git diff와 실제 테스트 결과를 직접 확인하고 원복까지 수행한다.
기존 원고의 grok doctor는 일반 진단 명령처럼 쓰면 안 된다. 공식 CLI 참조에 있는 것은 MCP 연결을 점검하는 grok mcp doctor다. 전체 로드 상태는 grok inspect로 확인한다. 명령을 외우기보다 현재 설치본의 grok --help와 공식 참조를 대조하는 편이 안전하다.
Ask와 Plan을 혼동하지 않는다
권한 문서에서 Ask는 허용되지 않은 도구 호출을 묻는 기본 모드다. Auto와 Always-approve는 승인 범위를 넓히지만 deny 규칙과 사전 훅이 모든 위험을 대신 막아 주지는 않는다. 첫날에는 Ask를 유지한다.
Plan 모드는 편집 전에 계획을 만드는 흐름이지 완전한 읽기 전용 샌드박스가 아니다. 셸 명령은 파일을 쓸 수 있고 하위 에이전트에는 부모의 편집 차단이 그대로 적용되지 않을 수 있다. 그래서 계획 화면에서도 변경 파일, 실행 명령, 테스트, 원복 방법을 검토해야 한다.
합격과 중단 기준
설치 성공은 프롬프트에 답했다는 뜻이 아니다. 바이너리 출처, 로드된 확장, 현재 모델, 권한·샌드박스, 바뀐 파일과 테스트를 스스로 설명할 수 있을 때 합격이다. 반대로 출처 불명 바이너리, 예상 밖 훅, 저장소 밖 쓰기 요청, 검증 없이 Always-approve를 요구하는 상황이면 즉시 중단한다. 이 기준을 통과한 뒤에만 실제 저장소로 범위를 넓힌다.