Docker Sandboxes
说明导入在主机环境变量中检测到的密钥
用法sbx secret import [SERVICE] [flags]

描述 ​

把 sbx 在你的主机环境变量中检测到的密钥（例如 OPENAI_API_KEY、ANTHROPIC_API_KEY、 GH_TOKEN）导入全局密钥链。导入之后，每个沙箱都可以使用该密钥，无需在每个 shell 中都设置该环境变量。

每个检测到的环境变量都会以交互方式列出，并附带 Y/n 提示和取值的末尾 4 个字符预览。 已存储的条目绝不会被静默覆盖：

  • 交互模式在覆盖之前会请求确认。
  • --all 导入新条目时不提示，但会跳过覆盖操作 （确实想替换已存储的值时请使用 --force）。
  • --force 无条件导入，包括覆盖已有条目。

已经配置了 OAuth 令牌的服务（例如在 sbx run claude … -- auth login 之后配置的 anthropic）会被跳过：运行时 OAuth 令牌优先，因此导入的任何 api-key 都不会被使用。 如果你想从 OAuth 切换到 api-key 认证，请先运行 sbx secret rm <service>。

可用服务：anthropic、copilot、cursor、devin、droid、github、google、groq、mistral、nebius、openai、openrouter、xai

选项 ​

选项默认值说明
--all不经提示，导入所有检测到的环境变量
--dry-run显示将被导入的内容，但不写入
-f, --force不经确认，覆盖已有的存储条目

全局选项 ​

选项默认值说明
--cloud改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表）
-D, --debug启用调试日志
--no-input从不提示；需要应答的命令会直接失败，并给出应当运行的命令

示例 ​

console
# 遍历每个检测到的环境变量，每次导入前都提示
sbx secret import

# 只导入 openai 服务（使用 OPENAI_API_KEY）
sbx secret import openai

# 非交互式：导入所有检测到的内容，不提示
sbx secret import --all

# 不经确认覆盖已有的存储条目
sbx secret import openai --force

# 预览将被导入的内容，不写入
sbx secret import --dry-run

参见 ​