Codex Python SDK怎么开始用？只读线程、继续运行与恢复核对

需要把Codex接入自己的脚本时，官方Python SDK可通过本地app-server控制线程。它不同于直接调用普通聊天API，也不是把终端输出当字符串拼接。本文只读取练习仓库说明，先验证生命周期和结果字段，不执行真实仓库修改。

第一步：确认Python和运行环境

官方要求Python 3.10或以后版本，稳定包为openai-codex，发布包附带固定CLI运行时。先在独立环境安装并记录版本，不默认系统Python满足要求。已有登录和访问条件仍需符合实际账号，不能靠安装包获得模型权限。

不主动指定自定义codex_bin，除非确实要使用特定本地程序；否则可能引入SDK与CLI版本不匹配。先确认脚本工作目录与练习项目，避免从错误目录启动后读取了无关材料。

python -m pip install openai-codex

第二步：启动一个只读线程

使用上下文管理器启动和关闭Codex连接，显式选择read_only。省略模型时采用已配置默认，避免照抄账号不可用的模型名。下面只是接入示例，没有在用户机器执行代理任务。

from openai_codex import Codex, Sandbox
with Codex() as codex:
    thread = codex.thread_start(sandbox=Sandbox.read_only)
    result = thread.run("只阅读当前练习仓库README，列出安装步骤和缺失信息，不运行命令或修改文件。")
    print(result.final_response)

第三步：区分继续与恢复

同一个thread再次run是继续该线程，后续问题可以引用此前上下文；重新创建thread则是新任务。跨进程恢复需要保存正确线程标识，不能把最近线程当成一定属于当前用户或项目。

官方提供thread_resume及include_turns控制：不加载旧轮次到响应，不等于模型失去历史。应用应绑定用户、项目、线程和访问范围，恢复前先核对来源，避免把另一用户会话接到本次任务。

恢复验收：线程标识来自本应用；用户和项目匹配；工作目录正确；恢复的是目标会话；历史展示与模型上下文分别理解；当前沙箱设置已确认。

第四步：保持外部资料的身份

来自工单或其他工具的内容可用ExternalMessage作为整个输入，明确工具来源。不要将任意工单正文直接拼成应用高优先规则，尤其其中可能包含要求读取凭据或执行命令的文字。

只读沙箱仍应配合任务范围和应用权限。SDK支持在后续轮次更改沙箱，设置可能影响该轮及以后轮次；不能只检查第一次thread_start后就假定所有后续调用都只读。

第五步：核对结果与失败状态

检查final_response是否包含真实文件依据和未读取内容，不能把非空字符串当作成功完成全部检查。异常时记录阶段、版本与必要标识，不打印凭据。先用简短任务验证连接，再扩大到更多文件。

SDK适合本地程序化线程控制，需要完整自定义客户端交互时还应了解app-server。验收包括环境可用、目标线程正确、读写边界明确、结果可回查和连接能正常关闭；真实修改任务应在上述流程稳定后另行设计。

官方资料

资料核对日期：2026年11月14日。

• OpenAI：Codex SDK