从一台新电脑开始

把 Codex 跑到能改项目、能回退

这份教案只保留第一天必须讲清楚的基础设施：能联网、能登录、能打开真实项目、能让 Codex 改一处代码，并且能用 Git 回退。

看六步闭环看文件夹放哪里

Minimum Runnable Loop

Codex 新手最小闭环

讲课时先让听众记住这 6 块，再展开网页、小程序、VPS 或自动化。

账号

ChatGPT / Codex 登录入口先准备好。

网络

确认本机、路由器或节点至少有一条可用路径。

本机工具

终端、Git、Node、编辑器能正常打开。

Codex 登录

App 或 CLI 能完成授权并开始对话。

项目文件夹

代码进入真实 Git repo，不散落在桌面。

Git 回退

先保存版本，再放心让 Codex 修改。

Folder Map

文件夹放哪里，一眼看清

新手最容易乱的是代码、笔记、密钥和登录态混在一起。第一天只讲边界，不讲复杂同步系统。

<USER_HOME>\
|-- .codex\
|   |-- AGENTS.md
|   |-- config.toml
|   |-- sessions\
|   |-- archived_sessions\
|   `-- auth.json
|-- Documents\
|   |-- Github\      # 真实项目代码
|   |-- Obsidian\    # 人看的知识库
|   `-- Codex\       # 临时实验区
|-- .secrets\        # API keys / tokens
`-- .ssh\            # SSH keys

Branch Out

不同目标，从同一个闭环出发

网页

域名、代码托管、前端、后端、数据库、部署平台。

微信小程序

微信开发者工具打开同一个项目文件夹，Codex 继续读写代码。

VPS 服务

服务器选择、SSH、环境变量、systemd、日志和回退策略。

Deployment

本网站部署约束

Node 版本锁定为 24：`.node-version`、`.nvmrc`、`package.json engines`。
GitHub Actions 使用 `actions/setup-node` 的 `node-version: 24`。
`dist/` 是构建产物，不提交；每次部署重新生成。
网站是零依赖静态页面，适合作为演讲材料入口。