Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.superserve.ai/llms.txt

Use this file to discover all available pages before exploring further.

Codex is OpenAI’s terminal coding agent. Run it in a Superserve sandbox so its shell commands and file edits stay isolated from your machine.

Via the console

  1. Go to console.superserve.ai and click Create sandbox.
  2. Pick the superserve/node-22 template.
  3. Open Advanced Options and add OPENAI_API_KEY under Environment Variables.
  4. Create the sandbox, open its Terminal, and run:
    npm install -g @openai/codex && codex
    

Via the SDK

npm install @superserve/sdk
export SUPERSERVE_API_KEY=ss_live_...
import { Sandbox } from "@superserve/sdk"

const sandbox = await Sandbox.create({
  name: "codex",
  fromTemplate: "superserve/node-22",
  envVars: { OPENAI_API_KEY: "sk-..." },
})

await sandbox.commands.run("npm install -g @openai/codex")
Open the sandbox in the console, launch the terminal, and run codex.

Persist sessions

await sandbox.pause()
await sandbox.resume()