code_execution は、xAI の Responses API
（https://api.x.ai/v1/responses、x_search が使用するものと同じエンドポイント）上で、サンドボックス化されたリモート Python 分析を実行します。バンドルされている xai Plugin により、tools コントラクトの下で登録されます。
計算、集計、簡単な統計、グラフ形式の分析に使用できます。これには、
x_search または web_search が返したデータの分析も含まれます。ローカルファイル、シェル、リポジトリ、ペアリング済みデバイスにはアクセスできず、呼び出し間で状態も保持されません。そのため、各呼び出しはノートブックセッションではなく、一時的な分析として扱ってください。最新の X データを使用する場合は、まず x_search を実行し、その結果をパイプで渡します。
ローカルで実行する場合は、代わりに exec を使用してください。
セットアップ
1
xAI の認証情報を指定する
OAuth には、対象となる SuperGrok または X Premium サブスクリプションが必要です
（デバイスコード検証を使用するため、localhost コールバックなしでリモートホストからも利用できます）。新規インストール時には、オンボーディングでも同じ選択肢を利用できます。または API キーを使用します。または設定を使用します。これら 3 つのいずれを使用しても、
x_search と Grok web_search も利用可能になります。2
code_execution を有効化して調整する
enabled を省略した場合、code_execution が公開されるのは、アクティブなモデルのプロバイダーが xai であり、かつ xAI の認証情報を解決できる場合のみです。既知の xAI 以外のプロバイダーを使用するアクティブモデルでプロバイダーをまたいだ利用をオプトインするには、plugins.entries.xai.config.codeExecution.enabled を true に設定します。アクティブなモデルのプロバイダーが欠落しているか解決できない場合、ツールは非表示のままです。すべてのプロバイダーで無効にするには、enabled を false に設定します。xAI の認証情報は常に必要です。同じブロックを使用して、モデル、ターン上限、またはタイムアウトを上書きできます。3
Gateway を再起動する
code_execution が表示されます。使用方法
分析の意図を明示してください。このツールが受け取るパラメーターはtask 1 つだけなので、完全なリクエストとインラインデータを 1 つのプロンプトで送信します。
エラー
認証がない場合、ツールは例外をスローせず、構造化された JSON エラーを返すため、エージェントは自己修正できます。関連項目
Exec ツール
使用中のマシンまたはペアリング済み Node 上でのローカルシェル実行。
Exec の承認
シェル実行の許可・拒否ポリシー。
Web ツール
web_search、x_search、および web_fetch。xAI プロバイダー
Grok モデル、Web/X 検索、およびコード実行の設定。