保姆级教程!全网疯传的 Codex 知识库中文版来了。。。
老读者应该知道,Codex 一直是我的主力工具,用了很长时间了,之前的大部分文章中使用示例也都是在 Codex 中完成的。
后台经常有人问,Codex 怎么入门,报错了去哪查,想再深入一点该看什么。我每次都先翻下聊天记录,把之前零散说过的东西再拼一遍发过去,拼完自己都觉得乱。
系统的资料我自己也找过,官方文档是英文的,按功能讲,不教流程。中文的教程倒不少,就是太散,今天一篇讲安装,明天一篇讲 MCP,单看每篇都没毛病,合起来串不成一条线。
前段时间朋友给我发了份文档,一份 Codex 知识库,中文的。我翻完觉得不错,今天拿出来讲讲。
这份知识库是什么
先报下规模:500 多篇知识文章,40 多个工程实践,20 多个高级玩法,100 多个完整项目案例,50 多个问题排查方案。
量大自然好,但我觉得它真正值钱的地方是组织方式。整个知识库按真实开发流程排,从安装跑通,到日常踩坑,再到完整项目,最后到进阶原理,你处在哪个阶段,就从哪一层进。
第一层:快速上手
安装、环境配置、第一个项目,每一步都有具体操作,Windows、Mac、Linux 分开写。跟着做就能跑通,不用自己再把环境坑踩一遍。

第二层:问题大全
登录失败、Permission denied、Context 超长、MCP 调用失败,这些常见报错都能直接查到处理办法,不用全网搜,不用在十几个网页里翻来翻去。
我自己之前排查问题就靠搜,一个 Permission denied 能搜出七八种说法,还得自己判断哪个适用。这部分等于有人先把坑蹚了一遍,另外还附了三个通用的调试技巧,看 verbose 日志、找配置文件位置这些,都写了。

第三层:案例库
写后台、写 Agent、写 Chrome 插件、写 MCP、写 RAG 知识库,全是真实项目。从需求、Prompt、思路、踩坑到最终代码,完整拆给你看。
我自己看这类内容,最想看的其实不是最终代码,是中间怎么踩的坑、怎么爬出来的。Demo 只给你看结果,这部分把过程也留了。

第四层:高级玩法
MCP、Context Engineering、Memory、Skill、AGENTS.md 这些进阶内容都有,不只讲怎么用,还讲为什么这么设计。
比如 AGENTS.md 那条指令链,Codex 每次启动按什么顺序找文件、找到之后怎么拼、超了大小限制怎么办,都写清楚了。这些东西自己翻文档也能搞明白,就是要花不少时间。

我的想法
知识库放在飞书文档里,结构清楚,能搜,会持续更新,国内的模型也在陆续适配 Codex,这块内容后面应该会越来越全。
我的感受是,Codex 本身不算难学,难在资料太散。有人肯花时间把这条路从头到尾整理好,省的是你自己的时间。
这份知识库免费,感兴趣的话,扫下面的码领。

