Docker Sandboxes 设置 | Docker Sandboxes

用 sbx settings 在你的宿主机上配置 Docker Sandboxes，包括剪贴板访问、kit 来源和沙箱创建的默认值。这些设置会在你的各个本地沙箱中生效。针对项目的配置，请使用环境文件。

这些命令通过本地守护进程读写设置，必要时也会启动它。覆盖值会在多次 CLI 调用和守护进程重启之间持久保存。

查看设置

列出设置及其生效值、类型、来源和说明：

console

$ sbx settings ls

表格中的长值和长说明会被截断。用 sbx settings ls --no-trunc 获取完整文本，或用 sbx settings ls --json 获取 JSON 输出。JSON 记录在可用时还会包含默认值和环境变量名称。

要查看某一项设置：

console

$ sbx settings get clipboard.imagePaste
false
$ sbx settings get clipboard.imagePaste --json

默认情况下，get 只打印生效值。用 --json 或 --format yaml 可获取完整的设置记录，其中包含来源和默认值。

更改设置

设置覆盖值时，传入设置键和所需类型的值。例如，允许沙箱中的智能体读取你宿主机剪贴板中的图片：

console

$ sbx settings set clipboard.imagePaste true

对于 JSON 值，请给参数加引号，让你的 shell 完整地传递它。这个示例允许来自 Docker Hub 和你的组织 GitHub 仓库的 kits：

console

$ sbx settings set kit.allowedSources '["docker.io/","github.com/myorg/"]'

JSON 数组和对象会替换整个值。请包含你想保留的所有条目。

用 unset 移除覆盖值：

console

$ sbx settings unset clipboard.imagePaste

该设置会回退到它的环境变量（如果已设置）或默认值。把值设为与内置默认值相同，也会移除已存储的覆盖值。

值的优先级

对于每项设置，最先可用的值生效：

该设置的环境变量（如果有）
用 sbx settings set 写入的用户覆盖值
内置默认值

sbx settings ls 中的 SOURCE 列会标识所选来源是 envvar、override 还是 default。如果环境变量优先，set 仍会更新已存储的覆盖值，并说明生效值为何没有变化。unset 只移除已存储的覆盖值，不会移除环境变量。

变更何时生效

大多数变更在约五秒内生效。在 RESTART 列中标记为 yes 的设置，需要重启守护进程才能对已有的守护进程侧使用者生效：

console

$ sbx daemon restart

必要时，set 和 unset 命令会打印重启提示。有些设置只在创建沙箱时生效：更改模板默认值或磁盘大小不会更新已有沙箱。代理设置的生效时机针对 CLI 请求、守护进程流量和沙箱流量各不相同。请参阅代理变更何时生效。

环境变量

有些设置有对应的环境变量，在下面的参考条目中列出。这些变量用于在宿主机上配置 Docker Sandboxes，它们不会设置沙箱内部的环境变量。

守护进程启动时会继承环境变量。请在第一次运行 sbx 命令之前导出变量，或者在你设置变量的那个 shell 中重启已有的守护进程。例如：

console

$ export DOCKER_SANDBOXES_CLIPBOARD_IMAGE_PASTE=true
$ sbx daemon restart
$ sbx settings get clipboard.imagePaste
true

更改你的 shell 环境不会改变正在运行的守护进程的环境，即使对于通常无需重启就能生效的设置也是如此。要回到已存储的覆盖值或默认值，请移除该变量并重启：

console

$ unset DOCKER_SANDBOXES_CLIPBOARD_IMAGE_PASTE
$ sbx daemon restart

在本地读取设置的 CLI 操作，每次调用都使用它自己的环境。使用这些变量时，请保持 CLI 和守护进程的环境一致。用 sbx settings set 设置持久化覆盖值，可以避免在每个 shell 中导出变量。

设置参考

每个条目都列出其内置默认值（覆盖值之前）。只有当该设置有直接对应的环境变量时，才会出现环境变量。用 sbx settings ls 查看你安装的版本所支持的值。

智能体和宿主机访问

browser.enabled {.wrap-anywhere}

类型：boolean
默认值：true

把它设为 false，可防止沙箱中的进程在你的宿主机浏览器中打开 URL：

console

$ sbx settings set browser.enabled false

这也会阻止沙箱内重定向到 localhost 的 OAuth 登录。

clipboard.imagePaste {.wrap-anywhere}

类型：boolean
默认值：false
环境变量：DOCKER_SANDBOXES_CLIPBOARD_IMAGE_PASTE

开启后，可以用 Ctrl+V 把截图和其他宿主机剪贴板图片粘贴到 Claude Code、Codex 之类的智能体中。粘贴文本不需要这个设置。

console

$ sbx settings set clipboard.imagePaste true

这会授予沙箱中的进程访问宿主机剪贴板图片的权限。该变更会作用于正在运行的沙箱，无需重新创建它们。把它设为 false 即可收回该访问权限。关于支持的行为，请参阅图片粘贴。

claude.chrome {.wrap-anywhere}

类型：boolean
默认值：false

开启后，沙箱中的 Claude Code 可以通过 Claude in Chrome 访问宿主机的浏览器标签页：

console

$ sbx settings set claude.chrome true

变更会作用于正在运行的沙箱发起的新浏览器连接。把它设为 false 可阻止后续连接；已建立的连接会保持活动，直到你结束 Claude 浏览器会话。关于身份验证要求和设置，请参阅 Claude in Chrome。

claude.remoteControl {.wrap-anywhere}

类型：boolean
默认值：false

在沙箱内使用 Claude Code 的 /remote-control 命令之前，请开启此设置：

console

$ sbx settings set claude.remoteControl true

Docker Sandboxes 把远程控制的环境凭据和会话凭据保留在宿主机上。沙箱收到的是占位符，代理只在该设置启用期间、针对它们所属的环境或会话提供真实凭据。远程提供的环境变量和 MCP 配置不会传入沙箱。

把它设为 false 可让代理不再提供远程控制凭据。变更会作用于来自正在运行沙箱的请求。请参阅 Claude Code 远程控制。

env.rememberHostCommands {.wrap-anywhere}

类型：boolean
默认值：false

当你反复运行同一个受信任的环境文件，并希望在其中的宿主机命令发生变化之前只批准一次时，使用这个设置：

console

$ sbx settings set env.rememberHostCommands true

第一次批准仍然是必需的。这些命令在沙箱之外、以你的权限在你的宿主机上运行。保持该设置为 false，则每次调用都需要批准；或者用 --force 只批准一次调用。请参阅环境生命周期命令。

sandbox.fuse {.wrap-anywhere}

类型：boolean
默认值：true

暴露 /dev/fuse 并授予 SYS_ADMIN capability，让进程可以在本地沙箱中挂载 FUSE 文件系统。把它设为 false 可为你创建的沙箱禁用 FUSE 访问：

console

$ sbx settings set sandbox.fuse false

变更只作用于新建的沙箱。已有沙箱会保留它们的 FUSE 配置，重启后也是如此。要为单个沙箱禁用访问，请在它的环境文件中把 sandboxOptions.fuse 设为 false。当该设置为 false 时，环境文件无法启用 FUSE 访问。云沙箱不支持 FUSE。

ssh.agentForwardingEnabled {.wrap-anywhere}

类型：boolean
默认值：true

当你希望沙箱不能向宿主机的 SSH 智能体请求签名时（包括用于 Git 身份验证和提交签名），把它设为 false：

console

$ sbx settings set ssh.agentForwardingEnabled false
$ sbx daemon restart

重启守护进程会把该变更应用到已有的转发器。启用转发时，私钥仍留在宿主机上，但沙箱中的进程可以请求智能体使用它们。请参阅 SSH 智能体凭据。

ssh.agentSocketPath {.wrap-anywhere}

类型：string
默认值：Empty string

当每个沙箱都应使用同一个宿主机 SSH 智能体时（例如密码管理器的智能体），不论是哪个 shell 启动了沙箱，都使用一个固定路径：

console

$ sbx settings set ssh.agentSocketPath "$SSH_AUTH_SOCK"
$ sbx daemon restart

请从一个 SSH_AUTH_SOCK 指向目标智能体的 shell 中运行它。该命令存储的是该路径，而不是对该变量的引用。

该设置为空时，Docker Sandboxes 使用每个客户端提供的 SSH_AUTH_SOCK 值。在 Windows 上，如果 SSH_AUTH_SOCK 也未设置，它会使用 \\.\pipe\openssh-ssh-agent 命名管道。这适用于 Windows OpenSSH，也适用于提供该管道的 1Password SSH 智能体。宿主机上的智能体必须正在运行。要使用其他智能体，请设置 SSH_AUTH_SOCK 或配置 ssh.agentSocketPath。

用 sbx settings unset ssh.agentSocketPath 移除固定路径，并重启守护进程以更新已有的转发器。

镜像和存储

platform.images.registryMirror {.wrap-anywhere}

类型：string
默认值：Empty string

当你的组织把 Docker Hub 拉取路由到某个镜像仓库镜像时，使用这个设置。指定一个主机名，可以带端口和路径前缀，但不要带 URL 协议：

console

$ sbx settings set platform.images.registryMirror registry.example.com/docker-remote

该镜像适用于解析到 Docker Hub 的模板和 kit 引用。指向其他镜像仓库的引用保持不变。空值会禁用镜像。

一个不带路径前缀的非回环主机名，还可以为变更后创建的沙箱配置内部的 Docker 拉取。带路径前缀的镜像不会配置这些拉取。关于身份验证、证书要求以及如何把变更应用到已有沙箱，请参阅镜像仓库镜像。

platform.images.useDHI {.wrap-anywhere}

类型：boolean
默认值：false

开启后，在使用默认智能体模板创建沙箱时会使用 Docker Hardened Image 变体：

console

$ sbx settings set platform.images.useDHI true

例如，默认模板 docker/sandbox-templates:claude-code-docker 会变为 dhi/sbx-templates:claude-code-docker，镜像标签保持不变。显式指定 --template 或使用自定义 kit 镜像时优先。

已有沙箱会保留它们的模板。要使用所选的镜像变体，请在更改设置后创建沙箱。

sandbox.disk.dockerVolume {.wrap-anywhere}

类型：string
默认值：10g

如果沙箱在 /var/lib/docker 下需要更多空间来存放 Docker 镜像、容器和卷，请调高这个默认值。最小值是 512 MiB：

console

$ sbx settings set sandbox.disk.dockerVolume 20g

该大小在创建沙箱时生效。它不会调整已有卷的容量，也不会增大沙箱工作区的尺寸。

要为单个沙箱选择大小而不改变默认值：

console

$ DOCKER_SANDBOXES_DOCKER_SIZE=30g sbx create claude ~/my-project

该变量只作用于那一次创建命令。它不会改变 sbx settings get sandbox.disk.dockerVolume 所报告的值。

Kits

kit.allowedSources {.wrap-anywhere}

类型：JSON
默认值：[\
环境变量：DOCKER_SANDBOXES_KIT_ALLOWED_SOURCES

在从远程镜像仓库或 Git 仓库安装某个发布者的 kits 之前，先在这里添加它。该值会替换整个允许列表，因此要保留你仍然需要的来源：

console

$ sbx settings set kit.allowedSources '["docker.io/","github.com/myorg/"]'

前缀按路径段边界匹配：github.com/myorg/ 允许该组织的仓库，但不允许 github.com/myorg-other/。值 ["*"] 允许任何远程来源。本地目录和 ZIP 文件由 kit.allowLocalKits 控制。

关于来源格式和示例，请参阅限制 kit 来源。

kit.allowLocalKits {.wrap-anywhere}

类型：boolean
默认值：true
环境变量：DOCKER_SANDBOXES_KIT_ALLOW_LOCAL

把它设为 false，即可要求 kits 必须来自远程来源，而不是本地目录或 ZIP 文件：

console

$ sbx settings set kit.allowLocalKits false

远程来源仍须满足 kit.allowedSources。在本地开发 kits 时请保持它启用。允许本地 kits 并不会让它们在 kit.requireSignature 启用时免除签名要求。

kit.requireSignature {.wrap-anywhere}

类型：boolean
默认值：false
环境变量：DOCKER_SANDBOXES_KIT_REQUIRE_SIGNATURE

开启后可拒绝未签名的 kits，以及签名与你的受信任签名者不匹配的 kits。请先配置 kit.trustedSigners，再要求签名：

console

$ sbx settings set kit.requireSignature true

该检查在从本地目录、Git 或 OCI 镜像仓库安装 kits 时生效。ZIP kits 无法携带可验证的签名，因此会被拒绝。

签名覆盖 kit 的 spec.yaml 和 files/ 内容。它不会固定镜像标签，也不会验证由 kit 的命令执行的下载。请参阅签名并验证 kits。

kit.trustedSigners {.wrap-anywhere}

类型：JSON
默认值：Docker employee identities
环境变量：DOCKER_SANDBOXES_KIT_TRUSTED_SIGNERS

设置你信任其 kit 签名的身份或公钥。该值是一个 JSON 数组。每个条目描述一个无密钥签名者或一个公钥，签名只要匹配任意一个条目即可。

对于无密钥签名者，请同时指定身份及其 OpenID Connect 颁发者：

console

$ sbx settings set kit.trustedSigners \
    '[{"identity":"release-bot@example.com","issuer":"https://accounts.google.com"}]'

对于公钥：

console

$ sbx settings set kit.trustedSigners '[{"key":"/path/to/cosign.pub"}]'

每个命令都会替换整个列表。要同时信任两者，请把两个对象放在同一个数组中。默认策略信任以 @docker.com 结尾的 Docker 员工身份，并由 Google 的颁发者进行证明。仅设置受信任签名者并不会要求签名：请同时启用 kit.requireSignature。

kit.ignoreTransparencyLog {.wrap-anywhere}

类型：boolean
默认值：false
环境变量：DOCKER_SANDBOXES_KIT_IGNORE_TLOG

对于使用 --tlog-upload=false 创建无密钥签名的私有 kits，请使用这个设置，这样验证就不需要公开的 Rekor 透明日志条目：

console

$ sbx settings set kit.ignoreTransparencyLog true

签名和签名者验证仍然适用。这些签名必须提供来自时间戳颁发机构的时间戳，而不是透明日志的时间戳。当你的签名流程使用公开透明日志时，请保持它为 false。它对使用公钥验证的签名没有影响。

模型服务

model.server.enabled {.wrap-anywhere}

类型：boolean
默认值：true

把它设为 false 可关闭内置的模型服务并跳过它的运行时下载。更改需要重启守护进程。该设置没有环境变量覆盖。

关于相关命令以及它对你模型选择的影响，请参阅禁用内置服务。

MCP 网关

mcp.forceLocalGateway {.wrap-anywhere}

类型：boolean
默认值：false

当你的账户本应使用 SaaS 网关，但你希望使用本地 MCP 网关时，把它设为 true：

console

$ sbx settings set mcp.forceLocalGateway true
$ sbx daemon restart

守护进程会缓存其网关选择，因此更改此设置后需要重启。它不会覆盖由组织治理所选定的网关。把它改回 false 并重启即可恢复自动选择。关于服务器注册和智能体设置，请参阅 MCP 网关。

守护进程日志

这些设置控制 daemon.log 的轮转，不影响 CLI 或沙箱内进程写入的日志。更改会在 sbx daemon restart 之后生效。备份数量和保留时长限制是一起生效的：轮转出的日志只要超过其中任何一个限制就会被删除。

daemon.log.maxSizeMB {.wrap-anywhere}

类型：integer
默认值：50

设置守护进程日志轮转时的大小（以 MB 为单位）。最小值是 1：

console

$ sbx settings set daemon.log.maxSizeMB 100
$ sbx daemon restart

daemon.log.maxBackups {.wrap-anywhere}

类型：integer
默认值：3

设置保留的轮转守护进程日志的最大数量。该值必须大于等于零。值为 0 时取消数量限制，但保留时长限制仍然适用：

console

$ sbx settings set daemon.log.maxBackups 5
$ sbx daemon restart

daemon.log.maxAgeDays {.wrap-anywhere}

类型：integer
默认值：0

设置轮转守护进程日志的保留天数，取值从 0 到 3650。值为 0 时取消时长限制，但备份数量限制仍然适用：

console

$ sbx settings set daemon.log.maxAgeDays 30
$ sbx daemon restart

遥测

telemetry.disabled {.wrap-anywhere}

类型：boolean
默认值：false

把它设为 true 可为本地 CLI 和守护进程持久地禁用遥测：

console

$ sbx settings set telemetry.disabled true
$ sbx daemon restart

下一次 CLI 调用会使用已保存的偏好设置。正在运行的守护进程会保持它之前的遥测设置，直到你重启它。

SBX_NO_TELEMETRY 是一个独立的退出开关，而不是该设置的环境变量对应项。值为 1 时，无论已保存的偏好设置如何都会禁用遥测。其他值（包括 0）不会覆盖已保存的退出设置。关于 CLI 收集哪些内容，请参阅遥测收集。

诊断

diagnostics.autoUpload {.wrap-anywhere}

类型：string
默认值：Empty string

选择 Docker Sandboxes 是否可以在符合条件的守护进程错误之后自动上传诊断包：

yes：同意自动上传。
no：拒绝自动上传，并抑制后续的同意提示。
空字符串：尚未记录决定。Docker Sandboxes 可能会提示征求同意，但未经同意不会自动上传。

例如，拒绝自动上传：

console

$ sbx settings set diagnostics.autoUpload no

用 sbx settings unset diagnostics.autoUpload 清除该决定。在选择加入之前，请阅读自动诊断上传，了解诊断包包含哪些内容。该设置控制自动上传，不影响显式的 sbx diagnose --upload 请求。

diagnostics.autoUploadErrorCooldownInDays {.wrap-anywhere}

类型：integer
默认值：1

调高这个值可以降低自动诊断包的上传频率。例如，最多每七天自动上传一次：

console

$ sbx settings set diagnostics.autoUploadErrorCooldownInDays 7

该冷却期适用于所有符合条件的错误，而不是分别针对每种错误类型。小于一的值按一天处理。该设置不会授予上传同意：diagnostics.autoUpload 必须为 yes。

出站连接

egress.stalledConnectionTimeoutSeconds {.wrap-anywhere}

类型：integer
默认值：30

设置来自本地沙箱的出站 TCP 连接在远端未确认数据时，最多可以持续多少秒，之后该连接就会关闭。这限制了因宿主机网络变更（例如 VPN 连接建立）而搁置的连接能够挂起的最长时间。

请使用 0 到 3600 之间的值。设为 0 可禁用该超时。例如，调高该超时以容忍更长的网络中断：

console

$ sbx settings set egress.stalledConnectionTimeoutSeconds 90
$ sbx daemon restart

变更会作用于更改后创建的沙箱。对于已有沙箱，请重启守护进程，用更新后的值重建它们的网络代理。实验性的 Runtime 后端不支持该设置。

长于该超时的网络中断会关闭长连接，包括流和上传。在 Linux 上，如果远端停止读取数据的时间超过该超时，该超时也会关闭连接。如果你需要连接在这些暂停期间存活，请调高该值或禁用该超时。

上游代理和 TLS

上游代理支持仍处于实验阶段。用这些设置控制出站流量如何到达网络。关于设置请参阅上游代理，关于生效时机请参阅变更何时生效。

标准的 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 变量及其小写形式是代理选择的后备方案，而不是对 proxy 和 no_proxy 设置的直接覆盖。

proxy {.wrap-anywhere}

类型：string
默认值：Empty string

当沙箱流量和宿主机侧的 Docker Sandboxes 流量都应经过同一个代理时，设置一个共享的上游代理：

console

$ sbx settings set proxy http://proxy.corp:3128
$ sbx daemon restart

该值可以是 HTTP、HTTPS 或 SOCKS5 代理 URL，可以是 PAC 来源，可以用 system 表示使用操作系统的代理，也可以用 direct 表示绕过上游代理。空值会回退到标准代理环境变量，然后是操作系统的代理设置。

下面按作用域划分的设置优先于这个共享值。请参阅代理值格式和代理优先级。

proxy.sandbox {.wrap-anywhere}

类型：string
默认值：Empty string
环境变量：DOCKER_SANDBOXES_PROXY

当沙箱内部的流量需要与守护进程和 CLI 不同的路由时，使用这个设置。例如，让沙箱流量经过 SOCKS5 代理：

console

$ sbx settings set proxy.sandbox socks5h://proxy.corp:1080
$ sbx daemon restart

使用 socks5h:// 时，由代理解析目标名称。用 direct 可让沙箱流量绕过共享代理，或者取消设置该值以继承 proxy。它不影响守护进程流量。更改后创建的沙箱会使用更新后的值；已有的沙箱代理需要重启守护进程。

proxy.daemon {.wrap-anywhere}

类型：string
默认值：Empty string

用它把守护进程的请求（例如镜像拉取）与沙箱流量分开路由。宿主机的 CLI 连接，包括到云沙箱的连接，也使用这个作用域。请参阅流量作用域。

例如，为沙箱流量保留一个共享代理，同时让守护进程直连：

console

$ sbx settings set proxy.daemon direct
$ sbx daemon restart

取消设置该值以继承 proxy。受支持的 CLI 请求会在下次调用时使用变更；守护进程自身的请求需要重启。

proxy.sshDirect {.wrap-anywhere}

类型：boolean
默认值：false

把它设为 true，可让云 SSH 连接绕过上游代理。宿主机 CLI 的其他请求仍使用配置的代理。变更会在下次 SSH 连接时生效，无需重启守护进程。关于设置请参阅云 SSH。

no_proxy {.wrap-anywhere}

类型：string
默认值：Empty string

列出应绕过所选上游代理的目标地址。使用以逗号分隔的主机名、域名后缀、IP 地址或 CIDR 范围：

console

$ sbx settings set no_proxy "registry.internal,10.0.0.0/8"
$ sbx daemon restart

除非被按作用域划分的列表替换，这个共享列表同时适用于沙箱流量和守护进程流量。值为 * 时，所有目标地址都绕过上游代理。代理排除项不会授予网络访问权限：沙箱请求仍然必须通过网络策略。关于如何设置网络策略，请参阅沙箱治理。

no_proxy.sandbox {.wrap-anywhere}

类型：string
默认值：Empty string
环境变量：DOCKER_SANDBOXES_NO_PROXY

当只有沙箱流量需要对一组目标地址绕过上游代理时，使用这个设置。例如，直连集群服务：

console

$ sbx settings set no_proxy.sandbox "*.svc.cluster.local"
$ sbx daemon restart

非空值会替换沙箱流量使用的共享 no_proxy 列表，而不是追加到它。请包含沙箱仍然需要的共享排除项。取消设置即可再次继承 no_proxy。已有的沙箱代理需要重启守护进程。

no_proxy.daemon {.wrap-anywhere}

类型：string
默认值：Empty string

当守护进程和受支持的 CLI 请求需要与沙箱流量不同的代理排除项时，使用这个设置。例如，直接从内部镜像仓库拉取镜像：

console

$ sbx settings set no_proxy.daemon "registry.internal"
$ sbx daemon restart

非空值会替换该作用域使用的共享 no_proxy 列表。它不会改变沙箱的排除项。取消设置即可再次继承 no_proxy。受支持的 CLI 请求会在下次调用时使用变更；守护进程请求需要重启。

proxy.integratedAuth {.wrap-anywhere}

类型：boolean
默认值：false

当企业代理要求使用你的 Windows 登录身份进行 NTLM 或 Kerberos 身份验证时，开启此设置：

console

$ sbx settings set proxy.integratedAuth true
$ sbx daemon restart

它同时适用于沙箱和守护进程的代理流量。身份验证在宿主机上进行，因此 Windows 凭据不会进入沙箱。它在 macOS 或 Linux 上无效。关于使用代理 URL 中的凭据进行跨平台身份验证，请参阅代理身份验证。

tls.allowNegativeSerial {.wrap-anywhere}

类型：boolean
默认值：false
环境变量：DOCKER_SANDBOXES_TLS_ALLOW_NEGATIVE_SERIAL

当 HTTPS 请求因 x509: negative serial number 而失败时（因为检查 TLS 内容的代理签发了带负序列号的证书），使用这个兼容性设置：

console

$ sbx settings set tls.allowNegativeSerial true
$ sbx daemon restart

它会放宽证书校验以接受这些序列号。它不会让不受信任的证书颁发机构变得受信任，也不会解决其他证书错误。关于不受信任的内部 CA，请参阅证书故障排查。

共享智能体技能

共享智能体技能仍处于实验阶段。

skills.defaultMode {.wrap-anywhere}

类型：string
默认值：readonly

选择当你省略 --skills 时，后续创建的沙箱如何使用共享智能体技能存储：

readonly：智能体可以读取共享技能，但不能更改该存储。
readwrite：智能体可以读取并修改其他沙箱使用的技能。
off：不挂载共享存储。

例如，默认省略共享存储：

console

$ sbx settings set skills.defaultMode off

显式指定 --skills 值或环境文件中的 skills 值都会覆盖这个默认值。已有沙箱会保留它们的挂载：要更改访问模式，请重新创建它们。关于设置以及共享可写存储的影响，请参阅共享智能体技能。

命令参考

sbx settings ls

列出设置。别名：sbx settings list。

用 --json 获取 JSON 格式的完整记录，或用 --no-trunc 获取完整文本。这两个选项互斥。

sbx settings get <KEY>

打印一个生效值。

用 --json 获取完整的设置记录。

sbx settings set <KEY> <VALUE>

写入用户覆盖值。

值会根据设置的类型被解析为 bool、int、float、string 或 json。

sbx settings unset <KEY>

移除用户覆盖值。

用 sbx settings <COMMAND> --help 查看命令帮助。

组织策略

审计日志

查看设置 ​

更改设置 ​

值的优先级 ​

变更何时生效 ​

环境变量 ​

设置参考 ​

智能体和宿主机访问 ​

browser.enabled {.wrap-anywhere} ​

clipboard.imagePaste {.wrap-anywhere} ​

claude.chrome {.wrap-anywhere} ​

claude.remoteControl {.wrap-anywhere} ​

env.rememberHostCommands {.wrap-anywhere} ​

sandbox.fuse {.wrap-anywhere} ​

ssh.agentForwardingEnabled {.wrap-anywhere} ​

ssh.agentSocketPath {.wrap-anywhere} ​

镜像和存储 ​

platform.images.registryMirror {.wrap-anywhere} ​

platform.images.useDHI {.wrap-anywhere} ​

sandbox.disk.dockerVolume {.wrap-anywhere} ​

Kits ​

kit.allowedSources {.wrap-anywhere} ​

kit.allowLocalKits {.wrap-anywhere} ​

kit.requireSignature {.wrap-anywhere} ​

kit.trustedSigners {.wrap-anywhere} ​

kit.ignoreTransparencyLog {.wrap-anywhere} ​

模型服务 ​

model.server.enabled {.wrap-anywhere} ​

MCP 网关 ​

mcp.forceLocalGateway {.wrap-anywhere} ​

守护进程日志 ​

daemon.log.maxSizeMB {.wrap-anywhere} ​

daemon.log.maxBackups {.wrap-anywhere} ​

daemon.log.maxAgeDays {.wrap-anywhere} ​

遥测 ​

telemetry.disabled {.wrap-anywhere} ​

诊断 ​

diagnostics.autoUpload {.wrap-anywhere} ​

diagnostics.autoUploadErrorCooldownInDays {.wrap-anywhere} ​

出站连接 ​

egress.stalledConnectionTimeoutSeconds {.wrap-anywhere} ​

上游代理和 TLS ​

proxy {.wrap-anywhere} ​

proxy.sandbox {.wrap-anywhere} ​

proxy.daemon {.wrap-anywhere} ​

proxy.sshDirect {.wrap-anywhere} ​

no_proxy {.wrap-anywhere} ​

no_proxy.sandbox {.wrap-anywhere} ​

no_proxy.daemon {.wrap-anywhere} ​

proxy.integratedAuth {.wrap-anywhere} ​

tls.allowNegativeSerial {.wrap-anywhere} ​

共享智能体技能 ​

skills.defaultMode {.wrap-anywhere} ​

命令参考 ​

sbx settings ls ​

sbx settings get <KEY> ​

sbx settings set <KEY> <VALUE> ​

sbx settings unset <KEY> ​

查看设置

更改设置

值的优先级

变更何时生效

环境变量

设置参考

智能体和宿主机访问

browser.enabled {.wrap-anywhere}

clipboard.imagePaste {.wrap-anywhere}

claude.chrome {.wrap-anywhere}

claude.remoteControl {.wrap-anywhere}

env.rememberHostCommands {.wrap-anywhere}

sandbox.fuse {.wrap-anywhere}

ssh.agentForwardingEnabled {.wrap-anywhere}

ssh.agentSocketPath {.wrap-anywhere}

镜像和存储

platform.images.registryMirror {.wrap-anywhere}

platform.images.useDHI {.wrap-anywhere}

sandbox.disk.dockerVolume {.wrap-anywhere}

Kits

kit.allowedSources {.wrap-anywhere}

kit.allowLocalKits {.wrap-anywhere}

kit.requireSignature {.wrap-anywhere}

kit.trustedSigners {.wrap-anywhere}

kit.ignoreTransparencyLog {.wrap-anywhere}

模型服务

model.server.enabled {.wrap-anywhere}

MCP 网关

mcp.forceLocalGateway {.wrap-anywhere}

守护进程日志

daemon.log.maxSizeMB {.wrap-anywhere}

daemon.log.maxBackups {.wrap-anywhere}

daemon.log.maxAgeDays {.wrap-anywhere}

遥测

telemetry.disabled {.wrap-anywhere}

诊断

diagnostics.autoUpload {.wrap-anywhere}

diagnostics.autoUploadErrorCooldownInDays {.wrap-anywhere}

出站连接

egress.stalledConnectionTimeoutSeconds {.wrap-anywhere}

上游代理和 TLS

proxy {.wrap-anywhere}

proxy.sandbox {.wrap-anywhere}

proxy.daemon {.wrap-anywhere}

proxy.sshDirect {.wrap-anywhere}

no_proxy {.wrap-anywhere}

no_proxy.sandbox {.wrap-anywhere}

no_proxy.daemon {.wrap-anywhere}

proxy.integratedAuth {.wrap-anywhere}

tls.allowNegativeSerial {.wrap-anywhere}

共享智能体技能

skills.defaultMode {.wrap-anywhere}

命令参考

sbx settings ls

sbx settings get <KEY>

sbx settings set <KEY> <VALUE>

sbx settings unset <KEY>