下载并打开 Codex
Codex 可以通过桌面端、命令行或编辑器扩展使用，它们是不同入口，不要混用安装步骤。 Windows 和 macOS 用户优先安装桌面端；Linux 用户安装 Codex CLI；只想在 VS Code、 Cursor 或 Trae 内使用时再安装扩展。已经安装的用户也要先检查更新：桌面端重新运行当前 安装器，CLI 先执行 codex update，当前安装方式不支持自更新时再用下方命令覆盖安装。
如果电脑上同时存在多个入口，本轮先选一个作为验收对象，并记住实际启动的是桌面端、CLI 还是编辑器扩展；否则后续可能改了一个入口，却在另一个入口里测试。本步骤只确认 Codex 版本、启动和登录，不会自动导入 智维 供应商，也不会更改 Key 分组。下载、更新或登录 失败时停在本页处理，保留版本和完整错误；能正常启动后再继续 CC Switch 导入流程。
选择安装方式
Codex CLILinux，也支持 Windows / macOS
macOS / Linux：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --versionWindows PowerShell：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version已经安装 Node.js 时也可运行 npm install -g @openai/codex。
VS Code / Cursor / Trae可选入口
安装 OpenAI Codex 扩展，它会读取同一份本机 Codex 配置。
安装完成后先启动所选入口：桌面端应能打开登录页，CLI 执行 codex --version 应返回版本号， 编辑器扩展应能显示 Codex 面板。记录操作系统、处理器架构和版本；如果无法启动，保留安装器 或终端的完整错误，再按对应平台重新安装一次。确认能启动后完全退出 Codex，避免下一步导入 供应商时仍有旧进程读取旧配置。
登录 Codex
打开 Codex。已有可登录账号时按界面提示完成登录；使用 智维 API Key 时，先在 API 密钥页确认 Key 仍存在，再选择 API Key 登录并粘贴完整 Key。 不要添加引号、Bearer 前缀或其他文字，也不要把完整 Key 发给他人。粘贴后如提示无效， 先重新复制一次并检查首尾空格，不要只补其中一段字符。
看到 Codex 主界面只代表客户端可以启动，还不代表 智维 已经启用。完成登录后完全退出 Codex，继续将 Key 导入 CC Switch；最终必须同时满足“发送 hi 正常回复”和“智维 使用记录出现本次新请求”，才算整个配置完成。
第 3 步完成登录成功并已完全退出 Codex。点击进入下一步。