Skip to main content
code_execution 在 xAI 的 Responses API 上运行沙箱隔离的远程 Python 分析 （https://api.x.ai/v1/responses 使用的同一端点 x_search）。它由内置的 xai 插件根据 tools 契约注册。
code_execution 在 xAI 的服务器上运行。xAI 对每 1,000 次工具调用收取 $5， 另加模型的输入和输出 token 费用。
可将其用于计算、制表、快速统计和图表式分析，包括分析由 x_search 或 web_search 返回的数据。它无法访问本地文件、你的 shell、你的仓库或已配对设备，并且不会在调用之间持久保存状态，因此应将每次调用视为临时分析，而不是笔记本会话。对于最新的 X 数据，请先运行 x_search，然后将结果传入。 如需本地执行，请改用 exec。

​
设置

1

提供 xAI 凭据

OAuth 需要符合条件的 SuperGrok 或 X Premium 订阅 （使用设备代码验证，因此可从没有 localhost 回调的远程主机运行）：
在全新安装期间，新手引导中也提供相同选项：
或使用 API 密钥：
或通过配置：
这三种方式中的任意一种也能为 x_search 和 Grok web_search 提供支持。
2

启用并调优 code_execution

省略 enabled 时，仅当当前模型的提供商为 xai 且能够解析 xAI 凭据时，才会公开 code_execution。对于提供商已知且不是 xAI 的当前模型，请将 plugins.entries.xai.config.codeExecution.enabled 设置为 true，以选择启用跨提供商使用。如果当前模型提供商缺失或无法解析，该工具将保持隐藏。将 enabled 设置为 false 可对所有提供商禁用它。始终需要 xAI 凭据。使用同一配置块可覆盖模型、轮次上限或超时时间：
3

重启 Gateway 网关

xAI 插件重新注册，并且上述提供商、启用状态和身份验证检查均通过后，code_execution 将出现在智能体的工具列表中。

​
使用方法

明确说明分析意图；该工具只接受一个 task 参数，因此请在一个提示词中发送完整请求和所有内联数据：

​
错误

没有身份验证时，该工具会返回结构化 JSON 错误（而不是抛出的异常），以便智能体自行纠正：

​
相关内容

Exec 工具

在你的计算机或已配对节点上执行本地 shell。

Exec 审批

shell 执行的允许/拒绝策略。

Web 工具

web_search、x_search 和 web_fetch。

xAI 提供商

Grok 模型、Web/X 搜索和代码执行配置。