折腾了两周Codex，整理了一份从安装到实战的避坑指南

一、为什么写这篇

最近 Codex话题很热，但我搜了一圈，很少有人完整讲从安装配置 →基本使用 → 真实项目落地这条完整链路。

我自己踩了不少坑之后，决定整理出来。

教程很长放在文末啦，想着用飞书的形式大家会不会更方便看。

二、上手之前要搞清楚的几件事

先说几个很多教程没说清楚的点：

1. Codex 是什么，不是什么

它不是一个聊天机器人，而是一个能在你的本地环境里真正执行代码、读写文件、跑命令的 AIagent。这个区别很重要——它能做的事比你想象的多，但也意味着你要给它正确的上下文。

2. 环境要求

• 需要 Node.js 环境

• 需要 OpenAI API Key（或者走代理）

• 首次配置有几个坑，特别是在国内网络环境下

3. 核心操作逻辑

Codex 是「你描述任务 → 它规划步骤 → 逐步执行 → 你审批或自动跑」的流程。理解这个流程，上手速度会快很多。

三、我整理的完整教程

因为内容比较多，我放在了飞书文档里，覆盖：

• 环境安装与配置（含国内网络解决方案）

• 第一个任务怎么写prompt

• 多文件项目怎么用

• 几个真实案例演示

文档链接如下：

https://my.feishu.cn/docx/J6tWdS33IoTkVCxwL7mcJ6VonLd

也欢迎大家一起交流codex使用心得呀！！