Codex 官方教程中文版
基于 OpenAI 官方资料,按入口、配置、安全、扩展、Cloud、团队和实战场景重写的 Codex 中文查询手册。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 官方事实基准 | official baseline | 命令、配置、价格以官方文档为准。 |
| 按问题选入口 | problem-first nav | 从你要解决的问题反查该读哪章。 |
| 不硬写的信息 | volatile info | 易变的版本 / 价格不写死,留实时核验。 |
不想读完?把下面这段提示词丢给 AI 帮你跑完——帮你按要解决的问题,定位该读官方教程的哪一部分。
你是 Codex 官方教程导航顾问,帮我从要解决的具体问题出发,定位该读官方教程中文版的哪几章。
【角色】
你熟悉官方教程的章节结构和事实基准原则,能按问题反查入口,也知道哪些是易变信息需回官方实时核验。
【输入】
- 我要解决的具体问题:___
- 我用的入口(CLI / IDE / App / Cloud):___
- 我的经验水平:___
- 紧迫程度:___
【工作流程】
1. 把我的问题归类(上手 / 配置 / 安全 / 扩展 / 价格 / 团队 / 场景)
2. 定位对应的章节入口
3. 给推荐阅读顺序
4. 标出哪些细节必须回官方实时核验
【输出规范】
▌一、问题归类
▌二、对应章节入口
▌三、推荐阅读顺序
▌四、需实时核验的信息提醒
【硬约束】
- 命令、配置、价格一律以官方为准
- 按问题精准定位,不让我通读全章
- 易变信息标注需查官方实时文档
- 入口推荐贴合我的经验水平
- 给的路径要具体到章节,不空泛这一页是功能手册入口。它不替代 OpenAI 官方文档,而是把官方资料按中文开发者的查询路径重排:先选入口,再设边界,再接扩展,最后进入 Cloud、团队和真实场景。
Codex 的官方事实变化很快,所以本系列正文只固定稳定结构:App、IDE extension、CLI、Cloud 四类入口;AGENTS.md / config.toml / sandbox / approval 这条安全配置主线;MCP、Skills、Subagents、Hooks 这组扩展能力;以及 Cloud、GitHub、Slack、Linear、CI 这类团队集成。模型、价格、版本更新和功能成熟度以官方页面为准。
flowchart TB
Start[新手必读] --> Entry[产品入口<br/>App / IDE / CLI / Cloud]
Entry --> Guard[规则、安全与配置<br/>AGENTS.md / config.toml / sandbox / approvals]
Guard --> Extend[扩展能力<br/>MCP / Skills / Subagents / Hooks]
Extend --> Runtime[云端与远程环境]
Runtime --> Team[团队企业与集成]
Team --> Scenarios[实战场景与学习路线]
Scenarios --> Versions[版本、迁移与官方视频]
官方事实基准
- Quickstart 当前把 Codex 入门拆成 App、IDE extension、CLI 和 Cloud。
- Codex App 官方面向 macOS 和 Windows;平台差异以对应官方页面为准。
- Codex CLI 官方支持 macOS、Windows 和 Linux,安装入口包括
npm install -g @openai/codex和 Homebrew。 - IDE extension 官方入口覆盖 Visual Studio Code、Cursor、Windsurf 和 Visual Studio Code Insiders。
- Codex Cloud 在
chatgpt.com/codex运行,也可以通过 GitHub PR 评论里的@codex触发任务。 - 安全边界由 sandbox mode、approval policy 和 network access 共同决定;默认网络访问关闭,本地运行通常受 OS sandbox 限制。
按问题选入口
第一次跑通
从 quickstart、登录认证、术语和安全清单开始,先建立最小闭环。
选择使用入口
查 App、IDE、CLI、Web、Windows、worktree、本地运行时和浏览器能力。
设置安全边界
查 AGENTS.md、config.toml、approval、sandbox、network 和受保护路径。
扩展 Codex 能力
查 MCP、Skills、Subagents、Hooks、memory、plugins 和 workflow 组合方式。
控制成本和速度
查提示词、模型选择、用量入口、提速方法和功能成熟度;具体价格以官方为准。
使用 Cloud 和远程环境
查 Cloud runtime、网络权限和远程开发环境边界。
团队与企业落地
查 GitHub、Slack、Linear、CI/CD、SDK、企业治理和托管配置。
按场景学习
按 Web、游戏、原生应用、生产系统和效率路线选择学习顺序。
真实任务模板
把 bug 分诊、PR review、数据查询、UI 构建、部署等需求改写成 Codex 任务。
版本与迁移
只用来查官方演示、迁移说明和变更入口;不把高波动时间线当长期教程。
推荐学习顺序
- 先读 从原理到实战,理解任务、上下文、工具、边界和验证。
- 再跑 Quickstart,只做一个可回滚的小任务。
- 立刻补 第一次安全使用清单,不要让第一次体验变成大范围改动。
- 写 AGENTS.md,把项目约定沉淀成 Codex 能稳定读取的规则。
- 根据入口选择 CLI / App / IDE / Cloud,不要所有入口同时上手。
- 需要复用和集成时,再进入 MCP、Skills、Subagents、Hooks 和团队集成。
不硬写的信息
- 价格、用量、套餐、模型默认值和上下文窗口。
- 平台下载按钮、支持系统的细小差异和版本发布日期。
- GitHub、Slack、Linear、CI 集成的开关状态和企业权限策略。
- changelog、demo video 和迁移时间线。
这些内容只在对应文章里给官方入口和判断方法,不在索引页伪装成长期事实。
官方资料
- OpenAI Codex 文档:https://developers.openai.com/codex
- Codex quickstart:https://developers.openai.com/codex/quickstart
- Agent approvals & security:https://developers.openai.com/codex/agent-approvals-security
- OpenAI Codex GitHub:https://github.com/openai/codex