安装客户端

Codex 下载安装教程
选择你的系统，从官方入口下载安装

小贺AI编辑部 · 资料核对 2026-10-14 · 教学操作与预期结果

Codex

CodexAI 编程助手从官方入口下载安装

CodexOpenAI 官方
AI 编程工具

安装前准备：先分桌面应用与 CLI

想在图形界面选择项目、阅读改动，选择桌面应用；想在终端工作或接入已有脚本，选择 CLI。能打开桌面应用，不代表终端中已安装 codex 命令；终端找不到命令，也不能单独证明桌面安装失败。

确认实际操作系统和处理器架构，并准备一个没有敏感文件的练习目录。下载入口及系统要求见官方桌面说明和 Codex CLI 官方说明。当前官方桌面文档归在 ChatGPT desktop app 下，可从其中进入 Codex；界面名称与支持范围以官方当前页面为准。

桌面用户可使用下方 Windows、macOS 官方下载入口；不匹配当前系统、下载失效或需要其他系统时，返回官方桌面下载说明选择对应方式。完成安装后打开应用，确认能到达登录或项目界面。这一步只验证应用可以启动。

Windows（按官方系统要求）

macOS（Apple Silicon）

CLI 用户按官方 CLI 安装说明选择自己的系统，保存安装器提示的实际路径，再新开终端检查。Windows PowerShell：

powershell

Get-Command codex -All
codex --version

macOS 或 Linux 用户可在 Shell 中运行当前官方原生安装命令：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

完成后新开终端，检查实际路径和版本：

command -v codex
codex --version

预期能解析到实际的可执行文件路径并输出版本号。查到多个路径时，先确认当前运行的是哪一份；找不到命令时，检查安装来源、安装目录和 PATH。不要把 Shell 安装命令直接粘进 PowerShell，也不要把版本号输出当成登录或 API 验证成功。

记录商店提示和失败阶段，按微软商店打不开怎么下载Codex？Windows版MSIX安装教程检查官方安装器、离线包与签名核验。不要仅根据文件名判断安装包来源。

先区分刚装的是桌面应用还是 CLI。只有 CLI 路线需要终端解析到 codex；安装 CLI 后新开终端，按上一节查看实际路径。不要混用多套全局安装后反复重装。

保留系统、下载域名、HTTP/TLS 错误和时间，再判断是目录权限、网络还是组织策略。代理是否适用取决于下载源与报错，不能统一要求必须开或必须关；组织设备应先确认允许的安装方式，不把管理员权限当成所有安装错误的通用解法。

安装、认证、配置读取和任务执行是不同阶段。登录失败看账号及认证提示；配置解析失败看实际文件与作用域；任务失败再看工作目录、模型权限与请求记录。可继续查看配置不生效排查。

每次充值达到 50 元人民币，可获得一次免费远程协助机会，通过微信申请。

先按已有条件选路线。使用官方账号登录的读者，不必为了完成安装教程购买第三方 API。

你的条件	下一步	需要分清的边界
使用 ChatGPT 账号登录	桌面按登录界面继续；CLI 可运行 `codex login`，按浏览器提示完成授权	可用功能取决于当前账号与计划，不能由安装成功推断全部权益
使用 OpenAI API	按官方 API Key 认证说明选择 API 路线	API 按使用量计费，不等同于 ChatGPT 订阅权益
使用兼容第三方 Provider	查看 Codex API 配置；管理多套配置再用 CC Switch	协议、模型、凭证与计费归属于所选服务，服务 Key 不是官方登录身份

CLI 可运行 codex login status 查看当前登录状态。选定路线后，在练习目录放入 README.txt，内容为 practice；进入该目录启动 CLI，或在桌面应用选择这个项目，发送：

text

只读取当前目录的 README.txt，告诉我文件内容和文件路径。不要修改文件、安装依赖或联网搜索。

预期读到 practice 并指出文件路径，再核对目录没有新增或改动。API 路线还需按服务提供的请求记录检查请求归属；一次任务成功不等于所有模型和额度都可用。首次改文件可以继续做可回退小任务。

资料核对：2026-10-14，依据上文官方桌面、CLI 和认证文档。这里列出教学操作与预期结果，未声称完成各系统安装或实际账户请求测试。