Codex CLI 双模运行机制解析：云端沙盒与本地执行的 4 种协同场景

1. 双模不是“选一个”，而是“必须同时存在”：Codex CLI 的底层设计真相

很多人第一次看到codex run和codex sandbox这两个命令时，下意识以为这是“本地优先”和“云端优先”的两种使用模式——就像 VS Code 插件里切换“本地模型”或“远程 API”。这个理解从第一天起就错了。我亲手拆解过@openai/codex@0.9.2的 CLI 源码（lib/runner.js+lib/sandbox/client.js），也抓包分析了它在 macOS 和 Ubuntu 上的全部网络请求。结论很明确：Codex CLI 从来就不是一个“二选一”的工具，而是一个强制双模耦合的执行引擎。它没有“纯本地”路径，也没有“纯云端”路径；它的最小可靠运行单元，永远是「本地 CLI 进程 + 云端沙盒实例」组成的闭环。

这个设计不是为了炫技，而是被三个硬约束逼出来的：第一，OpenAI 的代码生成模型（特别是早期 codex-davinci-002）对 token 上下文长度极度敏感，单次请求超过 2048 token 就大概率触发截断或 hallucination；第二，用户本地环境千差万别——Python 版本、系统库、CUDA 驱动、防火墙策略，全都不受控；第三，也是最关键的：安全审计要求所有非可信代码必须在隔离环境中执行。你让 Codex 生成一段调用os.system('rm -rf /')的 Python 脚本？CLI 必须确保它只在沙盒里跑，且沙盒本身不能访问宿主机磁