Codex Desktop 安装与配置
先安装 Codex Desktop,再选择 CC Switch 或 Magpie,按所选工具导入配置。配置前先完全退出客户端,完成后重新打开。
先安装 Codex Desktop,再选择 CC Switch 或 Magpie,按所选工具导入配置。配置前先完全退出客户端,完成后重新打开。
OpenAI 官方客户端,先装它。
双击安装(macOS 拖进「应用程序」),装好后打开一次,再完全退出,暂时不要重新打开。
配置前先完全退出 Codex Desktop。Windows 在右下角系统托盘右键图标,选「退出 / Quit」;macOS 先点客户端窗口,再按 ⌘Q。只关窗口不算退出。若另一个配置工具正在管理这个客户端,先停止它的代理或接管,再退出那个工具。
选择你正在使用的一个,下方会显示对应教程。已安装的可以直接进入下一步。
下载后安装并打开,保持 Codex Desktop 完全退出。
选择适合电脑系统的版本。配置完成后,使用 Codex Desktop 时也要保持 Magpie 运行。
获取导入配置,再点「打开 Magpie 导入」。浏览器询问时允许打开 Magpie,在「供应商 / Providers」的「来自链接 / From link」确认页核对名称与端点,点「添加 / Add」。已有同名配置时会显示「替换 / Replace」。
添加后在供应商卡片查看模型是否加载成功。模型列表为空时,先检查供应商的端点、密钥和可用模型,再进行接入。
打开「Agent」,找到 Codex 行,点击模型下拉框,选择刚导入的 AI 通道 供应商下要使用的模型。选择 Magpie 模型后会自动接入;确认该行的接入开关已开启。
Codex Desktop 与 Codex CLI 共用 Codex 配置。如果 CLI 也在运行,结束旧进程后重新启动,让它读取新配置。
按下方步骤重启后,新建会话,确认使用刚选的模型,再发一条消息验证。
整个使用过程中保持 Magpie 运行;退出 Magpie 会让通过本机网关的请求无法连接。
必须完整退出、再打开一次才生效。
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 已接入,再完全退出并重新打开客户端。