codex

这是什么

codex 是 OpenAI Codex CLI 的沙箱模板。镜像基于 python:3.12-slim，预装 Python 3（/opt/venv）、Node.js 22、npm 包 @openai/codex，以及 Python 包 openai>=1.0、rich、httpx。系统工具有 git、curl、wget、build-essential、ripgrep、jq。资源配置是 2 CPU / 4096 MB。容器入口是 python3 commands.py，命名命令注册在进程里，监听 ABX_SERVER_PORT（默认 9000）。

命名命令只有一个：codex。它在沙箱里执行：

codex -p <prompt> --model <model> --yolo --output-format json

超时 300 秒。prompt 必填，model 默认 codex-mini。

本地 e2e 怎么跑

仓库根目录，已安装 agent-sandbox-server 和 httpx：

python3 -m pip install agent-sandbox-server httpx
python3 scripts/run_local_e2e.py

这条命令会给每个带 commands.py 和 e2e_test.py 的模板各起一个临时端口，在该目录启动 python3 commands.py，设置 E2E_BASE_URL，跑完 e2e_test.py 再停掉进程。它强制 E2E_RUN_LLM=0，并且不把 OPENAI_API_KEY 等密钥传给子进程。

只跑本目录时，先在 codex/ 启动 server，再另开一个终端跑测试。E2E_BASE_URL 必须指向这个已经起来的进程：

cd codex
ABX_SERVER_PORT=9000 python3 commands.py

cd codex
E2E_BASE_URL=http://127.0.0.1:9000 python3 e2e_test.py

commands.py 不在跑，或者 E2E_BASE_URL 和 ABX_SERVER_PORT 对不上，/health 和 /commands 会失败。

极速版怎么安装和创建

abx template install 只在阿里云极速版（provider alicloud-express）上构建镜像并注册模板。

从索引安装并构建：

abx template install alibaba-agent-sandbox/awesome-templates//codex

在本仓库里从本地目录安装：

abx template install ./codex --registry-type local

只下载到 ~/.abx/templates/、不构建：

abx template install ./codex --registry-type local --download-only

在模板目录里构建、推送并注册：

abx deploy

创建沙箱并注入密钥（template.yaml 里 OPENAI_API_KEY 的值是空字符串，不要写进镜像）：

abx create --template codex --env OPENAI_API_KEY=<你的密钥>

怎么调用命名命令

命名命令走 abx run 或 sandbox.run。参数名就是 commands.py 里的 prompt 和 model。

abx run <sandbox-id> codex --arg prompt="编写一个快速排序算法" --arg model=codex-mini

await sandbox.run("codex", prompt="编写一个快速排序算法", model="codex-mini")

同步代码用 sandbox.run_sync("codex", prompt="...", model="codex-mini")。省略 model 时 server 使用默认值 codex-mini。

abx exec <sandbox-id> -- codex "..." 和 sandbox.commands.run("codex '...'") 是直接跑 shell，不会经过 @command("codex")，也不会自动加上 -p、--model、--yolo 和 --output-format json。

需要哪些环境变量

变量	作用
`OPENAI_API_KEY`	Codex CLI 的密钥。创建沙箱时用 `--env` 注入。`e2e_test.py` 只有在跑测试的进程里看得到这个变量，才会去调 `POST /commands/codex`。密钥还必须出现在 `commands.py` 那个进程的环境里。
`CODEX_SANDBOX_MODE`	`template.yaml` 写成 `true`。
`WORKSPACE`	`template.yaml` 写成 `/app`。`codex` 这条命令本身不读它。
`ABX_SERVER_PORT`	server 端口，默认 `9000`。
`E2E_BASE_URL`	只跑 `e2e_test.py` 时指向已启动的 server，例如 `http://127.0.0.1:9000`。根目录的 `run_local_e2e.py` 会自己设置。
`E2E_RUN_LLM`	`0` 强制跳过模型调用；`1` 强制去调。默认按有没有 `OPENAI_API_KEY` 决定。根目录脚本固定写成 `0`。
`E2E_MODEL`	可选。设了就作为 `model` 参数发给 `codex`，不设就用命令默认值 `codex-mini`。

Codex CLI 要能访问 OpenAI API，沙箱需要出网。

没有密钥时 e2e 会 SKIP

POST /commands/codex 这条用例在没有 OPENAI_API_KEY，或 E2E_RUN_LLM=0 时记为 SKIP。根目录的 python3 scripts/run_local_e2e.py 两种情况都占了：它不转发密钥，并且强制 E2E_RUN_LLM=0。测试进程退出码 0 只说明 server 的 /health、/commands 和其余本地检查过了。

这不算 Agent 验收。验收要在沙箱进程里看得到 OPENAI_API_KEY，再跑同一份 e2e_test.py，让 codex 真正执行。探测提示词是 Reply with exactly: ABX_E2E_OK。没有这条带密钥的记录，不能把模板写成已经支持 Codex。

OpenSandbox / E2B

OpenSandbox 和 E2B 上，这个目录不会自动变成对方的模板。abx template install 只在极速版构建。OpenSandbox 创建用的是镜像 URI，并且会替换容器入口，仓库里的 codex/Dockerfile 不会因此在那边注册。E2B 也不会出现一个叫 codex 的 template id。base、code-interpreter-v1、desktop 是平台自己的 id，和这个目录无关。

codex 是 OpenAI Codex CLI 的沙箱模板