目录一、前言二、Codex 基本认知2.1 Codex 是什么2.2 Codex能做什么三、安裝与使用实战操作过程3.1 安装方案一3.2 安裝方案二3.3 Codex 版本过旧的解决方案3.4 第三方API设置3.5 报错解决方案3.6 codex记录查看工具3.7 codex cli 其他使用技巧四、写在文末一、前言在这个AI技术快速演进的时代AI在日常给开发者带来的提效越来越强开发者对编程工具的期待早已不只是“能用”而是希望它更高效、更智能也更贴近真实的软件工程流程。Codex作为 OpenAI 推出的 AI 编程助手正因为能够参与功能开发、代码重构、问题排查甚至协助推进更完整的工程任务而受到越来越多开发者的关注。相比传统工具链它带来的不只是代码补全而是一种更接近“协作式开发”的新体验。市面上现有的关于Codex 安装文档要么过于碎片化要么省略了关键操作细节导致初学者难以完整上手、顺利完成操作。对于我们这些追求 “吾当遣欲而澄心”、希望在安静的代码世界里寻找秩序的人来说不应该让琐碎的安装报错消磨掉最初的探索热情。因此我决定整理一份真正的“保姆级”指南。本教程将采用“全流程清晰拆解”的方式从工具准备、账号登录到实际接入项目并开始使用 Codex每一个关键环节都会配上详细说明和操作建议。无论你是第一次接触 AI 编程助手 的新手还是希望把 Codex 接入现有开发流程的开发者这篇教程都能帮助你少走弯路更顺畅地完成上手与配置。二、Codex 基本认知Codex 是 OpenAI 推出的一款AI 编程智能体。与简单的聊天机器人或代码补全工具不同Codex 能够像一个真实的开发人员一样独立理解复杂任务、操作你的电脑、编写并修改代码、运行终端命令甚至自动修复bug。ChatGPT 中的 Codex | 面向软件工程的 AI 编程智能体 | OpenAI2.1 Codex 是什么简单来说可以把 Codex 看作一个“能帮你干活的AI工程师”。它是“目标驱动”而非“指令驱动”你只需告诉它最终的目标例如“帮我搭建一个带用户登录功能的网站”它会自动拆解任务规划步骤并执行而不需要你一步步告诉它该怎么做。它不只是一个聊天框虽然你可以在ChatGPT网页版找到它但它真正的威力在于桌面应用和命令行工具CLI。在这些地方它可以直接访问你的文件系统、运行终端命令甚至操作其他软件。它的用户远超程序员官方数据显示Codex每周有超过300万用户其中近一半50%的使用场景并非编码。从写周报、整理文档到数据分析它都足以胜任。2.2 Codex能做什么近期的重大更新让Codex的能力大幅跃升使其不再局限于编程领域动打开软件、运行模拟器、发现问题、修改代码并再次测试验证完成一整套开发闭环。所见即所得的开发内置浏览器Codex内置了一个浏览器。当你开发网页时它可以直接在浏览器中展示效果。你可以直接在渲染出的网页上圈出问题比如圈出一个标题并写上评论“字体太大颜色改成蓝色”Codex就能理解视觉和空间上下文并精准地修改对应的代码。“心跳”机制与长期记忆自动排班你可以交付给它一个需要数小时甚至数周的长线任务。即使你关掉电脑它也会在约定的时间点“自动醒来”在后台继续工作。记忆功能它会记住你的编码偏好和纠正过的错误下次再合作时就不需要从头开始解释了。强大的工具生态Codex已经接入了超过90个插件可以无缝连接JIRA、GitLab、Microsoft Suite、Slack、Gmail等常用工具。你可以让它去Notion里读文档、去邮箱里看邮件、去项目管理工具里筛选Bug再把所有信息汇总成一份报告给你。三、安裝与使用实战操作过程3.1 安装方案一点击进入到openai官网点击【Download for Windows】按钮如下图进入到新页面后点击Download或者Install按钮如下图所示下载Codex Installer.exe文件到本地某个目录后双击进行安装如果出现上图中的无法下载、微软应用商店空白、微软商店需要连接等报错则说明无法直接进行下载此时可采用另外一种方法进行下载安装。具体方法是点击.msix结尾的文件如下图文件下载完毕后点击进入到所在文件夹之中复制地址库的路径如下图按下键盘上的 Win R 组合键在运行框中输入powershell后点击确定使用cd命令切换到上两步所在路径并输入命令Add-AppxPackage .\Open并按下TAB键进行文件名补全补全后按下回车键运行即可然后在桌面左下角输入codex点击Codex应用以运行如果双击后无响应则请采用方案二下面的方案进行安装3.2 安裝方案二点击进入到github 哈雷大佬链接 GitHub - Haleclipse/CodexDesktop-Rebuild: Codex Desktop App - Cross-platform Rebuild · GitHub选择Release下的版本号这里以v1.0.4为例但请下载其中的最新版本点击以.Setup.exe结尾的文件名从而对windows的安装文件进行下载如下图下载安装后点击继续使用 ChatGPT 登录如下图所示输入邮箱或者选择其他方式进行登录点击 Continue点击继续最后进入到下面的Codex操作界面了需要说明的是可通过修改auth.json和config.toml来配置相应的api-key和model_providers如下图所示3.3 Codex 版本过旧的解决方案如果使用方案二安装Codex可能会出现以下报错如下图点击进入到openai的codex的官网链接点击Release下最新的版本如下图下载以msvc.exe.zip结尾的文件如下图解压后将其中的文件复制到Codex的resources目录下如下图将之前codex.exe修改为codex.exe_bak再将condex-x864_64-pc-windows-msvc.exe修改为codex如下图再在windows搜索框中输入codex双击打开就不会报错了如下图3.4 第三方API设置对于初学者而言使用cc-switch进行API的配置会更加节省成本而且可以接入更多国产大模型点击进入到cc-switch的主页再点击Releases下的图标如下图点击以Windows.msi结尾的文件进行下载如下图安装完毕后启动cc-switch先点击Codex图标再点击号图标如下图填入API Key、请求地址和模型名称请根据实际情况进行填入如下图填写完毕后然后点击右下角的添加如下图点击启用按钮如下图如果显示使用中的状态则说明设置成功了如下图所示3.5 报错解决方案如果出现以下报错3.6 codex记录查看工具开源项目对应链接为https://github.com/Dimillian/CodexMonitor点击Release进入到资源页面如下图点击以x64-setup.exe结尾的文件如下图设置好wordspace目录后效果如下图所示3.7 codex cli 其他使用技巧以下是codex cli的使用技巧如果是app的话暂时无法使用。codex --dangerously-bypass-approvals-and-sandbox让 Codex 跳过审批机制和沙箱限制直接在本机环境中执行命令、读写文件或联网操作。它权限很高适合完全信任的本地开发场景但误操作或恶意指令可能造成文件删除、泄露密钥、执行危险命令等风险。codex exec explain utils.tsCodex 的单次执行命令不进入对话界面执行完指令就退出。这里的作用是让 Codex 一次性解释当前目录下 utils.ts 文件的代码逻辑适合快速完成批量处理、脚本调用或自动化文档生成等一次性任务。codex --full-auto create the fanciest todo-list app:这是 Codex 的全自动沙盒模式开启后 Codex 会在后台自主规划、写代码、调试全程不需要人工确认。这里的作用是让 Codex 从零创建一个功能完善的待办清单应用适合快速原型开发、完整项目搭建等需要持续迭代的任务。四、写在文末本文详细介绍了Codex 在windows环境下的安装过程希望对看到的同学有用哦本文到此结束感谢观看。