2026 年 Codex 客户端与 CLI 安装教程
本文面向第一次使用 Codex 的用户，介绍新版 ChatGPT 桌面应用、Codex CLI、登录方式和 IDE 使用入口。
先了解当前 Codex 入口
目前 Codex 主要通过新版 ChatGPT 桌面应用、Codex CLI、IDE 扩展和 Codex Web 使用。桌面应用已整合 Chat、Work 与 Codex，macOS 和 Windows 均可使用。
先按官方入口登录，再根据需要配置 API Key 或第三方兼容接口。
安装 ChatGPT 桌面应用
Mac 用户可以直接下载官方 macOS 安装包；Windows 用户可以通过微软商店安装，也可以使用本站提供的本地安装包。安装后打开应用并登录 ChatGPT。旧 Codex 应用更新后会迁移到新版 ChatGPT 桌面应用，已有聊天和项目会保留。
- Windows 用户也可以通过微软商店搜索并安装 ChatGPT。
安装 Codex CLI
macOS 和 Linux 可以使用官方安装脚本；Windows 可以使用 PowerShell 安装脚本，也可以通过 npm 安装。安装完成后在项目目录运行 codex，首次启动按提示使用 ChatGPT 登录或其他可用方式认证。
- macOS / Linux：curl -fsSL https://chatgpt.com/codex/install.sh | sh
- Windows PowerShell：irm https://chatgpt.com/codex/install.ps1 | iex
- 通用 npm：npm install -g @openai/codex
codex登录并开始第一个任务
进入一个本地项目目录后运行 codex，选择 Sign in with ChatGPT 或 API Key 登录方式。然后直接描述任务，例如让 Codex 解释项目、修改一个文件或运行测试。
IDE 扩展和其他入口
如果更习惯编辑器，可以安装 Codex IDE 扩展；也可以使用 Codex Web 处理云端任务。VS Code、Cursor 和 Windsurf 等 VS Code 分支可以使用扩展或在终端运行 Codex CLI。
官方客户端和 CLI 的登录、权限与用量规则可能随计划和地区变化，请以登录界面和官方说明为准。
常见问题
如果旧 Codex 应用更新后变成 ChatGPT，不需要重复创建账号；新版应用会保留已有 Codex 聊天和项目。CLI 安装后运行 codex --help 可以查看当前版本支持的命令。
下一步：配置第三方 API
完成官方登录后，如果确实需要第三方 OpenAI 兼容接口，再阅读 CC Switch 配置教程。第三方接口的模型支持、数据留存和计费规则由对应供应商负责。