ホーム › Grok Buildの許可モード
Grokガイド
Grok Buildの許可モード:Ask・Auto・Always-approveと許可ルール
Grok Buildがファイルを書き換えたりコマンドを実行したりする前に、許可を求めるかどうかは許可モードで決まります。モードの切り替えと、許可・拒否ルールの書き方を、xAI公式ドキュメントで確認しました。
結論:初期はAsk。ルールは config.toml の [permission] に書く
許可モードはAsk(初期)・Auto・Always-approveの3つです。Askは許可済みでない操作のたびに尋ね、Autoは分類器が安全な操作を承認し、Always-approveは自動で承認します。どのモードでも、denyルールは効きます。
3つのモード
| モード | 動き | 入り方 |
|---|---|---|
| Ask(初期) | 許可済みでない操作は、そのたびに尋ねる | 初期状態 |
| Auto | 分類器が安全な操作を承認。危険な操作は尋ねることがある。denyルールとフックは有効 | /auto または Shift+Tab(機能が有効なとき) |
| Always-approve | 操作を自動で承認。denyルールとPreToolUseフックは有効 | /always-approve、Ctrl+O、Shift+Tab、または grok --always-approve |
Shift+Tabで Normal → Plan → Auto(使えるとき)→ Always-approve の順に切り替わります。AutoとAlways-approveは重ならず、切り替えると置き換わります。Planモードは別に働き、計画中は編集ツールが制限されます。
初期モードの設定
初期のモードは、ユーザー設定の ~/.grok/config.toml(または管理者の設定ファイル)にだけ書けます。プロジェクトの .grok/config.toml は、この設定には使われません。
古いキー approval_mode と yolo = true も動きますが、複数あるときは permission_mode が優先されます。
許可・拒否ルール
- 各ルールは
action・tool・(任意で)patternで書きます。 - 対象のツールは Bash・Edit・Read・Grep・MCPTool・WebFetch・WebSearch です。
- コマンドラインの
--allowと--denyでも、1回の実行だけに同じ書式のルールを渡せます。 - denyルールは、当てはまるallowルールより常に優先されます。
rm や git push のような危険なコマンド
「常に許可」として覚えさせた許可は、rm や git push のような危険なパターンでは、なお尋ねます。設定やコマンドラインの明示的なallowルールは、これらを自動で承認します。Always-approveでは、denyルールで止めない限り実行されます。重要なリポジトリでは、Always-approveより、allowとdenyで範囲を決める方が安全です(Grok Buildの使い方)。
確認した公式資料
上の資料は2026年11月12日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。
あわせて読むページ
よくある質問
Grok Buildの許可モードの初期値は?
Ask です。許可済みでない操作のたびに尋ねます。
denyルールとallowルールが重なったらどちらが優先ですか?
denyルールが常に優先されます。
プロジェクトの .grok/config.toml で許可モードを決められますか?
初期の許可モード(permission_mode)は、ユーザー設定の ~/.grok/config.toml か管理者の設定ファイルにだけ書けます。プロジェクトの .grok/config.toml はこの設定には使われません。
Always-approveでも止められますか?
denyルールとPreToolUseフックは、Always-approveでも有効です。
更新履歴
- 公式資料で確認して公開しました。