MixLivo想用Codex处理本地项目，可以选桌面应用、命令行或编辑器扩展。第一次安装只选一个入口，先完成登录、找到正确项目，再做一个能检查结果的小任务。安装软件本身不等于已购买无限额度，ChatGPT账号登录与API Key登录还对应不同账单。
三条路线怎么选：沿用你真正工作的环境
| 你平时怎样工作 | 起点 | 首次安装不必做什么 |
|---|---|---|
| 用窗口打开文件，不常写终端命令 | 官方桌面应用 | 不必为了安装应用先装 npm 或 WSL |
| 已在 VS Code 等编辑器维护项目 | 官方编辑器扩展 | 不必另建一份不知来源的“Codex专用项目” |
| 已在 PowerShell、终端或 Linux 运行项目 | 对应系统的 CLI | 不必同时使用多种安装渠道 |
本机和远程环境要分清：代码若在 WSL、容器或远程机器，本机命令能运行，不代表远端也已安装。先按现有项目环境选一条线；桌面、扩展和 CLI 可以后续并存，第一次同时铺开会使路径和认证问题更难定位。
开始前，只准备一个范围清楚的项目目录
准备一个自己有权处理的项目目录，并先打开看一眼文件。没有项目可先建一个只放README的练习目录，不要把整个磁盘或用户目录当工作区。已有Git仓库先用git status --short查看尚未提交的工作；没有Git时至少另存现有文件。Git忽略只影响版本跟踪，不代表工具不能读取被忽略的秘密文件。
桌面路线：安装后先认出目录，不急着改代码
- 从官方桌面安装页进入Download，下载对应Windows/macOS版本并安装。
- 打开应用，选择继续登录，在自己的浏览器完成ChatGPT账号认证。
- 选择Codex入口，新建聊天并打开准备工作的项目文件夹；看清目录和权限，别误选整个用户目录。
- 首次只要求“说明这个项目的入口文件和测试命令，先不修改文件”，检查返回路径是否与实际项目对应。
完成标志：账号正确，能打开目标目录，返回内容能回查到真实文件。安装成功不代表所有模型、组织功能或额度已开放。界面没有Codex时先核对当前版本、计划和组织设置，不下载同名非官方“解锁版”。
编辑器路线：确认扩展来源及运行位置
从官方扩展文档进入扩展市场，认准发布者OpenAI与官方扩展 openai.chatgpt。安装后点击Codex图标；找不到图标时打开命令面板运行 Codex: Open Codex Sidebar。按登录页选择ChatGPT或API身份，再打开项目文件夹开始聊天。JetBrains和Xcode有各自集成，不能照搬VS Code安装按钮。
完成标志：侧栏能显示目标项目、身份可确认，能解释你选中的真实代码。项目属于远程环境时，要确认扩展与CLI实际运行在哪里，不把本机安装当成远程也已装好。
Windows命令行：安装、找到程序、进入项目
在一个新的PowerShell窗口运行官方当前独立安装命令：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
安装结束后重新开终端，先确认命令可找到：
Get-Command codex
codex --version
然后进入自己的项目目录，例如 Set-Location 'D:\Projects\demo'，运行 codex。项目本就在Linux开发环境时，也可在WSL2内使用下面Linux安装方法；不需要为了Windows支持而先强制迁移所有项目。CLI安装原文
Mac/Linux命令行：选一种安装和更新方式
Mac/Linux独立安装器：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Mac也可使用Homebrew：
brew install --cask codex
已经安装Node.js并希望使用npm时，可选：
npm install -g @openai/codex
这是可选路径，不是每种安装都必须先装Node.js。安装后新开终端，用 command -v codex与 codex --version确认找到的程序，再 cd到项目运行 codex。更新沿用原方式：独立安装器重新执行本节对应官方安装命令，npm重复上述安装命令，Homebrew用 brew upgrade --cask codex；不要多个渠道交叉覆盖后只看版本号。
这些命令只安装 Codex，不会自动补齐每个项目的 Node、Python、数据库或测试依赖。codex --version能输出，说明程序可运行；项目的启动命令报缺依赖，是下一层环境问题，不宜反复重装 Codex。
所有路线安装后，都要确认登录与收费身份
想用ChatGPT计划访问，选 Sign in with ChatGPT，或先运行：
codex login
codex login status
在浏览器完成自己的账号认证后，回终端核对身份；交互界面输入 /status查当前限制。API Key登录是按API独立计费，不会使用Plus/Pro包含用量。没有浏览器或本地回调受阻时，官方提供beta设备码方式 codex login --device-auth，需先在个人安全设置或工作区权限允许；只在自己的官方授权页输入客户端给的代码。官方认证
设备码和登录链接都只用于自己的正式认证。登录结束后再选项目：CLI 可用 PowerShell 的 Get-Location或 shell 的 pwd看当前路径。目录对但分支错，仍可能修改错误版本；已有 Git 项目也要结合原来的 git status确认现场。
第一个任务：从只读理解，到一项可审阅修改
下面用一个假设的JavaScript项目说明如何完成第一次任务；目录和文件名按自己的项目调整。
- 在项目目录运行
git status --short，记住原来已经修改的文件。先让Codex“读取README与package.json，说明启动和测试命令；不安装依赖、不改文件”。返回的命令应能在项目配置里找到。 - 确认理解正确后，再要求：“只在README补充现有测试命令的用法，不改package.json，也不运行安装或发布。”这给它一个范围明确、容易审阅的改动。
- 用
git diff -- README.md看实际差异：命令是否来自配置、有没有删除原有说明、是否混入无关承诺。未跟踪的新文件另用文件查看器打开，普通diff不自动包含它们。 - 按项目规则保存这次改动，再进入真正的代码任务。需要执行测试时明确允许的命令；区分“没有运行”“运行失败”和“运行通过”，不要把代理写的建议当测试结果。
完成标志是你能定位修改、解释为什么改、核对检查结果，只有一条“已完成”回复还不够。权限设置决定是否逐步询问，不能假定每个命令都必然再次确认。
命令速查：/model看可用模型与设置，/status查状态，codex resume选择保存会话，codex exec用于明确的非交互任务。自动化同样可能计费，先验证认证与权限。官方命令
哪里失败，就回那一层排查
| 失败位置 | 操作 |
|---|---|
| 找不到codex | 重开终端，查Get-Command或command -v；npm路径再查全局安装目录与PATH |
| 能运行但登录回不到终端 | 按认证文档核对回调或设备码，保留原报错 |
| 打开了错误项目 | 停止改动，核对工作目录后重新打开 |
| API账单在走，原本想用会员 | login status确认后，保存任务并按官方方式logout再用ChatGPT认证 |
| 已到用量上限 | /status与官方用量页查恢复时间，按续做步骤保存成果 |
| 项目测试命令失败 | 区分缺依赖、项目代码失败与Codex程序无法运行，不盲目重装全部环境 |
找不到命令时怎样进一步定位
Windows运行Get-Command codex -All，Mac/Linux运行command -v codex，先看系统实际找到了哪份程序。如果新终端能找到、旧窗口找不到，通常先重开旧窗口即可；不要继续往多个地方重复安装。npm路线可用npm prefix -g查看全局安装前缀，再对照PATH；独立安装器按它输出的安装位置检查，不照抄npm的目录。
版本命令正常、项目测试失败时，安装阶段已经过去，应查项目依赖和测试；浏览器认证完成而终端未收到结果，则查回调或设备码，不清空项目文件。当前费用与访问范围见Codex费用说明。
常见问题
Windows一定要先装WSL2吗？
不需要。官方提供Windows独立CLI安装器与桌面应用；项目依赖Linux时可按环境选择WSL2。
安装一定要Node.js吗？
只有选择npm路线需要对应Node.js环境；独立安装器与桌面路线不以npm为前提。
安装完能直接帮我部署吗？
先确认账号、项目、权限与发布要求。安装完成不代表已授权任何外部写入或生产发布。