codex需先准确识别项目结构、读取文件并理解上下文才能安全编码。必须安装cli、初始化git、确保入口文件存在，并用精准指令触发任务，否则易导致逻辑错误或环境破坏。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让 Codex 真正开始帮你写代码，不是打开对话框随便说一句“写个登录页”就完事——它必须先准确识别项目结构、读取已有文件、理解上下文，才能安全修改。这一步没做对，后续所有生成都可能脱离实际、覆盖关键逻辑、甚至破坏运行环境。
确认 Codex 已安装并可调用
在终端输入 codex --version，能返回类似 codex 0.12.3 的版本号，说明 CLI 已正确安装。若提示 command not found，请先执行 npm install -g @openai/codex 并重启终端。
Windows 用户若用 PowerShell 安装失败，改用 cmd 或管理员权限的 PowerShell 运行安装命令——权限不足会导致二进制文件未写入 PATH。
准备一个干净、可恢复的项目空间
新建一个空文件夹，例如 my-landing-page，不要选桌面、文档或下载目录作为根目录——Codex 会递归扫描全部子文件，混杂私人文件可能导致意外读取或误删。
【必须初始化 Git】 在该文件夹内执行 git init && git add . && git commit -m "initial commit"。这一步不是可选项：Codex 修改文件后会以 diff 形式展示变更，没有初始提交，你就无法判断它到底改了哪几行，也无法一键回滚。
如果项目已存在（比如一个 Vue 项目），确保 package.json 或 pyproject.toml 等入口文件在根目录下——Codex 依赖这些文件识别技术栈和启动方式。
进入项目目录并启动 Codex
终端中执行：cd my-landing-page → codex。此时 Codex 会自动加载当前目录结构，显示类似 Found 3 files: index.html, styles.css, script.js 的提示。
如果卡在 “Loading project context…” 超过 30 秒，大概率是网络问题或 API 配置错误；检查 CC Switch 是否启用对应配置，或确认 OPENAI_API_KEY 环境变量是否生效。
用精准指令触发第一次编码任务
方法一：直接描述目标 + 约束条件
在 Codex 交互界面输入：请在当前目录创建一个单页个人介绍网站，包含姓名、一句话简介、3个作品链接。使用纯 HTML/CSS，不引入外部 CDN，所有样式写在 style 标签内。完成后用浏览器打开 index.html 验证。
方法二：分步引导（推荐给复杂项目）
第一步：先让 Codex 阅读现有代码 → 输入：请先列出当前所有文件内容，并说明这个项目目前的技术栈和启动方式。
第二步：确认理解无误后，再下达修改指令 → 输入：现在请为首页添加一个深色模式切换按钮，点击后切换 body 的 class 为 dark/light，并更新 CSS 中对应的背景与文字颜色。
注意：不要省略“当前目录”“不引入外部 CDN”“完成后用浏览器打开”这类具体约束——Codex 不会主动猜测你的偏好，模糊指令大概率生成不可用的代码。
