一、为什么写这篇最近 Codex话题很热但我搜了一圈很少有人完整讲从安装配置 →基本使用 → 真实项目落地这条完整链路。我自己踩了不少坑之后决定整理出来。教程很长放在文末啦想着用飞书的形式大家会不会更方便看。二、上手之前要搞清楚的几件事先说几个很多教程没说清楚的点1. Codex 是什么不是什么它不是一个聊天机器人而是一个能在你的本地环境里真正执行代码、读写文件、跑命令的 AIagent。这个区别很重要——它能做的事比你想象的多但也意味着你要给它正确的上下文。2. 环境要求需要 Node.js 环境需要 OpenAI API Key或者走代理首次配置有几个坑特别是在国内网络环境下3. 核心操作逻辑Codex 是「你描述任务 → 它规划步骤 → 逐步执行 → 你审批或自动跑」的流程。理解这个流程上手速度会快很多。三、我整理的完整教程因为内容比较多我放在了飞书文档里覆盖环境安装与配置含国内网络解决方案第一个任务怎么写prompt多文件项目怎么用几个真实案例演示文档链接如下https://my.feishu.cn/docx/J6tWdS33IoTkVCxwL7mcJ6VonLd也欢迎大家一起交流codex使用心得呀