Codex Desktop 安装与配置
先安装 Codex Desktop,再选择 CC Switch 或 Magpie,按所选工具导入配置。配置前先完全退出客户端,完成后重新打开。
先安装 Codex Desktop,再选择 CC Switch 或 Magpie,按所选工具导入配置。配置前先完全退出客户端,完成后重新打开。
OpenAI 官方客户端,先装它。
双击安装(macOS 拖进「应用程序」),装好后打开一次,再完全退出,暂时不要重新打开。
配置前先完全退出 Codex Desktop。Windows 在右下角系统托盘右键图标,选「退出 / Quit」;macOS 先点客户端窗口,再按 ⌘Q。只关窗口不算退出。若另一个配置工具正在管理这个客户端,先停止它的代理或接管,再退出那个工具。
选择你正在使用的一个,下方会显示对应教程。已安装的可以直接进入下一步。
必须完整退出、再打开一次才生效。
Windows
没看到 Codex 图标?它可能被收进了系统托盘的隐藏区,先点任务栏右下角的 ∧ 展开。
macOS
别停在浏览器页面按 ⌘Q,那样退出的是浏览器,不是 Codex。先点一下 Codex 窗口。
本页提供 Codex Desktop 最新安装包的公开 GitHub Release 下载:Windows 是 MSIX 安装包,macOS 可选 Apple Silicon 或 Intel 版 DMG。
M1、M2、M3、M4 等 M 系列 Mac 选 Apple Silicon;较早的 Intel Mac 选 Intel 版。本页已按你的设备自动选好;若识别有误,在「下载 Codex」按钮下方的「其他版本」里选另一个即可。
选择 CC Switch 或 Magpie,先完全退出 Codex Desktop,再按对应教程导入。CC Switch 保持「导入后立即切换到这个供应商」开启;Magpie 导入供应商后,到接入页 Codex 行选择模型。配置完成后重新打开 Codex Desktop;使用 Magpie 时保持它运行。
Windows:在屏幕右下角任务栏的系统托盘里找到 Codex 图标(没看到就点 ∧ 展开隐藏图标),右键选「退出」,再重新打开。Mac:先点一下 Codex 窗口让它处于最前面,再按 Cmd + Q(⌘Q)完全退出,然后重新打开;不要停留在浏览器页面按 Cmd + Q,那样退出的是浏览器。
先确认你选择的 CC Switch 或 Magpie 已安装并至少启动过一次;浏览器询问时选择「打开」。仍无反应时,使用当前导入面板的复制链接功能,再将链接粘贴到浏览器地址栏打开。
不要把 provider 名写成 OpenAI,否则可能导致 Codex 上下文压缩失败。一键导入会写入合适的 provider 名,保留即可。
使用 CC Switch 时,在 Codex 供应商编辑页的 config.toml 中,已有的 [model_providers.xxx] 段落下加入 supports_websockets = false,保存后完全退出并重启 Codex Desktop。使用 Magpie 时,先确认 Magpie 正在运行、供应商模型可用且 Codex 已接入,再完全退出并重新打开客户端。