本页介绍的是本地沙箱。有关云端行为及其限制，请参阅对比本地沙箱与云沙箱。

本指南介绍在沙箱环境中对 Codex 进行身份验证、配置和使用的方法。

官方文档：Codex CLI

快速开始

创建沙箱，并为项目目录运行 Codex：

$ sbx run codex ~/my-project

sbx run 默认把工作区设为当前目录：

$ cd ~/my-project
$ sbx run codex

要创建无挂载沙箱，使用不带工作区路径的 sbx create，然后按名称连接。

身份验证

使用默认的 OpenAI 模型时，如果你还没有存储 OpenAI 凭据，sbx run codex 会提示 你在宿主机上完成身份验证。身份验证在启动沙箱之前完成，因此凭据绝不会暴露在沙箱 内部。

要提前配置身份验证，选择下列方式之一。

OAuth：在宿主机上启动 OAuth 流程：

$ sbx secret set openai --oauth

该命令会打开浏览器窗口进行身份验证，并把生成的令牌存入操作系统的密钥链。OAuth 流程运行在宿主机上，而不是沙箱内部，因此基于浏览器的身份验证无需任何额外配置即可 使用。

API 密钥：用存储的密钥保存你的 OpenAI API 密钥：

$ sbx secret set openai

更多细节请参阅凭据。

模型选择

要让 Codex 使用本地模型或其他推理提供商，请参阅 使用本地模型和托管模型。

配置

沙箱不会读取宿主机的用户级配置，例如 ~/.codex。沙箱内只有工作目录中的项目级 配置可用。变通方法请参阅 沙箱为什么不用我的用户级智能体配置？。

默认启动命令

不带额外参数时，沙箱运行：

codex --dangerously-bypass-approvals-and-sandbox

传递提示词时若要保留跳过模式，请以标志开头：

$ sbx run --name <sandbox-name> -- --dangerously-bypass-approvals-and-sandbox "fix the build"

有关参数转发的规则，请参阅 向智能体传递参数。

基础镜像

模板：docker/sandbox-templates:codex

有关预装工具或自定义此环境，请参阅自定义。