Skip to main content
code_execution 在 xAI 的 Responses API（ https://api.x.ai/v1/responses，与 x_search 使用的端点相同）上运行受沙箱保护的远程 Python 分析。它由捆绑的 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 就会出现在 agent 的工具列表中。

​
如何使用

明确表达分析意图；该工具只接受一个 task 参数， 因此请在一个提示中发送完整请求以及任何内联数据：

​
错误

如果没有认证，工具会返回一个结构化的 JSON 错误（不是抛出的异常），这样代理就可以自行纠正：

​
相关内容

Exec 工具

在你的机器上或配对节点上进行本地 shell 执行。

Exec 审批

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

Web 工具

web_search、x_search 和 web_fetch。

xAI 提供方

Grok 模型、web/x 搜索，以及代码执行配置。