必须确认软硬件与网络环境就绪：操作系统为Windows 10/11（启用WSL2）、macOS 12+或Ubuntu 20.04+/Debian 10+；Git≥2.23、Node.js≥18.0；内存≥8GB、磁盘≥10GB；API Key有效且能访问OpenAI、GitHub、Hugging Face。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在本地成功运行Codex并完成首次功能测试，必须提前确认软硬件环境已就绪，否则启动时会卡在依赖检查或模型加载阶段，甚至直接报错退出。
操作系统与基础工具检查
确认当前系统为 Windows 10/11（需启用 WSL2）、macOS 12+ 或 Ubuntu 20.04+/Debian 10+；打开终端执行 git --version 和 node -v，确保 Git ≥ 2.23、Node.js ≥ 18.0。若任一命令报“command not found”，需先安装对应工具再继续。
这一步不能跳过——Codex 的 CLI 初始化、PR 辅助、文件差异比对等功能均强依赖 Git；而 Node.js 不仅用于 CLI 运行，后续本地模型中转服务也需其支持。
硬件资源确认
运行 free -h（Linux/macOS）或任务管理器（Windows），确认可用内存 ≥ 8GB；用磁盘工具查看剩余空间，确保项目部署目录所在分区有 ≥ 10GB 空闲。
【显存非必需但强烈建议】 若计划启用本地 LLM 推理（如 7B/13B 量化模型），需 NVIDIA GPU + CUDA 11.8+；无 GPU 时 Codex 仍可运行，但仅支持 CPU 推理，响应延迟明显升高，且无法加载部分大模型。
网络与账号准备
第一步：打开浏览器访问 https://www.php.cn/link/742d3c2a7ceaa6143597415ae49551d0，生成新 API Key 并复制备用；
第二步：确认本地能稳定访问 GitHub、npm registry 及 Hugging Face（首次下载模型权重时需直连）；
通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
第三步：在终端执行 ping api.openai.com 和 curl -I https://huggingface.co，返回 HTTP 200 即视为通过。若超时或拒绝连接，需切换网络或配置代理——【此步失败将导致模型下载中断，且无重试提示】。
工作区信任与配置初始化
① 在 VS Code 或 Cursor 中打开目标项目文件夹；
② 弹出 “Do you trust the authors of this folder?” 提示时，必须点击 “Trust Folder”；
③ 打开集成终端，执行 codex init 生成默认配置；
④ 编辑项目根目录下生成的 .codex/config.toml，将第 3 行 api_key = "" 替换为刚复制的密钥；
这一步是运行测试的前提——不信任工作区会导致 Codex 拒绝执行文件写入和终端命令；配置未写入密钥则所有 AI 调用返回 401 错误，且错误信息极其简略，容易误判为网络问题。
