Grok Build CLI만 타임아웃인 이유: 브라우저 Grok과 다른 패스

Grok 웹이나 X 앱 안의 AI 패널은 Chromium·WebView가 시스템 HTTP 프록시를 상속받는 경우가 많습니다. 반면 Grok Build는 Node 기반 터미널 CLI로 동작하며, 설치 단계부터 npm이 npm registry와 tarball을 받는 CDN 엣지를 직접 두드립니다. 실행 후에는 x.ai 계열 API로 장시간 스트리밍 요청을 보내고, 최초 로그인 때 브라우저 OAuth와 loopback 콜백을 거칩니다. 이 세 층이 Clash 규칙 표에서 각각 다른 정책으로 찍히면, 사용자에게는 「Grok Build 전체가 죽었다」는 하나의 API 타임아웃 메시지만 보입니다.

2026년 국내·아시아 개발자 커뮤니티에서 흔한 패턴은 xAI 웹 호스트만 프록시 그룹에 넣고 registry.npmjs.org는 DIRECT로 두는 것입니다. npm 메타데이터는 빨리 받아도 tarball CDN이 다른 경로로 가면 설치가 99%에서 멈춥니다. 또는 설치는 성공했는데 api.x.ai만 다른 노드로 나가 TLS 핸드셰이크가 늘어지는 경우도 있습니다. 해결책은 대역폭이 아니라 「한 Grok Build 세션 = 한 라우팅 의도」로 이름 공간을 묶는 분류 라우팅입니다.

ℹ 먼저 할 일: 실패 직후 Clash 연결 로그를 열고 npm·x.ai·x.com(OAuth 시) 필터를 걸어 각 줄의 정책명이 같은지 비교하세요. 한 줄이라도 DIRECT와 프록시가 섞이면 노드 교체보다 규칙 보강이 우선입니다.

세 단계로 나누기: npm 설치 · OAuth · xAI API

장애를 한 덩어리로 보지 말고 단계별로 재현하세요. 1단계는 npm install -g grok-build(또는 프로젝트 로컬 설치)로, 실패 호스트는 대개 registry.npmjs.org·npmjs.com·패키지 tarball이 올라 있는 CloudFront/S3 스타일 호스트입니다. 2단계는 grok-build login 등으로 브라우저 OAuth를 여는 순간이며, x.ai 계정·문서 호스트와 x.com 리다이렉트, loopback 127.0.0.1 콜백이 시간적으로 겹칩니다. 3단계는 실제 코딩 에이전트 세션의 xAI API·스트리밍·도구 호출입니다.

각 단계에서 로그에 남은 SNI·Host를 표로 정리하면 YAML diff가 쉬워집니다. 「어제는 2단계만, 오늘은 3단계만」 깨진다면 규칙 세트 자동 갱신이나 CLI 버전 업데이트로 새 접미가 생긴 경우를 의심하세요. 공통 디버깅 틀은 연결 로그·TLS 타임아웃과 규칙 매칭 모범을 옆에 두면 좋습니다.

npm registry·tarball CDN: 설치가 막히는 첫 관문

npm registry는 단일 IP가 아닙니다. 메타데이터 조회(registry.npmjs.org)와 실제 패키지 바이너리를 받는 CDN 호스트가 분리되는 경우가 많고, 회사 미러(registry.npmmirror.com 등)를 쓰면 또 다른 이름 공간이 추가됩니다. Grok Build 패키지 본문은 작아도 의존성 트리가 크면 수십 개 호스트가 한 설치 안에 섞입니다.

npm만 글로벌 프록시로 보내고 xAI API는 DIRECT인 반대 조합도 같은 증상을 만듭니다. 설치와 런타임을 같은 유지보수 단위(GROK_BUILD_CLI)로 보는 편이 운영 부담이 적습니다. 컨테이너·CI에서 설치한다면 혼합 포트·환경 변수 절차도 함께 맞추세요.

xAI·Grok Build API 이름 공간

xAI 추론·계정·개발자 콘솔은 x.ai 및 하위 호스트에 집중되는 편입니다. Grok Build CLI가 호출하는 API 엔드포인트, 토큰 갱신, 사용량·과금 조회는 로그에서 api.·auth. 접두를 자주 보여 줍니다. OAuth가 X 계정과 연동되면 Grok·X·xAI 웹 분류 글에서 다룬 x.com·twitter.com·미디어 CDN 접미가 잠깐 올라올 수 있습니다 — CLI 세션 동안에도 같은 출구 의도를 유지하는 것이 안전합니다.

정적 에셋·에러 페이지·telemetry용 CDN 호스트는 메인 접미와 다른 경우가 있습니다. 「CLI니까 CDN은 없다」는 가정은 위험합니다. bootstrap JSON, feature flag, crash report 전송 등이 작은 HTTPS 요청으로 섞이면, 그 한 줄이 막혀 전체 wizard가 진행되지 않을 수 있습니다. 포럼의 고정 목록보다 본인 환경 연결 로그를 우선하세요.

웹 Grok 글과 무엇이 다른가

사이트의 Grok·X·xAI 웹 분류는 타임라인·Grok 패널·브라우저 DevTools 중심입니다. 본 글은 npm·glob 설치·shell 상속·바이너리 TLS 스택·장시간 터미널 스트림에 초점을 맞춥니다. 웹용 X_XAI 그룹이 있어도 npm registry 줄이 빠져 있으면 Grok Build는 여전히 설치에서 실패합니다. 반대로 npm만 맞추고 xAI API를 놓치면 로그인 후 대화만 타임아웃됩니다.

AI 코딩 도구 체인 전체를 보려면 Claude Code CLI·Codex CLI·OpenCode CLI 글과 나란히 두되, xAI·npm 조합은 별도 YAML 섹션으로 유지하는 것을 권장합니다.

GROK_BUILD_CLI 정책 그룹 설계

한 그룹으로 묶기

GROK_BUILD_CLI(이름은 자유) 하나에 npm·xAI·OAuth에 관여하는 접미를 모읍니다. 장시간 HTTPS·SSE에 견디는 노드를 뒤에 두고, 국내 뱅킹·LAN은 GEOIP,KR,DIRECT 등으로 앞에 유지합니다. 목표는 「전 세계 전부 프록시」가 아니라 Grok Build 사용자 여정 안에서 같은 TLS 품질을 공유하는 것입니다.

npm 전용 vs xAI 전용으로 나누기

NPM_REGISTRY와 XAI_API로 쪼개면 원인 특정은 쉬워지지만, 서로 지연이 다른 노드를 붙이면 스트림형 응답에서 줄이 교차하며 새 타임아웃이 생길 수 있습니다. 분리한다면 같은 리전·등급 노드를 문서화하세요.

예시 YAML: DOMAIN-SUFFIX와 순서

아래는 교육용 골격입니다. tarball CDN 호스트는 환경마다 다르니 로그에서 확인한 DOMAIN 줄을 GEOIP 앞에 추가하세요.

Illustrative YAML fragment

rules:
  - DOMAIN-SUFFIX,x.ai,GROK_BUILD_CLI
  - DOMAIN-SUFFIX,x.com,GROK_BUILD_CLI
  - DOMAIN-SUFFIX,npmjs.org,GROK_BUILD_CLI
  - DOMAIN-SUFFIX,npmjs.com,GROK_BUILD_CLI
  - GEOIP,KR,DIRECT
  - MATCH,DIRECT

DOMAIN-KEYWORD는 과포획 위험이 있어 임시 방편으로만 쓰고, 확인된 접미는 DOMAIN-SUFFIX로 옮기세요. 광고·추적 RULE-SET이 npm·xAI 줄 위에 있으면 설치 메타데이터가 조용히 실패할 수 있으니 순서 diff를 습관화하세요.

HTTPS_PROXY·mixed-port·TUN: 터미널 캡처

많은 팀이 export HTTPS_PROXY=http://127.0.0.1:7890처럼 mixed-port를 가리킵니다(포트는 프로필에 맞게 변경). npm과 Grok Build가 이 변수를 존중하면 Clash UI에 연결이 바로 보입니다. 무시하는 빌드·자식 프로세스가 있으면 TUN으로 소켓 전체를 캡처하는 편이 낫습니다 — macOS·Windows에서는 시스템 확장 충돌을 먼저 확인하세요(TUN 심화).

OAuth loopback(127.0.0.1)은 NO_PROXY에 넣어 upstream 프록시가 로컬 리스너까지 끌고 가지 않게 하세요. SSH 점프·Dev Container·원격 CI에서는 shell 상속이 끊기므로 각 레이어에서 동일한 프록시 또는 TUN 정책을 재적용해야 합니다.

DNS·fake-ip·스니핑 정렬

이름이 빠르게 풀려도 규칙 적중이 어긋나면 「DNS는 OK, TCP는 영원히 pending」 패턴이 납니다. fake-ip 모드에서는 DOMAIN 규칙 커버리지와 스니핑 설정이 같이 가야 합니다. OS DoH·회사 split-horizon·Clash 내장 DNS가 동시에 싸우면 브라우저 OAuth와 터미널 API가 다른 IP 의미를 갖게 됩니다. Meta DNS nameserver·fallback·fake-ip를 읽고 테스트 창 동안 해석 경로를 하나로 줄이세요.

RULE-SET·구독 갱신

원격 규칙 세트는 xAI·npm 접미 변화를 따라가는 데 유용하지만, 갱신 URL 자체가 잘못된 출구로 가면 목록이 낡아 MATCH,DIRECT에 새 호스트가 떨어집니다. 구독·노드 유지와 같이 RULE-SET fetch 경로를 점검하고, 비상용으로 직접 소유한 baseline YAML을 두세요.

Codex·Claude Code와 비교: 방법만 복사

OpenAI Codex CLI는 openai.com·oaistatic.com 패밀리, Claude Code는 anthropic.com·claude.ai 패밀리를 중심으로 합니다. Grok Build는 x.ai + npm registry + (OAuth 시) X 호스트가 한 세션에 섞인다는 점이 다릅니다. Codex·Claude 글의 「로그 수집 → 한 출구 의도 → DNS 정렬 → TUN 검증」 순서는 그대로 쓰되, 도메인 표는 Grok Build 로그에서 새로 채우세요.

검증 체크리스트·로그 해석

  1. 현 네트워크·계정에서 Clash·xAI·npm 사용이 허용되는지 확인합니다.
  2. npm install -g grok-build 실패 시 registry·tarball 호스트와 정책명을 기록합니다.
  3. OAuth 재현 시 x.ai·x.com·loopback 줄을 동시에 봅니다.
  4. API 호출 시 x.ai 하위 호스트가 모두 GROK_BUILD_CLI인지 확인합니다.
  5. GEOIP·광범위 RULE-SET이 vendor 줄을 가리지 않는지 순서를 diff합니다.
  6. DNS fake-ip·fallback이 outbound와 모순되지 않는지 봅니다.
  7. 원격 규칙 세트·구독이 최신인지 확인합니다.
  8. 로컬 변수를 제거한 뒤에만 노드·xAI 상태 페이지를 의심합니다.
⚠ 준수 알림: 현지 법령, xAI·npm·X 서비스 약관, 고용·학내 정책을 따르세요. 본문은 허용된 네트워크에서의 라우팅 위생을 설명하며, 무단 접근·통제 회피를 조장하지 않습니다.

자주 묻는 질문

미러 레지스트리(npm.taobao.org 등)를 쓰면 Grok Build 설치가 쉬워지나요?

미러가 공식 tarball과 동기화되어 있고 회사 정책상 허용되면 레이턴시는 줄 수 있습니다. 다만 미러 호스트도 Clash 규칙에 명시해야 하며, xAI API 줄과 무관하게 설치만 해결되는 것은 아닙니다. 미러와 공식 registry가 섞이면 더 복잡해질 수 있으니 한 세션 안에서는 출처를 통일하세요.

스트리밍·긴 코딩 세션만 타임아웃됩니다.

짧은 REST ping은 통과하는데 SSE·장시간 연결만 끊기면 NAT·중간박스 idle timer·불안정 노드 가능성이 큽니다. 라우팅이 일관된 상태에서 노드를 바꿔 보고, 로그에 mid-stream reset이 반복되는지 확인하세요.

Grok Build 업데이트 후 갑자기 깨졌습니다.

새 버전이 추가 telemetry 접미나 다른 OAuth IdP를 쓰면 기존 YAML에 구멍이 생깁니다. 업데이트 직후 연결 로그 diff가 가장 빠른 대응입니다.

맺음말

Grok Build CLI의 API 타임아웃은 단일 장애보다 npm registry·tarball CDN·xAI API·OAuth 줄이 Clash에서 서로 다른 출구를 타거나, 터미널이 프록시 체인에 아예 들어오지 못할 때 자주 재현됩니다. 웹 Grok만 맞춰 둔 프로필을 그대로 쓰면 CLI·설치 시나리오는 여전히 비어 있습니다.

원클릭 VPN·고정 프로필 라우터는 호스트별 적중 내역을 보여 주지 않아 「전역 스위치」만 반복하게 됩니다. 반면 Clash는 DOMAIN-SUFFIX·규칙 세트·라이브 연결 로그로 npm 한 줄과 xAI 한 줄이 갈라진 순간을 포착할 수 있습니다. Clash V.CORE는 터미널·멀티 스트림·원격 RULE-SET 갱신을 한 패널에서 다루기 쉽게 정리해 두어, Grok Build처럼 설치·로그인·장시간 API가 이어지는 AI 코딩 에이전트 워크플로에 맞는 출발점을 제공합니다.

→ Clash를 무료로 다운로드하고, 이번에 정리한 xAI·npm 접미 표를 라이브 로그로 교차 검증해 보세요. 설치와 OAuth에 쓰던 시간을 실제 코딩에 돌릴 수 있습니다.