国潮造物局 · 实操文章

OpenAI Codex完整入门：让Codex修一个有验收标准的小问题

从官方入口、安装与首次配置开始，跟做“让Codex修一个有验收标准的小问题”，附样例、流程图、验收与故障排查。

本页目录 · 15个部分

国潮造物局编辑部 · 资料整理日期 2026-10-21 · 编程实践 · 12分钟

资料核对：2026-10-21。OpenAI官方IDE文档跳转已核对；未替用户安装或验证账户。图为本站原创操作示意，不是软件界面截图。

01 先知道要做成什么

让Codex修一个有验收标准的小问题。本篇只教一个能检查结果的首个任务，再扩展到真实工作；不把生成一次等同于专业交付。

从官方Codex入口选择适合自己的桌面、IDE或CLI路线。本篇选IDE：先安装VS Code，再按OpenAI官方IDE扩展文档的安装链接进入扩展市场，核对发布者OpenAI并登录。各系统支持范围与账户权限以该页为准，不下载第三方同名安装器。

一个可本地运行的测试项目和备份/Git记录；先约定可修改文件与禁止触碰的配置。安装工具、下载模型、调用云服务可能分别计费。先查看官方要求与许可，密钥只存凭证设置或环境变量，不放提示词。

在编辑器打开实际项目根目录，选择该工作区；先要求读取说明和相关文件，再复述问题。

给复现、预期、范围，要求先定位再最小修改。不要用“优化所有代码”作为第一条任务。

查看差异与工具执行结果；运行必要检查前确认命令用途。密码、私钥、支付密钥不贴入聊天。

启动实际项目，重现原操作；将静态检查、自动测试、浏览器实际操作分别记录，不把回答文字当验证通过。

先阅读项目说明和相关文件。复现【操作】会出现【错误】，预期【结果】。只修根因，不重构无关模块；完成后运行必要检查并明确尚未实测的部分。

保留变更、测试日志和仍待验证事项，确认后再部署；不要自动覆盖生产配置。

原问题可复现且修复后不再发生；必要测试确实运行；没有额外无关修改。建议记录：输入、实际输出、是否通过、需修改的地方。先用一条正例和一条反例，确认后再扩大批量。

连接目录不对先纠正工作区；执行被限制时说明具体失败动作，不编造成功。IDE扩展与桌面应用是不同安装路线。

先用本篇虚构样例练习，再替换成经授权并脱敏的材料。涉及账号、客户、商业和个人信息时先确认平台数据处理规则。对外发布前核对事实、权利和访问权限；官网界面更新时以官方帮助为准。