Docker Sandboxes

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

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

官方文档：Kiro CLI

快速开始 ​

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

console
$ sbx run kiro ~/my-project

工作区参数是可选的，默认值为当前目录：

console
$ cd ~/my-project
$ sbx run kiro

首次运行时，Kiro 会提示你使用设备流程完成身份验证。

身份验证 ​

Kiro 使用设备流程身份验证，需要通过网页浏览器交互式登录。这种方式无需直接存储 API 密钥即可完成安全的身份验证。

设备流程登录 ​

首次运行 Kiro 时，它会提示你完成身份验证：

  1. Kiro 显示一个 URL 和一个验证码
  2. 在网页浏览器中打开该 URL
  3. 输入验证码
  4. 在浏览器中完成身份验证流程
  5. 返回终端 —— Kiro 会自动继续

身份验证会话保存在沙箱中，除非你销毁并重建沙箱，否则无需重复登录。

手动登录 ​

要在运行中的沙箱内手动触发登录流程，请用 sbx exec 直接运行 Kiro：

console
$ sbx exec -it <sandbox-name> kiro login --use-device-flow

该命令启动设备流程身份验证，但不会开启编程会话。

身份验证的持久化 ​

Kiro 把身份验证状态保存在沙箱内部的 ~/.local/share/kiro-cli/data.sqlite3。只要沙箱 存在，该数据库就会保留。如果你销毁沙箱，重建之后需要重新完成身份验证。

配置 ​

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

Kiro 需要的配置很少。智能体默认以信任所有工具的模式运行，因此它可以执行命令而 无需反复审批。

默认启动命令 ​

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

text
kiro chat --trust-all-tools

Kiro 镜像把 chat --trust-all-tools 保存在 ENTRYPOINT 中，因此转发的参数会保留 该前缀。直接传入提示词即可，无需重复 chat：

console
$ sbx run kiro -- "explain this project"

这会运行 kiro chat --trust-all-tools "explain this project"。你也可以传入标志， 例如 sbx run kiro -- --resume。

要运行其他 Kiro 子命令，请在运行中的沙箱内使用 sbx exec，参见 手动登录。

基础镜像 ​

模板：docker/sandbox-templates:kiro

身份验证状态在沙箱重启后依然保留。

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