Codex 是 OpenAI 推出的云端软件工程智能体Agent支持自然语言驱动的代码生成、调试、测试与项目管理提供桌面 App、CLI 命令行、IDE 插件三种使用方式需 ChatGPT Plus/Pro/Team/Enterprise 账号授权。一、桌面 App 安装推荐新手1. 下载官方安装包**Windows:**https://pan.quark.cn/s/1ed5727cd6022. macOS 安装步骤双击.dmg将Codex.app拖入Applications文件夹。首次启动Launchpad 打开 Codex → 选择Sign in with ChatGPT→ 浏览器授权登录。选择项目目录 → 进入主界面。3. Windows 安装步骤双击Codex-Desktop-xxx.exe若提示“Windows 已保护你的电脑”点击更多信息 → 仍要运行。安装依赖若缺失先安装Visual C 2019 Redistributable官网下载。完成安装 → 开始菜单搜索 Codex → 登录授权。三、CLI 命令行安装适合开发者1. 环境准备要求Node.js ≥ 22、npm ≥ 10。# Ubuntu/Debiancurl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoaptinstall-ynodejs# macOSHomebrewbrewinstallnode# 验证node-v# 输出 v22.xnpm-v# 输出 10.x2. 安装 Codex CLI# 官方源npminstall-gopenai/codex# 国内加速推荐npminstall-gopenai/codex--registryhttps://registry.npmmirror.com3. 登录与使用# 登录授权 ChatGPT 账号codex login# 进入项目目录cd/path/to/your/project# 启动对话codex# 示例指令帮我重构这个项目的目录结构并添加单元测试四、IDE 集成VS Code 等VS Code 扩展市场搜索Codex→ 安装官方扩展。登录账号 → 打开项目 → 侧边栏启动 Codex → 输入指令如“修复当前文件的 Bug”。五、基础使用流程授权登录App/CLI/IDE 均需通过 ChatGPT 账号授权。选择项目指定本地代码目录Codex 仅访问授权目录。自然语言指令代码生成“帮我用 Python 写一个 Todo 接口”调试修复“修复这个报错XXX”项目分析“梳理当前项目结构并输出架构图”。执行与确认Codex 在云端沙箱执行操作关键修改需用户确认。六、常见问题与避坑登录失败检查是否开启双重验证MFA网络需能访问 OpenAI 服务。安装卡顿国内CLI 用淘宝镜像App 切换稳定网络或加速器。权限警告Codex 仅访问用户授权目录默认沙箱隔离无需担心安全。功能限制免费体验有速率限制完整功能需Plus/Pro 订阅。七、卸载方法macOS删除Applications/Codex.app→ 清理~/.codex缓存。Windows设置 → 应用 → 卸载 Codex → 删除%USERPROFILE%\.codex。CLInpm uninstall -g openai/codex。