指南
API
博客
版本
指南
API
博客
简体中文

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_API_KEY。

配置示例

官方 OpenAI API：

docker run --security-opt seccomp=unconfined --rm -it \
  -p 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 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

配置优先级

启动时按以下顺序选择 API key：

  1. CODEX_API_KEY
  2. ARK_API_KEY
  3. OPENAI_API_KEY

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

用户自定义

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

相关文档