认知入门
Codex 是什么、五年代号演进、多端形态全景,以及与 Copilot、Claude Code、Qwen Coder 的真实对比。
本教程基于 OpenAI 官方文档、GitHub 仓库以及多家中文技术社区公开教程整理而成,所有命令、配置、参数均来自真实资料,不杜撰内容。引用来源会在各章节末尾标注。
安装与配置
全平台安装(npm / Homebrew / winget / WSL2)、认证、多端共存,含版本避坑(0.92 粘贴 bug)。
配置体系
config.toml 基础与高级、Profiles、安全模型(沙盒 × 审批)、AGENTS.md 项目指令。
核心用法
CLI 基础、Slash Commands 全解、Plan/Goal 模式、验证与 Review 闭环。
高级能力
MCP、Agent Skills、Sub-agents、Hooks、Automations、Worktrees、Cloud、In-app Browser。
实战案例
18+ 真实案例:批量 JS→TS 迁移、生成测试、CI/CD 集成、企业前端接入。
最佳实践
官方 9 大原则、Prompt 四要素、常见误区清单、成本与 Token 优化。
故障与附录
15 类常见问题速解、命令速查表、配置模板、资源链接。
本教程主要参考以下真实来源,内容准确性以官方文档为准:
- OpenAI 官方文档:developers.openai.com/codex
- GitHub 仓库:github.com/openai/codex(Rust 实现,52k+ star)
- 官方 Best Practices:Codex best practices
- 中文社区教程:编程指北 csguide.cn、CSDN「Codex 完整指南」系列、CSDN「Codex 学习篇」专栏、FastGPTPlus 等
注:Codex 迭代极快,本教程基于 2026 年中公开资料整理。如遇命令或配置与官方文档不一致,请以官方文档为准。