Grok Build README — 한국어 전문 번역

주의 원문은 커밋마다 변할 수 있다. 이 문서는 위 확보 일시 기준 스냅샷의 번역이다. 근거 원문은 snapshots/grok-build-snapshot-20260801.md.

Grok Build (grok)

(로고: SpaceXAI 심벌 이미지)

Grok Build는 SpaceXAI의 터미널 기반 AI 코딩 에이전트입니다. 코드베이스를 이해하고, 파일을 편집하고, 셸 명령을 실행하고, 웹을 검색하고, 장기 실행 작업(long-running tasks)을 관리하는 전체 화면 TUI(터미널 UI)로 동작합니다 — 대화형으로, 스크립팅/CI를 위한 헤드리스(headless)로, 또는 에이전트 클라이언트 프로토콜(Agent Client Protocol, ACP)을 통해 에디터에 임베드되어.

릴리스 바이너리 설치 ·

소스에서 빌드 ·

문서 ·

저장소 구조 ·

개발 ·

기여하기 ·

라이선스

(이미지: Grok Build TUI 스크린샷)

Grok Build에 대해 더 알아보려면 x.ai/cli

이 저장소는 grok CLI/TUI와 그 에이전트 런타임의 Rust 소스를 담고 있습니다. SpaceXAI 모노레포에서 주기적으로 동기화됩니다.

루트의 작은 SOURCE_REV 파일이, 이 트리에 존재하는 코드 버전에 해당하는 모노레포의 전체 커밋 SHA를 기록합니다.

---

릴리스 바이너리 설치

macOS, Linux, Windows용 사전 빌드 바이너리가 배포됩니다:

curl -fsSL https://x.ai/cli/install.sh | bash   # macOS / Linux / Git Bash
irm https://x.ai/cli/install.ps1 | iex          # Windows PowerShell
grok --version

[역주] 코드 블록은 실행 가능성 보존을 위해 원문 그대로 둔다. 주석 번역: macOS / Linux / Git Bash · Windows PowerShell.

각 릴리스의 최신 수정·기능·개선 사항은 changelog를 참조하세요.

소스에서 빌드

요구사항:

• Rust — 툴체인은 rust-toolchain.toml로 고정되며, 첫 빌드 시 rustup이 자동으로 설치합니다.
• DotSlash — bin/ 아래의 밀폐형(hermetic) 도구(특히 bin/protoc)가 다운로드·실행될 수 있도록 필요합니다. 빌드 전에 설치하고 dotslash가 PATH에 있는지 확인하세요:

  cargo install dotslash
  # or: prebuilt packages — https://dotslash-cli.com/docs/installation/
  /usr/bin/env dotslash --help   # sanity check

  [역주] 주석 번역: 또는 사전 빌드 패키지 — (링크) / 정상 동작 확인(sanity check).

• protoc — proto 코드 생성은 DotSlash를 통해 bin/protoc를 해결하거나, PATH / $PROTOC의 protoc로 폴백합니다.
• macOS와 Linux는 지원되는 빌드 호스트입니다; Windows 빌드는 best-effort이며 현재 이 트리에서 테스트되지 않습니다.

cargo run -p xai-grok-pager-bin              # build + launch the TUI
cargo build -p xai-grok-pager-bin --release  # release binary: target/release/xai-grok-pager
cargo check -p xai-grok-pager-bin            # fast validation

[역주] 주석 번역: TUI 빌드 + 실행 / 릴리스 바이너리: target/release/xai-grok-pager / 빠른 검증.

바이너리 아티팩트의 이름은 xai-grok-pager이며, 공식 설치본은 이를 grok으로 배포합니다. 첫 실행 시 인증을 위해 브라우저가 열립니다 — 인증 가이드를 참조하세요.

문서

전체 온라인 문서는 docs.x.ai/build/overview에 있습니다.

사용자 가이드는 pager 크레이트에 함께 배포됩니다: crates/codegen/xai-grok-pager/docs/user-guide/ — 시작하기, 키보드 단축키, 슬래시 명령, 설정, 테마, MCP 서버, 스킬, 플러그인, 훅, 헤드리스 모드, 샌드박싱 등.

저장소 구조

중요 루트의 Cargo.toml(워크스페이스 멤버, 의존성 버전, 린트, 프로파일)은 생성물입니다 — 읽기 전용으로 취급하세요. 크레이트별 Cargo.toml 파일을 편집하는 것을 권장합니다.

개발

cargo check -p <crate>        # always target specific crates; full-workspace builds are slow
cargo test -p xai-grok-config # per-crate tests
cargo clippy -p <crate>       # lint config: clippy.toml at the repo root
cargo fmt --all               # rustfmt.toml at the repo root

[역주] 주석 번역: 항상 특정 크레이트를 대상으로 — 전체 워크스페이스 빌드는 느리다 / 크레이트별 테스트 / 린트 설정: 저장소 루트의 clippy.toml / 저장소 루트의 rustfmt.toml.

기여하기

참고 외부 기여는 받지 않습니다. CONTRIBUTING.md를 참조하세요.

라이선스

이 저장소의 first-party 코드는 Apache License, Version 2.0으로 라이선스됩니다 — LICENSE를 참조하세요.

제3자 및 벤더링된 코드는 원래의 라이선스를 유지합니다. 참조:

• THIRD-PARTY-NOTICES — crates.io / git 의존성, 번들된 UI 테마, 그리고 인트리 소스 포트(in-tree source ports)(openai/codex 및 sst/opencode 도구 구현 포함)
• crates/codegen/xai-grok-tools/THIRD_PARTY_NOTICES.md — codex 및 opencode 포트에 대한 크레이트별 고지(라이선스 전문 + Apache §4(b) 변경 고지)
• third_party/NOTICE — 벤더링된 Mermaid 스택 색인

---

부록 A — 라이선스 고지 (공개 시 필수)

이 문서는 Apache License 2.0으로 배포되는 xai-org/grok-build 저장소의 README.md를 한국어로 번역한 것이다. 원저작권은 SpaceXAI(및 기여자)에게 있으며, 원문 라이선스 전문은 저장소의 LICENSE 파일에서 확인할 수 있다.

중요 — 이 저장소는 단일 라이선스가 아니다. first-party 코드만 Apache 2.0이며, 저장소에는 원 라이선스를 유지하는 인트리 소스 포트가 포함된다: 도구 구현(xai-grok-tools)은 openai/codex와 sst/opencode의 코드 포트를 포함하고, 이에 대한 라이선스 전문과 Apache §4(b) 변경 고지는 THIRD-PARTY-NOTICES 및 크레이트별 THIRD_PARTY_NOTICES.md에 있다. 벤더링된 Mermaid 스택은 third_party/NOTICE를 따른다. 재배포·번역 공개 시 이 고지들을 함께 유지해야 한다.

번역 오류의 책임은 루프노트에 있으며, 원문과 번역이 다를 경우 원문이 우선한다.

부록 B — 용어집 (이 문서에서 확정된 번역어)

부록 C — 검증 메모

• 이 번역의 근거 원문은 2026-08-01 09:29 KST에 직접 수집한 raw README 스냅샷이다(snapshots/grok-build-snapshot-20260801.md). 버전 고정값 SOURCE_REV = 8d69c91f02bcacf01e98d5aebbf2f92547c45738.
• 원문 확보 시점의 저장소 표시값: 라이선스 Apache-2.0, 주 언어 Rust, 기본 브랜치 main, 17 commits, 약 23.7k stars / 4.5k forks(GitHub 배지 기준 — 실시간 변동, 인용 시 시각 병기).
• 원문에서 직접 확인된 특기사항(✔): 도구 구현이 openai/codex·sst/opencode의 인트리 소스 포트를 포함한다는 사실은 README License 절에 명문화돼 있다. 기사에서 ✔ 원문 등급으로 사용 가능.
• README에 없는 것(후속 정본화·검증 대상): 실제 도구 목록 세부, 권한·샌드박스 규칙, ACP 스펙 세부, 슬래시 명령·훅·스킬 목록 — 이들은 pager 크레이트의 docs/user-guide/ 및 코드 확인 후 별도 정본으로 진행한다.
• 미확보(✖/△): 공식 발표문(x.ai/news/grok-build-open-source)은 HTTP 403으로 1차 미확보. 출시 연혁(2026-05-25 베타 시작, 2026-07-16 오픈소스화)은 복수 2차 보도 일치(△) 기준이다 — MarkTechPost(2026-07-15), explainx.ai, GIGAZINE(2026-07-16) 등이 동일 날짜를 보도. 단 이는 1차(x.ai 발표문·저장소 태그) 미확인 상태이므로, 후속에서 gh 릴리스/커밋 또는 x.ai 발표문 재확보로 ✔로 승급할 대상. 근거 원문 스냅샷에는 이 날짜가 없다(README 자체는 출시일을 명시하지 않음).

개정 이력

원문이나 우리 판단이 바뀌면 여기에 추기한다. 기존 서술을 소리 없이 고치지 않는다.