先说明适用范围
本页依据公开官方资料整理,帮助你理解 Codex 的入口、功能、权限和工作流。实际可用性取决于账户、套餐、地区、客户端、工作区权限和当前 rollout,请以官方页面与账号显示为准。
官方参考:Codex SDK · GitHub Action · Non-interactive mode
Codex SDK 适合什么?
当你想在自己的 Node.js 服务、CI/CD、内部工具或自动化系统中调用 Codex 时,使用 Codex SDK。官方 TypeScript SDK 可以启动、继续和恢复本地 Codex thread。
App Server 解决什么问题?
App Server 适合自己构建客户端,需要自己处理认证、会话历史、审批和流式 Agent 事件。它是已有自定义集成替代旧 mcp-server 方式的主要方向。
GitHub Action 适合什么?
GitHub Action 适合在 Pull Request、Release 或 CI 工作流中自动运行 Codex,例如代码审查、发布准备、迁移和质量检查。可以把结果写回 PR 或让工作流失败。
SDK、Action、CLI 怎么选?
本地脚本和单次自动化用 CLI;GitHub 原生工作流用 GitHub Action;需要在自己的产品中控制会话和审批用 SDK/App Server。接入前先确定认证方式、仓库权限、网络和输出如何审查。
常见问题
Codex SDK 需要什么环境?
官方 TypeScript SDK 运行在服务端,文档要求 Node.js 18 或更高版本。
GitHub Action 会自动部署生产环境吗?
不会自动等同于生产部署,是否部署取决于你的工作流文件、权限和审批步骤。
旧的 codex-mcp-server 还能用吗?
当前官方 SDK 文档说明旧的独立 mcp-server 方式已移除,应使用 App Server 处理现有集成。