Cloudflare 正式开放在 Durable Objects 上运行 OpenAI Codex 的能力，这套方案最核心价值是云端环境和本地电脑上 Codex 的 CLI、工具链、会话行为完全保持一致，并且依托 Durable Objects 的有状态能力做到会话常驻、状态持久保存，不会因为连接中断、进程休眠、代码发布更新直接丢掉代码上下文、文件变更和任务进度；传统无服务器函数大多是一次性、无状态的，跑 Codex 这种长周期代码智能体很容易丢会话、中断任务，而 Durable Objects 可以绑定独立容器沙箱，自动快照文件系统，会话闲置后恢复时还原完整工作区，开发者不用自己维护长期运行的虚拟机、容器编排，直接在 Cloudflare 全球边缘网络托管 Codex 编码 Agent，适合做持续迭代的代码工程、多轮调试、文件修改类任务，同时权限、模型调用凭证可以隔离管控，兼顾一致性和运维轻量化。
一、核心组件与运行架构
- Durable Objects：作为会话的调度与状态载体，每个 Codex 会话对应一个全局唯一的 Durable Object 实例，自带内置 SQLite 存储，保存会话记录、操作日志、上下文快照，负责生命周期管理、容器启停、重连恢复
- Container Harness 容器适配器：负责拉起 Cloudflare 容器，在容器内运行原生 Codex CLI，保留 Codex 原本的 shell、插件、文件读写逻辑，和本地运行行为对齐，不需要改写 Codex 本身代码
- Cloudflare Sandbox 容器：独立 Linux 沙箱，提供/workspace工作目录，代码修改、文件都留在用户自己的 Cloudflare 账号内，不会直接交给 OpenAI 侧托管
- Cloudflare AI Gateway：转发 Codex 对 OpenAI 模型的调用，统一管理 API 密钥、限流、计费，凭证不会直接暴露在 Codex 容器内部
本地 Codex vs Durable Objects 托管 Codex 对比表
| 对比项 | 本地电脑运行 Codex|Durable Objects 云端运行 Codex|
| 执行环境 | 本地 Linux 环境，自带 Shell、文件系统 | Cloudflare 容器沙箱，环境、CLI 行为、工具链完全对齐本地 |
| 会话状态 | 断连、关机直接丢失上下文 | Durable Objects 持久化会话，支持文件快照、中断恢复 |
| 生命周期 | 手动启停，长时间任务依赖本机在线 | 闲置自动休眠，访问自动唤醒，可配置保活时长 |
| 网络位置 | 固定本地网络 | Cloudflare 全球边缘节点，就近调度，低延迟 |
| 运维负担 | 需要本机保持在线、配置环境、管理依赖 | 无需维护服务器，容器自动安装 Codex 并快照镜像 |
| 数据归属 | 文件存在本地磁盘 | 文件、工作区保存在用户 Cloudflare 账号，OpenAI 只接收模型调用请求 |
二、关键能力亮点
1. 执行一致性：不改动 Codex 原生逻辑
直接使用原版 Codex CLI，工具调用、命令执行、文件编辑、会话交互格式和本地完全一样，原来本地写的提示词、工作流、插件，放到云端可以直接复用，不存在行为差异、兼容性问题，这也是这个方案和其他封装 Codex API 的最大区别。
2. 常驻持久化，支持中断恢复
Durable Objects 自带任务日志、会话存储、事件流能力，任务跑一半断开 WebSocket、实例被休眠，再次连接之后可以从快照恢复工作区，已经完成的步骤会复用结果，不用从头重新跑完整 Agent 流程；闲置时支持容器快照，缩短下次唤醒的启动耗时。
3. 独立隔离沙箱，权限可控
每个 Codex 会话单独一个容器，资源隔离；容器内对外访问可以做出口白名单，限制访问范围；模型凭证由外层 Worker 转发注入，容器内部看不到原始 OpenAI 密钥，降低密钥泄露风险。
4. 边缘无服务器弹性扩缩
依托 Cloudflare 全球边缘网络，按需创建 Durable Object 实例，成千上万个 Codex 会话可以并行跑，不用提前预留服务器资源；代码更新默认延迟生效，不会强行打断正在运行的 Codex 任务，给正在执行的编码任务留出收尾时间。
三、部署落地步骤
- 准备 Cloudflare 账号，开启 Workers、Durable Objects、Sandbox 容器能力，配置 AI Gateway 绑定 OpenAI 服务商密钥。
- 拉取官方 Codex Container Harness 模板，在 wrangler 配置里设置保活时长、快照开关、出口访问白名单。
- 部署 Worker，注册 OpenAI Agents API 的 Webhook，用来接收 Codex 会话创建、状态变更回调。
- 发起会话请求，Webhook 触发 Durable Object 创建，拉起容器并自动安装 Codex，生成文件系统快照。
- 通过 WebSocket 和 Codex 会话交互，发送指令、接收代码输出；中途断连之后，再次访问同一个 Durable Object ID，自动恢复快照继续任务。
- 任务结束后主动清理会话，或者等待保活超时自动停止容器，快照可以按需保留。
四、适用场景与限制
✅ 适合场景
- 长周期编码 Agent：多轮改代码、调试、跑测试、迭代工程
- 云端持续代码助手，前端网页端直接调用 Codex，不用用户本地装环境
- 批量代码迁移、规范扫描、自动重构任务
- 面向客户的自研代码智能体产品，统一托管会话
⚠️ 限制与注意点
- 当前属于实验性 SDK 方案，接口、能力后续可能调整
- 容器快照属于尽力恢复，不是正式备份，重要代码建议搭配 R2 持久挂载
- 有资源配额、执行时长、存储容量限制，高并发场景需要评估配额
- 模型调用依然消耗 OpenAI 的额度，Cloudflare 只负责运行时托管
【相关 FAQ】
问题 1：在 Durable Objects 上运行 OpenAI Codex，怎么保证和本地环境执行行为一致？
回答 1：方案使用 Container Harness 拉起原生 Codex CLI，容器内 Shell、工具链、会话格式、文件读写逻辑和本地保持一致，没有对 Codex 本身做二次封装改写，所以 OpenAI Codex 在 Durable Objects 里的执行效果和本地电脑对齐。
问题 2：Durable Objects 托管 OpenAI Codex，会话中断之后还能不能继续之前的编码任务？
回答 2：可以。Durable Objects 会保存会话日志、事件流，空闲时对容器文件系统做快照，重新连接时恢复快照、复用已经完成的任务结果，让 OpenAI Codex 接着之前的上下文继续执行编码任务。
问题 3：Durable Objects 运行 Codex 和直接调用 OpenAI Codex API，核心差别是什么？
回答 3：直接调用 OpenAI Codex API 是 OpenAI 侧托管执行环境；Durable Objects 方案是 Codex 执行沙箱跑在用户自己的 Cloudflare 账号里，工作区文件留在 Cloudflare，同时可以拿到和本地一致的运行环境，适合需要自主管控代码沙箱、长会话的场景。
问题 4：Durable Objects 托管 OpenAI Codex，文件和代码数据是存在 OpenAI 那边吗？
回答 4：不是。Codex 运行的/workspace工作目录保存在 Cloudflare Sandbox 容器内，归属用户 Cloudflare 账号，OpenAI 只接收模型推理请求，不会拿到完整的工程文件，由 Durable Objects 负责管理整个会话沙箱。
【参考资料】
[2026-11-10]（Codex・Cloudflare Agents docs）Cloudflare 开发者文档
[2026-11-09]（Run the Codex agent loop on Cloudflare Workers）Cloudflare Changelog
[2026-10-22]（Run Codex with the OpenAI Agents API in a sandbox）Cloudflare Sandboxes 文档
[2026-10-13]（Run Codex in a sandbox）Cloudflare Sandboxes 文档
[2026-07-15]（Overview・Durable Objects docs）Cloudflare 开发者文档
【免责声明】
本文基于 Cloudflare 公开开发者文档、官方更新公告整理，仅作为技术科普参考，不构成生产环境落地建议。该 Codex 托管方案目前为实验版本，接口、计费、配额、沙箱策略后续可能变更；上线前请仔细阅读 Cloudflare 服务条款、OpenAI API 协议，做好权限隔离、代码备份与安全审计。
本文来自作者[雾簇关守者]投稿，不代表乌兰科技网立场，如若转载，请注明出处：https://www.wlcbnews.com/rgzn/202611/1776.html
评论列表（4条）
我是乌兰科技网的签约作者“雾簇关守者”！
希望本篇文章《Cloudflare Durable Objects 托管 OpenAI Codex本地一致执行环境云端常驻方案》能对你有所帮助！
本站[乌兰科技网]内容主要涵盖：互联网行业的追踪与探索
本文概览：Cloudflare 正式开放在 Durable Objects 上运行 OpenAI Codex 的能力，这套方案最核心价值是云端环境和本地电脑上 Codex 的 CLI、工具链、会话行为完全保持一致，并且依托 Durable Objects 的有状态能力做到会话常驻、状态持久保存，不会因为连接中断、进程休眠、代码发布更新直接丢掉代码上下文、文件变更和任务进度；传统无服务器函数大多是一次性、无状态的，跑 Codex 这种长周期代码智能体很容易丢会话、中断任务，而 Durable Objects 可以绑定独立容器沙箱，自动快照文件系统，会话闲置后恢复时还原完整工作区，开发者不用自己维护长期运行的虚拟机、容器编排，直接在 Cloudflare 全球边缘网络托管 Codex 编码 Agent，适合做持续迭代的代码工程、多轮调试、文件修改类任务，同时权限、模型调用凭证可以隔离管控，兼顾一致性和运维轻量化。