• 简体中文

      • Codex 集成

      AIO Sandbox 内置 OpenAI Codex CLI。Codex 是面向终端的 AI coding agent，可以在沙盒里直接使用，也可以通过内置终端页面打开。

      访问方式

      • 浏览器：访问 http://localhost:8080/codex，会跳转到内置终端并启动 codex
      • 终端：在容器内直接运行 codex

      环境变量

      启动容器时可以通过环境变量生成 Codex 配置：

      变量默认值说明
      CODEX_API_KEY无通用 API key，推荐用于 Responses 兼容网关
      ARK_API_KEY无兼容已有的方舟 API key 配置
      OPENAI_API_KEY无官方 OpenAI API key
      CODEX_MODELdeepseek-v4-flash-260425自定义 provider 模式下写入的模型 ID
      CODEX_BASE_URLhttps://ark.cn-beijing.volces.com/api/v3自定义 provider 模式下的 Responses API endpoint
      CODEX_CONFIG_TOML无完整自定义 config.toml 内容，优先级最高
      CODEX_MODEL_CATALOG_JSON无可选模型目录 JSON 内容，写入 ~/.codex/model-catalog.json

      常规场景优先使用 CODEX_API_KEY。

      配置示例

      官方 OpenAI API：

      docker run --security-opt seccomp=unconfined --rm -it \
  -p 127.0.0.1:8080:8080 \
  -e OPENAI_API_KEY="sk-xxx" \
  ghcr.io/agent-infra/sandbox:latest

      其他 Responses 兼容 endpoint：

      docker run --security-opt seccomp=unconfined --rm -it \
  -p 127.0.0.1:8080:8080 \
  -e CODEX_API_KEY="your-api-key" \
  -e CODEX_MODEL="your-model-id" \
  -e CODEX_BASE_URL="https://example.com/api/v3" \
  ghcr.io/agent-infra/sandbox:latest

      完全自定义 Codex 配置：

      如果需要配置 Codex 支持的任意 config.toml 字段，可以使用 CODEX_CONFIG_TOML 传入完整 TOML。建议在配置中使用 env_key 引用 API key 环境变量，不要把密钥值直接写入 TOML。

      export CODEX_CONFIG_TOML='model = "custom-model"
model_provider = "custom"
model_catalog_json = "model-catalog.json"
approval_policy = "never"
sandbox_mode = "danger-full-access"

[model_providers.custom]
name = "custom"
base_url = "https://example.com/api/v3"
wire_api = "responses"
env_key = "CUSTOM_API_KEY"
'

export CODEX_MODEL_CATALOG_JSON='{"models":[{"id":"custom-model","name":"Custom Model"}]}'

docker run --security-opt seccomp=unconfined --rm -it \
  -p 127.0.0.1:8080:8080 \
  -e CUSTOM_API_KEY="your-api-key" \
  -e CODEX_CONFIG_TOML \
  -e CODEX_MODEL_CATALOG_JSON \
  ghcr.io/agent-infra/sandbox:latest

      配置优先级

      启动时按以下顺序生成 config.toml：

      1. CODEX_CONFIG_TOML
      2. CODEX_API_KEY / ARK_API_KEY / OPENAI_API_KEY 自动生成配置
      3. 不生成配置

      使用自动生成配置时，按以下顺序选择 API key：

      1. CODEX_API_KEY
      2. ARK_API_KEY
      3. OPENAI_API_KEY

      如果没有可用的 API key，容器启动时不会生成或覆盖 Codex 配置。

      CODEX_CONFIG_TOML 会做 TOML 语法校验，CODEX_MODEL_CATALOG_JSON 会做 JSON 语法校验；校验失败时启动脚本会报错退出，不会静默 fallback 到其他配置。

      用户自定义

      启动后可以直接编辑 ~/.codex/config.toml。如果容器重启时仍然传入了 CODEX_CONFIG_TOML 或上述 API key 环境变量，启动脚本会重新生成配置；如果希望保留手工修改，重启时不要传入这些环境变量。

      相关文档