codex-container-sandbox
在Podman容器内运行Codex CLI,确保完全访问互联网,但文件系统仅限于repo根目录和显式挂载点;当您希望在不对代理访问整个主机文件系统的情况下进行yolo/web-search时使用。
📖 中文导读:在Podman容器内运行Codex CLI,确保完全访问互联网,但文件系统仅限于repo根目录和显式挂载点;当您希望在不对代理访问整个主机文件系统的情况下进行yolo/web-search时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: codex-container-sandbox description: "Run Codex CLI inside a Podman container with full internet access but filesystem exposure limited to the repo root + explicit bind mounts; use when you want yolo/web-search without giving the agent access to your whole host filesystem."
codex-container-sandbox
Use this when you want:
- Full egress/network for
codex(web search, fetching, etc.) - Tight filesystem boundaries via container bind mounts (repo root + explicit allowlist)
This repo contains a wrapper script intended to be installed as codex-container-sandbox.
Workflow
Build the image
From the repo root (this repository):
podman build -t localhost/codex-container-sandbox:latest -f Containerfile .Install the wrapper
install -m 0755 codex-container-sandbox ~/.local/bin/codex-container-sandbox(Optional) Configure extra mounts
Create
~/.config/codex-container-sandbox/config.sh:CODEX_CONTAINER_SANDBOX_IMAGE="localhost/codex-container-sandbox:latest" # Extra read-only mounts (mapped under /home/codex/... if under $HOME) CODEX_CONTAINER_SANDBOX_RO_MOUNTS=( "$HOME/.local/bin" ) # Extra read-write mounts CODEX_CONTAINER_SANDBOX_RW_MOUNTS=( "$HOME/.cache/uv" "$HOME/tmp" )Login once inside the container
codex-container-sandbox --shell codex loginRun the self-test (recommended)
./selftest.shIf this repo is vendored as a git submodule at
./codex-container-sandbox/(for example in a dotfiles repo), either:cd codex-container-sandbox && ./selftest.sh, or- run
./codex-container-sandbox/selftest.shfrom the parent repo root.
Run Codex
codex-container-sandbox exec "Summarize this repo"
Safety notes
- This wrapper runs Codex in full-yolo mode (
--dangerously-bypass-approvals-and-sandbox) with full networking. Anything mounted into the container can be exfiltrated. - Keep mounts minimal; do not mount secrets, password stores, SSH keys, or large chunks of
$HOMEunless you intend to expose them.