用途:为已由 setup-devcontainer 生成的 devcontainer 添加 Codex,不直接改写 devcontainer.json 主体,只通过既定的 Capability Seam(runArgs)扩展点追加条目。
主要能力:通过 OpenAI 官方安装脚本(https://chatgpt.com/codex/install.sh)在容器创建时执行 postCreateCommand 安装 Codex CLI,仅在 ~/.local/bin/codex 不存在时运行;无条件追加三项能力条目(--cap-add=SYS_ADMIN、--security-opt=seccomp=unconfined、--security-opt=systempaths=unconfined),使其 Bubblewrap 沙箱可构建命名空间;无条件确保 .codex.networkAllowlist 条目存在于 .devcontainer/network-manifest.json。可选 YOLO 别名 codex-yolo(使用 --ask-for-approval on-request,默认关闭),以及可选技能同步,在每次容器启动时将指定来源同步到 ~/.agents/skills(默认关闭,来源需自行信任)。
用法:先确认存在 .devcontainer/devcontainer.json 与 .devcontainer/post-create.sh,缺失则要求先运行 setup-devcontainer 并停止。之后按步骤追加 install-block.sh、可选的 yolo-alias-block.sh、能力条目与网络清单条目,将技能同步块渲染进 post-start.sh,并在 README.md 追加说明。验证方式是重跑全部追加命令,应产生零差异。最后提示重建容器(Dev Containers: Rebuild Container)使 runArgs 生效,然后运行 codex 并登录。
限制:不会编辑 devcontainer.json 的其他内容;所有自动化只在容器内运行而非主机;若旧版 post-start.sh 中残留 rm -rf /home/vscode/.codex/skills/* 需手动删除;具体定价、平台支持等资料暂未提供。