跳到主要内容

编程智能体

OpenAI Codex

在沙箱中以 headless 模式运行 OpenAI 的 Codex CLI,配备独立的文件系统、终端和 git。将它指向一个代码仓库,让它工作,然后取回 diff。

维护方
E2B
集成方式
预构建的 codex 沙箱模板
软件包
e2b
语言
TypeScript, Python

配置

快速开始

将提示词粘贴到您的编程智能体中,或按以下步骤自行配置。

粘贴到您的编程智能体中

在此项目中,于 E2B 沙箱内运行 OpenAI Codex。

  1. 1.使用项目的包管理器安装 e2b SDK。
  2. 2.SDK 需要 E2B_API_KEY 环境变量,Codex 需要 CODEX_API_KEY(一个 OpenAI API 密钥)。如果尚未设置 E2B_API_KEY,请向我索要 API 密钥(在 https://console.e2b.dev/?tab=keys 获取)。切勿将任何一个密钥硬编码。
  3. 3.按照 https://docs.e2b.dev/agents/codex 上的 Codex 指南操作:从 codex 模板创建沙箱,在 envs 中传入 CODEX_API_KEY,并以 --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check 和为 0 的命令超时运行 codex exec。在 finally 块中终止沙箱。
  4. 4.运行一个任务,并展示来自沙箱的输出。

或自行配置

  1. 1. 安装 E2B SDK

    npm init -y && npm pkg set type=module
    npm install e2b
    npm install -D tsx
  2. 2. 设置 API 密钥

    export E2B_API_KEY="e2b_..."
    export CODEX_API_KEY="..."
  3. 3. 以 headless 模式运行 Codex

    import { Sandbox } from 'e2b'
    
    const apiKey = process.env.CODEX_API_KEY
    if (!apiKey) throw new Error('Set CODEX_API_KEY to your OpenAI API key')
    
    const sandbox = await Sandbox.create('codex', {
      envs: { CODEX_API_KEY: apiKey },
    })
    
    try {
      const result = await sandbox.commands.run(
        `codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check "Create a hello world HTTP server in Go"`,
        { timeoutMs: 0 }
      )
      console.log(result.stdout)
    } finally {
      await sandbox.kill()
    }
  4. 4. 处理代码仓库

    await sandbox.commands.run(
      'git clone --depth 1 https://github.com/e2b-dev/claude-code-fastapi.git /home/user/repo'
    )
    
    await sandbox.commands.run(
      `codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check -C /home/user/repo "Add error handling to all API endpoints"`,
      { timeoutMs: 0 }
    )
    
    const diff = await sandbox.commands.run('git -C /home/user/repo diff')
    console.log(diff.stdout)

安全

沙箱中运行的内容

Codex 及其运行的每条命令都在沙箱中,因此可以关闭 Codex 自带的命令沙箱。

  • 智能体codex exec,绕过了审批和 Codex 自带的沙箱。改由 E2B 作为隔离边界。
  • 文件您克隆的代码仓库,以及 Codex 做出的每一处修改。可用 files.read() 或 git diff 读回结果。
  • 会话rollout 文件位于 ~/.codex/sessions 下。codex exec resume 可用后续任务继续一个会话线程。
  • 网络默认可以访问互联网。处理不受信任的输入或密钥时,请用网络规则限制出站流量。

已启动 30亿+ 个沙箱

为每个智能体 配一台机器