Grok Build CLI入門 — xAIのコーディングエージェントを使いこなす

Last updated at 2026-06-04Posted at 2026-06-04

はじめに

xAI が、ターミナルで動作するコーディングエージェント Grok Build を公開しました。Claude Code（Anthropic）や Codex CLI（OpenAI）と同じ「ターミナル常駐型のAIコーディングエージェント」というカテゴリに、xAI が本格参入した形になります¹。

この記事では、公式ドキュメント（docs.x.ai）と公開情報をもとに、Grok Build CLI の全体像・セットアップ・主要機能・既存ツールとの違いを整理します。

この記事で解決できること

Grok Build がどんなツールなのかを把握する
インストールから初回起動までの手順を理解する
Plan Mode・サブエージェント・MCP 連携など主要機能の使い方を理解する
Claude Code / Codex CLI との位置づけの違いを整理する

対象読者

ターミナル型のAIコーディングエージェントに関心があるエンジニア
既に Claude Code / Codex CLI を使っていて、Grok Build との違いを知りたい方

前提知識

ターミナル（シェル）の基本操作
AIコーディングエージェントの基本概念（プロンプトでコードを生成・編集する仕組み）

TL;DR

Grok Build は xAI 製のターミナル型コーディングエージェントで、モデルは grok-build-0.1²
インストールは curl -fsSL https://x.ai/cli/install.sh | bash、起動は grok の1コマンド
Plan Mode（実行前に計画を承認）・並列サブエージェント・MCP/AGENTS.md 互換・ローカルファースト設計が主要な特徴
ヘッドレス実行（grok -p "..."）に対応し、CI への組み込みも可能
提供は SuperGrok / X Premium+ 系のサブスクライバー向け early beta（2026年5月末公開）

Grok Build とは

Grok Build は、自然言語の指示を受け取り、プロジェクト全体に対して自律的に計画・記述・編集・実行を行うコマンドラインのコーディングエージェントです¹。ターミナルにそのまま常駐し、ファイル編集・シェルコマンド実行・依存関係の管理などを担います。

位置づけとしては、以下のような近年のAIコーディングエージェントの一群に加わるツールです（うちターミナル常駐型は Claude Code・Codex CLI・Grok Build）。

Claude Code（Anthropic）— ターミナル常駐型
Codex CLI（OpenAI）— ターミナル常駐型
Cursor（IDE型。Composer / Agent モードを提供）
Grok Build（xAI） ← New（ターミナル常駐型）

バックエンドのモデルは、エージェント型ソフトウェアエンジニアリング向けに用意された grok-build-0.1 です²。

コンテキスト長は、公式モデルカード（docs.x.ai）では 256,000 トークン と記載されています²。一方でサブスクリプション料金については、提供開始時期や対象プランで複数の値が流通しているため、本記事では断定せず公式の料金ページを参照する方針とします。

セットアップ

インストール

公式ドキュメントによると、インストールはワンライナーで実行できます³。

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

# Windows (PowerShell)
irm https://x.ai/cli/install.ps1 | iex

npm パッケージではなく、シェルスクリプト経由で配布される点が特徴です。

起動と認証

プロジェクトのディレクトリに移動し、grok を実行すると対話型のTUIセッションが立ち上がります。初回起動時はブラウザが開き、サインインによって認証が完了します³。

cd your-project
grok

ブラウザを使えないサーバー環境（CI など）では、APIキーを環境変数で渡します。

export XAI_API_KEY="xai-..."
grok

基本操作

対話モードとヘッドレスモード

grok だけで起動すると対話型TUIになりますが、-p フラグを付けるとヘッドレス（非対話）で1回の指示を実行できます³。

# ヘッドレス実行（1回の指示）
grok -p "Explain this codebase"

# JSON ストリーミング出力（パイプ処理向き）
grok -p "Add unit tests for auth module" --output-format streaming-json

CI などで対話的な承認を省略したい場合は --always-approve を使えますが、書き込みを無条件に許可するため、利用には注意が必要です。

grok --always-approve

設定ファイル

設定は TOML で管理されます。グローバル設定は ~/.grok/config.toml、プロジェクト単位の設定は .grok/config.toml に置けます³。

# ~/.grok/config.toml
[ui]
permission_mode = "always-approve"   # または "ask"

公式ドキュメントによると、permission_mode はグローバルの ~/.grok/config.toml に置く必要があり、プロジェクトスコープの .grok/config.toml では有効になりません³。承認の挙動を変える設定はグローバル側で管理してください。

Plan Mode — 実行前に計画を承認する

Grok Build の中核機能のひとつが Plan Mode です。複雑なタスクでは、いきなりコードを書き換えるのではなく、まず実行計画を提示し、開発者が承認するまで書き込み系のツールをブロックします⁴。

Shift+Tab でセッションのモードをサイクルし、Plan Mode に切り替える
/plan コマンドでは、現在のセッション計画を確認できる
計画が承認されるまで、書き込みツールはセッションの計画ファイル以外をブロック
承認後、変更はクリーンな差分（diff）として表示される

計画の各ステップにコメントを付けたり、計画全体を書き直したりしてから実行に移せるため、大規模な変更の暴走を防ぎやすい設計になっています。

サブエージェントによる並列実行

大きめのタスクでは、メインのエージェントが専門化したサブエージェントを並列に起動して作業を分担します⁴。

各サブエージェントは独自のコンテキストウィンドウと定義済みのペルソナを持つ
例: 差分をレビューする reviewer サブエージェントと、次の実装を書く implementer サブエージェントを同時に動かす
サブエージェントは隔離された worktree 上で動けるため、並列編集がメインブランチを壊さない

報道では、最大で8つのサブエージェントを同時に起動できるとされています¹。大規模コードベースに対して、複数の作業を並行して進められる点が強みです。

既存資産との互換性 — AGENTS.md / MCP / プラグイン

Grok Build は、既存のエージェント設定資産をそのまま活用できるよう設計されています⁴。

仕組み	役割
`AGENTS.md`	リポジトリの規約・指示をエージェントに伝える
MCP サーバー	外部ツール・データソースとの接続（Model Context Protocol）
hooks	特定タイミングでの処理フック
skills	ユーザー起動可能なスキル
plugins	機能拡張

TUI 内では以下のコマンドで各機能にアクセスできます³。

grok inspect — 検出された設定・AGENTS.md・プラグイン・hooks・skills・MCP エンドポイントを事前確認
/plugins — プラグイン一覧
/skills — スキル一覧
/mcps — MCP サーバー連携

AGENTS.md や Claude Code 系の設定ファイルを認識するため、既存のワークフローをゼロから組み直さずに移行を試しやすいのもポイントです¹。

ローカルファーストと Arena Mode

ローカルファースト設計

Grok Build はローカルファーストを掲げており、ソースコードを xAI のサーバーへ送信しない設計とされています¹。プロプライエタリなコードベースを扱うチームや、規制業界での利用を意識した設計判断です。

Arena Mode

他ツールと差別化される機能として Arena Mode があります。複数の候補出力を開発者がレビューする前に、自動評価レイヤーがスコアリング・ランク付けを行う仕組みです¹。手動で複数解を比較する手間を減らすことを狙っています。

CI・自動化での活用

ヘッドレスモード（-p）と JSON ストリーミング出力（--output-format streaming-json）を組み合わせることで、CI パイプラインへ組み込めます。

# 例: CI でテスト追加を依頼し、結果を JSON で受け取る
grok -p "Add unit tests for the auth module" \
  --output-format streaming-json

API 経由で grok-build-0.1 を直接呼び出すことも可能です³。

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-build-0.1", "input": "Refactor this function..."}'

Claude Code / Codex CLI との位置づけ

ターミナル型エージェントとしての主な共通点・差分を整理します。

観点	Grok Build	Claude Code	Codex CLI
提供元	xAI	Anthropic	OpenAI
実行形態	ターミナル常駐	ターミナル常駐	ターミナル常駐
計画の事前承認	Plan Mode（`/plan`）	Plan モードあり	あり
並列サブエージェント	あり（隔離worktree）	あり	あり
MCP 対応	あり	あり	あり
`AGENTS.md` 対応	あり	（CLAUDE.md 等）	あり
特徴的な機能	Arena Mode・ローカルファースト	—	—

上表は各ツールの一般的な機能カテゴリの対比です。各機能の細かな仕様や最新状況は、それぞれの公式ドキュメントを確認してください。

Grok Build の差別化要素は、Arena Mode による出力の自動評価と、ソースコードを外部送信しないローカルファースト設計にあります。一方で、AGENTS.md や MCP に対応することで、既存のエージェント設計の「共通語彙」に乗っている点も見逃せません。

注意点

現時点では early beta であり、提供は SuperGrok / X Premium+ 系のサブスクライバー向けです¹。
コンテキスト長・サブスクリプション料金は公開情報で数値が一致していません。正確な値は公式ページを参照してください。
--always-approve は書き込みを無条件に許可するため、本番リポジトリでの利用は慎重に。

まとめ

Grok Build は xAI 製のターミナル型コーディングエージェントで、モデルは grok-build-0.1
インストールは curl ... | bash、起動は grok の1コマンドとシンプル
Plan Mode で計画を承認してから実行でき、サブエージェントを隔離 worktree で並列実行できる
AGENTS.md / MCP / hooks / skills / plugins に対応し、既存ワークフローを活かしやすい
Arena Mode とローカルファースト設計が他ツールとの差別化要素

ターミナル型エージェントの選択肢が増えたことで、チームの要件（規制対応・既存資産・評価フロー）に合わせて使い分けやすくなりました。まずは公式ドキュメントで最新の仕様を確認しつつ、小さなタスクから試すのがよいでしょう。

参考リンク

Introducing Grok Build | xAI — 公式告知
Getting Started | xAI Docs — インストール・コマンド・API
xAI Enters the Coding Agent Race With Grok Build | DevOps.com — 機能概要

xAI Enters the Coding Agent Race With Grok Build（2026年6月時点） ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷
Grok Build 0.1 | xAI Docs（公式モデルカード）（2026年6月時点） ↩ ↩² ↩³
Getting Started | xAI Docs（2026年6月時点） ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷
Grok Build CLI: xAI Terminal Coding Agent with Plan Mode, Subagents, and Headless CI（2026年6月時点） ↩ ↩² ↩³

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up