Grok pluginfor Claude Code + Codex
Claude Code + Codex plugin xAI Grok Build Node.js 22+ Apache-2.0

Grok plugin

Grok, inside
your coding agent.

Claude Code・Codex 対応A Claude Code and Codex plugin for Grok Build

エディタから出ずに、Grok へ渡す。Hand it to Grok without leaving your editor.

いま書いた差分のレビュー、コードベース全体の監査、行き詰まった問題の救援 —— Claude Code のスラッシュコマンドまたは Codex の Skill で Grok Build に任せ、答えを会話へ戻します。すでに入っている Grok Build と、そのサインインをそのまま使います。Review the diff you just wrote, audit the whole codebase, or hand off a problem you're stuck on — use a Claude Code slash command or a Codex skill to delegate it to Grok Build and bring the answer back into your conversation. It uses the Grok Build you already have, signed in the way you already are.

導入するGet started 2 min ソースを見るView source
レビューは読み取り専用Reviews are read-only
別アカウント不要No extra account
回答は会話の言語でAnswers in your language
バックグラウンド実行Background jobs
書き込みは、プラグインが断る。Writes are denied by the plugin.
コマンドCommands /grok:review /grok:adversarial-review /grok:audit /grok:rescue /grok:x /grok:status /grok:result /grok:cancel /grok:setup
Read-only by default

レビューは読むだけ。書き換えはしない。Reviews read. They don't rewrite.

レビューと監査の間、Grok はファイルを読み、git diff や git log のような読み取り専用コマンドを実行できます。それ以外の権限要求はプラグインがすべて拒否します —— 許可リストにないシェルコマンドも、出力をファイルへリダイレクトする類のものも同じです。Grok は「こう直すべき」と報告するだけで、直しません。ファイルを変更させたいときだけ、/grok:rescue --write で明示的に許可します。During a review or audit, Grok may read files and run read-only commands such as git diff and git log. Every other permission request is denied by the plugin — including shell commands outside the read-only allowlist and anything that redirects output to a file. Grok reports what it thinks should change; it does not change it. When you do want files touched, you opt in explicitly with /grok:rescue --write.

Commands

スラッシュコマンド 1 行で、Grok に渡す。One slash command hands it over.

Review · audit · rescue · manage.

スラッシュコマンドとして実行すると、Claude が会話の言語を --language で自動的に引き継ぎます。だから指摘はあなたの言語で返ってきます。Run as a slash command, Claude forwards your conversation language with --language automatically — so findings come back in the language you're already speaking.

Review your diff

/grok:review

ローカルの Git 状態を読み取り専用でレビューし、Grok の指摘をそのまま返します。--base main で比較先を、--scope working-tree で範囲を指定でき、フラグの後ろに残したテキストはそのまま「どこを重点的に見るか」として渡されます。--wait / --background を付けない場合、Claude Code と Codex のどちらも各ホストのバックグラウンドで直ちに開始します。--wait を指定すればフォアグラウンドで実行できます。Codex のバックグラウンド実行は管理プロセスとして追跡され、GrokジョブIDと初期進捗を表示します。Runs a read-only review of your local git state and returns Grok's findings verbatim. Point it with --base main, narrow it with --scope working-tree, and any text left after the flags is passed through as review focus. Without --wait or --background, both Claude Code and Codex start immediately in their host-managed background mode. Pass --wait to run in the foreground. Codex background runs stay attached as managed processes and report the Grok job ID and initial progress.

--wait--background--base--scope
Argue against shipping

/grok:adversarial-review

対象の指定は /grok:review と同じまま、Grok には「出荷に反対する立場で、いま出すべきでない最も強い理由を挙げろ」と指示します。バランスの取れた要約ではなく、反論がほしいときに。Same targeting as /grok:review, but Grok is told to argue against shipping and report the strongest reasons the change should not land yet. Use it when you want pushback rather than a balanced summary.

反論重視pushback--base
Audit the whole codebase

/grok:audit

差分ではなく、いまあるソースそのものを監査します。渡すのはファイル一覧だけで差分もファイル内容も含めないため、Grok は読み取り専用コマンドで自分が見るべきファイルを選んで読みます。重点を指定しなくても、アーキテクチャを把握して高リスクな実行経路を選び、呼び出し元、状態遷移、境界、失敗経路、並行性、テストまで既定で深掘りします。大きなリポジトリで特定領域に絞りたい場合だけ、重点を追加できます。Audits the source as it stands instead of a diff. The context deliberately carries no diff and no file contents — only a file inventory — so Grok reads what it decides to inspect with read-only commands. Even without a focus, it maps the architecture, selects high-risk execution paths, and traces callers, state transitions, boundaries, failures, concurrency, and tests by default. Add a focus only when you want that deep pass confined to a particular area of a large repository.

既定で深掘りdeep by default重点指定可optional focus
Hand off a problem

/grok:rescue

詰まった問題を Grok に渡して、答えを受け取ります。「もう一組の目がほしい」ときのコマンド。既定は読み取り専用で、ファイルを変更させたいときだけ --write を付けます。--model は fast / reasoning / multi / build / latest のエイリアスかモデル ID、--effort は low / medium / high。Hands a problem to Grok and returns its answer — the command for "I'm stuck, get another set of eyes on it." Read-only by default; pass --write when you want Grok to change files. --model takes the aliases fast, reasoning, multi, build, latest or any model ID, and --effort takes low, medium, or high.

--write--model--effort--resume
Search what people posted on X

/grok:x

X（Twitter）の投稿を検索して、実際に書かれている内容を返します。X のタイムラインは通常の Web 検索では読めず、Grok Build が持つ x_keyword_search と x_semantic_search からしか届きません。結果は投稿者ハンドル・投稿日・URL 付きで返ります。認証は他のコマンドと同じ grok login のままで、xAI の API キーは要りません。常に読み取り専用で、既定では直近 30 日を対象にします。Searches X (Twitter) posts and reports what they actually say. X timelines are unreachable from ordinary web search — only Grok Build's x_keyword_search and x_semantic_search get there. Findings come back with the author handle, the post date, and the post URL. It uses the same grok login credentials as every other command; no xAI API key needed. Always read-only, and scoped to the last 30 days unless you ask for another window.

読み取り専用read-only--background--model
Manage background jobs

/grok:status · result · cancel

/grok:status でリポジトリの実行中・最近のジョブとレビューゲートの状態を確認。/grok:result は終了したジョブの最終出力を表示し、Grok のセッション ID と grok --resume <id> も併記するので、Grok 自身の TUI で会話を続けられます。/grok:cancel は実行中のジョブと、その背後の Grok のターンを止めます。IDを省略した場合は現在のセッションで実行中のジョブが1件だけなら停止し、複数ある場合は勝手に選ばずIDの指定を求めます。/grok:status shows active and recent jobs for the repository plus the state of the review gate. /grok:result prints a finished job's stored output — including the Grok session ID and the grok --resume <id> command, so you can pick the conversation back up in Grok's own TUI. /grok:cancel stops a running job and the Grok turn behind it. With no ID, it cancels only when the current session has exactly one active job; if several are active, it asks for an ID instead of guessing.

--all--wait<job-id>
Check the wiring

/grok:setup

Grok Build が入っているか、grok agent stdio が使えるか、サインイン済みかを確認します。停止時レビューゲートの ON / OFF もここで切り替えられ、ON にするとセッション終了時に新しく敵対的レビューが走り、何か見つかれば終了をブロックします。Checks whether Grok Build is installed, whether grok agent stdio is available, and whether you're signed in. It also toggles the stop-time review gate: with the gate enabled, ending a Claude session triggers a fresh adversarial review and blocks if it finds something.

--enable-review-gate--disable-review-gate
How it works

貼り付けた差分ではなく、リポジトリそのものを読ませる。Grok reads the repository, not a pasted diff.

Agent Client Protocol over grok agent stdio.

同じリポジトリでの実行は 1 つの Grok プロセスを小さなブローカー経由で共有します。レビューと委譲タスクがそれぞれ起動コストを払わずに済み、ブローカーに繋がらないときは自前で Grok プロセスを立ち上げてフォールバックします。Runs in the same repository share one Grok process through a small broker, so a review and a delegated task don't each pay startup cost. If the broker is unreachable, the plugin falls back to starting its own Grok process.

  1. 1
    ACP で話すIt speaks ACP.プラグインは grok agent stdio を起動し、Agent Client Protocol で会話します。Grok はリポジトリを自分で読み、ツール呼び出しは起きた順にそのまま見えます。The plugin runs grok agent stdio and speaks the Agent Client Protocol to it. Grok reads your repository itself, and you see its tool calls as they happen.
  2. 2
    プロセスを共有するIt shares one process.同一リポジトリの実行はブローカー経由で 1 プロセスを共有。届かなければ自前で起動してフォールバックします。Runs in one repository share a single Grok process through a broker, with a fallback that starts its own process if the broker is unreachable.
  3. 3
    モデルを指定するIt picks a model.既定は grok-4.6。単発は --model、常用は環境変数 GROK_PLUGIN_MODEL で上書きできます。XAI_API_KEY で認証すると Grok 側の新規セッション既定は非推論モデルになり、レビュー品質が目に見えて落ちるため、この既定が効いてきます。It asks for grok-4.6 by default. Override it for one run with --model, or for every run with GROK_PLUGIN_MODEL. This matters more than it looks: when you authenticate with XAI_API_KEY, Grok's own default for a new session is a non-reasoning model, which reviews noticeably worse.
  4. 4
    MCP を持ち込まないIt leaves your MCP servers out.レビューは MCP サーバーを 1 つも繋がずに始めるので、グローバル設定が毎回のレビューに読み込まれてトークンが膨らむことがありません。/grok:rescue の委譲実行は通常どおりあなたの設定を使います。Reviews start with no MCP servers attached, so your global MCP setup doesn't get loaded into every review and inflate the token count. Delegated /grok:rescue runs use your normal configuration.
Requirements

動作環境What you need

Grok Build, signed in, on Node 22+.

Grok Build
必須Requiredgrok agent stdio を持つビルドa build exposing grok agent stdio
サインインSign-in
SuperGrok / X Premium+または XAI_API_KEYor an XAI_API_KEY
Node.js
22+プラグイン本体の実行に使用used to run the plugin itself
Claude Code / Codex
プラグイン対応版Plugin-capableいずれかのホストでプラグインを追加できることwith plugin installation available in either host

利用量について：このプラグインは、あなたのマシンの Grok Build がすでにサインインしている先をそのまま使います。専用アカウントは要りません。消費はサインインに使っているプラン（SuperGrok / X Premium+）または XAI_API_KEY のどちらかに計上され、API キーはブラウザ資格情報より優先されます。About usage: the plugin uses whatever Grok Build on your machine is already signed in with — no separate account needed. Usage counts against whichever you use, your plan (SuperGrok / X Premium+) or your XAI_API_KEY, and the API key takes precedence over browser credentials.

Install

導入は 4 ステップFour steps to running

Install Grok Build, add the marketplace, install, check.Install Grok Build, add the marketplace, install, check.

Apache-2.0 · 無料Apache-2.0 · Free
1
Grok Build を入れるInstall Grok Build x.ai から配布されています（パッケージレジストリ経由ではありません）。Windows は PowerShell で。It ships from x.ai, not from a package registry. On Windows, in PowerShell:
irm https://x.ai/cli/install.ps1 | iex
macOS / Linux:On macOS or Linux:
curl -fsSL https://x.ai/cli/install.sh | bash
2
サインインするSign in ブラウザで対話的にサインインするか、ヘッドレス／従量利用なら console.x.ai の API キーを使います。Sign in interactively, or use an API key from console.x.ai for headless or metered use.
grok login
$env:XAI_API_KEY = "xai-..."
3
プラグインを入れるInstall the plugin Claude Code では次のスラッシュコマンドで追加します。In Claude Code, add and install it with these slash commands:
/plugin marketplace add 1llum1n4t1s/KG.grok-plugin-cc
/plugin install grok@kagayoi-grok
/reload-plugins
Codex ではターミナルから追加し、新しいタスクを開始します。In Codex, run these commands in a terminal, then start a new task:
codex plugin marketplace add 1llum1n4t1s/KG.grok-plugin-cc
codex plugin add grok@kagayoi-grok
4
配線を確認するCheck the wiring Grok Build の有無、grok agent stdio の可否、サインイン状態を報告します。何かをインストールすることはありません。It reports whether Grok Build is installed, whether grok agent stdio is available, and whether you're signed in. It doesn't install anything for you.
/grok:setup # Claude Code
grok:source-command-setup # Codex /skills
あとは出荷前に 1 行。Then, before you ship:
/grok:review --wait
追加費用なしNo extra cost

プラグイン自体は無料。消費は既存の Grok 契約に計上されます。The plugin is free; usage counts against your existing Grok access.

読み取り専用が既定Read-only by default

書き込みは --write を明示したときだけ。Writes happen only when you pass --write.

オープンソースOpen source

Apache-2.0。openai/codex-plugin-cc のフォークです。Apache-2.0, forked from openai/codex-plugin-cc.

FAQ

よくある質問Questions

このプラグイン専用のアカウントは必要ですか？Do I need a separate account for this plugin?

いりません。あなたのマシンの Grok Build がすでにサインインしている先をそのまま使います。No. It uses whatever Grok Build on your machine is already signed in with.

いまの Grok の設定は使われますか？Does it use my existing Grok configuration?

使われます。例外は 1 つだけで、レビューは MCP サーバーを繋がずに始めます。グローバルの MCP 設定が毎回のレビューへ読み込まれてトークンが膨らむのを避けるためです。/grok:rescue の委譲実行では通常の設定が使われます。Yes, with one exception: reviews start with no MCP servers attached, so your global MCP setup doesn't get loaded into every review and inflate the token count. Delegated /grok:rescue runs use your normal configuration.

/grok:review は本当に読み取り専用ですか？Is /grok:review really read-only?

はい。Grok はファイルを読み、読み取り専用コマンドを実行できます。それ以外の権限要求はすべてプラグインが拒否します —— 読み取り専用の許可リストに載っていないシェルコマンドも、出力をファイルへリダイレクトするものも含めてです。Yes. Grok may read files and run read-only commands. Every permission request for anything else is denied by the plugin, including shell commands that are not on a read-only allowlist and anything that redirects output to a file.

指摘は日本語で返ってきますか？Will findings come back in my language?

スラッシュコマンドとして実行すれば、Claude が会話の言語を --language <bcp47> で自動的に引き継ぎます。コンパニオンスクリプトを直接呼ぶ場合は自分で --language を渡してください。渡さない場合は重点テキストの言語、次に英語へフォールバックします。When run as a slash command, Claude forwards the conversation language with --language <bcp47> automatically. If you call the companion script directly, pass --language yourself; otherwise it falls back to the language of the focus text, then English.

/grok:transfer がないのはなぜですか？Why is there no /grok:transfer?

上流の Codex プラグインには Claude Code のセッションを Codex のスレッドへ取り込む機能がありました。Grok Build に同等のものが無いため、それらしく見せかけるのではなくコマンドごと削除しました。The upstream Codex plugin could import a Claude Code session into a Codex thread. Grok Build has no equivalent, so the command was removed rather than faked.