00-文章目录和框架
Codex 从入门到精通 — 50篇文章目录本系列文章基于 OpenAI Codex CLI 官方文档、社区最佳实践和大量实战经验编写旨在帮助读者从零基础到精通掌握 Codex CLI。篇章结构第一篇认识Codex01-05编号标题核心内容01Codex是什么AI编程助手的进化之路Codex的定义、发展历程、OpenAI的战略定位以及它如何从GPT模型演化成为终端AI编程代理02Codex CLI vs Codex App vs IDE扩展三种形态怎么选三种产品形态的定位差异、适用场景对比帮你根据自身需求选择最合适的Codex使用方式03Codex与Claude Code、Cursor、Copilot全面对比主流AI编程工具的横向对比包含功能、性能、价格、生态四个维度的深度分析04Codex的订阅体系Plus/Pro/Business/Enterprise详解ChatGPT各订阅方案包含的Codex权益、额度对比、API Key模式与订阅模式的选择策略05Codex CLI的核心架构Rust实现与设计哲学Codex CLI的技术架构解析、Rust语言带来的性能优势、开源社区的贡献机制第二篇安装与配置06-11编号标题核心内容06macOS安装Codex CLIHomebrew与npm双方案macOS环境的完整安装流程包含Homebrew安装、npm安装、路径配置和版本验证07Windows安装Codex CLI原生PowerShell与WSL2双模式Windows 10/11下的两种安装方案原生PowerShell沙箱模式和WSL2 Linux环境模式08Linux安装Codex CLI从二进制到源码编译Linux系统的多种安装方式包含预编译二进制、npm全局安装和Rust源码编译09Codex CLI国内配置指南绕过网络限制的完整方案国内用户使用Codex的完整配置方案包含API中转服务配置、镜像源设置和网络调优10认证与登录ChatGPT OAuth与API Key双模式详解Codex支持的两种认证方式登录流程、凭据管理、登出和认证状态检查11Codex的config.toml配置文件完全解析配置文件的完整参考包含所有可配置项、参数说明、配置优先级和最佳默认值第三篇基本使用12-17编号标题核心内容12Codex CLI交互模式入门TUI界面操作指南交互模式的全方位指南包含TUI界面布局、输入方式、输出展示和会话管理13非交互模式与自动化codex exec与脚本集成非交互模式的使用方法包含codex exec命令、管道输入、CI/CD集成和批量处理1430个常用命令行Flags详解Codex CLI的核心命令行参数详解包含模型选择、沙箱模式、审批策略等常用配置1540内置斜杠命令大全所有内置Slash Commands的完整参考按功能分类说明每个命令的用法和场景16用Codex从零读懂项目代码库如何利用Codex快速理解陌生项目包含项目结构分析、依赖关系梳理和业务逻辑挖掘17Codex的模型体系模型选择与推理档位指南OpenAI模型在Codex中的使用指南包含GPT-5.5/5.4/Mini等模型的选型和推理力度配置第四篇安全与权限18-21编号标题核心内容18Codex安全模型沙盒模式全解析三种沙盒模式的深入解析包含read-only、workspace-write、danger-full-access的使用场景和底层实现19审批策略详解untrusted/on-request/never三档配置审批策略的完整配置指南包含各策略的触发条件、使用建议和自动化场景的审批管理20文件访问控制与受保护目录配置如何配置Codex的文件访问权限包含受保护目录、允许路径和命令白名单/黑名单21敏感数据处理与环境变量保护Codex的敏感信息保护机制包含API密钥自动屏蔽、环境变量保护和自定义敏感数据标记第五篇项目指令与规则22-25编号标题核心内容22AGENTS.md项目指令文件从入门到实战AGENTS.md文件的完整指南包含文件格式、加载机制、全局配置和项目级配置23AGENTS.md高级用法多级覆写与分层配置体系高级AGENTS.md配置技巧包含多级目录覆写、AGENTS.override.md和合并规则24自定义回退文件名与配置切换如何自定义AGENTS.md的备选文件名以及通过CODEX_HOME切换配置目录25AGENTS.md最佳实践从真实踩坑中提炼的规则真实项目中总结的AGENTS.md编写技巧包含内容组织、大小控制、版本管理和常见陷阱第六篇MCP扩展与工具集成26-29编号标题核心内容26MCP协议是什么Codex的工具扩展体系Model Context Protocol的入门指南包含协议原理、MCP vs 传统API的对比和Codex的MCP实现27Codex MCP服务器配置添加、管理、调试完整指南MCP服务器的完整配置教程包含stdio模式、HTTP模式、环境变量配置、连接测试和故障排查286大主流MCP服务器实战应用主流MCP服务器的实战配置和使用包含数据库、网页抓取、安全扫描、代码执行等场景29将Codex CLI作为MCP Server跨Agent通信如何把Codex CLI自身作为MCP Server运行支持被其他Agent调用实现跨工具协作第七篇Skills与工作流30-34编号标题核心内容30Skills技能系统入门什么是Agent SkillsCodex Skills的概念解析包含Skill的定义、文件结构、触发机制和加载规则31创建自定义Skill从需求分析到完整封装手把手创建自定义Skill包含需求分析、YAML元数据编写、指令编写和测试验证32Skills高级特性条件触发、多步骤任务与参数化Skills的高级用法包含条件触发、多步骤工作流、参数化配置和与其他Skill的组合33Skills实战代码审查、TDD、重构等常用Skill模板可直接使用的Skill模板集合包含代码审查、测试驱动开发、重构、文档生成等34Skills与MCP的协同构建完整的自动化工作流如何将Skills和MCP服务器组合成端到端的自动化工作流包含编排策略和实战案例第八篇多Agent协作与Subagent35-38编号标题核心内容35Subagent多Agent协作为什么需要并行AgentSubagent的设计理念包含上下文污染问题、并行效率提升和Agent角色分离36内置Agent详解default/worker/explorer三大角色Codex内置三种Agent的详细说明包含各自定位、适用场景和使用建议37自定义Agent开发TOML配置与权限隔离如何创建自定义Agent包含TOML文件格式、模型分配、沙箱隔离和MCP服务器绑定38Subagent实战代码审查与多模块开发Subagent的实战案例包含并行代码审查、多模块同时开发和分布式Bug排查第九篇记忆系统与上下文管理39-42编号标题核心内容39Codex的记忆系统跨会话知识持久化内置Memory机制的详解包含自动提取、跨会话持久化和知识库集成40上下文管理compact/fork/clear高效使用如何有效管理Codex的上下文窗口包含/compact压缩、/fork分支和/clear清空的策略41会话恢复与检查点resume与Git Checkpoints会话管理的完整指南包含会话ID恢复、Git Checkpoints创建和/archive归档42Context Window优化避免上下文腐烂深入讲解Context Rot上下文腐烂的成因和预防策略包含Token预算管理和会话健康度维护第十篇实战工作流43-47编号标题核心内容43TDD工作流用Codex实践测试驱动开发Codex TDD的完整工作流包含红绿重构循环、测试先行策略和增量开发模式44Bug排查工作流系统化调试方法论Codex辅助Bug排查的完整方法论包含复现、隔离、根因分析和修复验证45代码审查工作流多维度PR审查自动化利用Subagent实现自动化Code Review包含安全审查、性能审查、可维护性评估46全栈项目开发实战从需求到部署的完整流程用Codex完成一个全栈项目的全过程包含需求分析、架构设计、编码实现和部署上线47Codex与Agents SDK集成构建多Agent编排系统如何通过OpenAI Agents SDK编排多个Codex实例构建完整的AI开发团队第十一篇进阶与生态48-50编号标题核心内容48Codex自定义模型接入指南Ollama/OpenRouter/第三方如何接入第三方模型包含Ollama本地模型、OpenRouter多模型聚合和Azure OpenAI49Codex插件系统Marketplace与自定义插件开发Codex插件生态的完整介绍包含Marketplace使用、插件安装和自定义开发50Codex CLI排错大全50个常见问题与解决方案Codex CLI使用中最高频的50个问题及解决方案包含安装、配置、网络、权限、性能等各类问题
