返回AI 通道

Codex Desktop 安装与配置

先安装 Codex Desktop,再选择 CC Switch 或 Magpie,按所选工具导入配置。配置前先完全退出客户端,完成后重新打开。

  1. 1

    安装 Codex Desktop

    OpenAI 官方客户端,先装它。

    配置前先完全退出 Codex Desktop。Windows 在右下角系统托盘右键图标,选「退出 / Quit」;macOS 先点客户端窗口,再按 ⌘Q。只关窗口不算退出。若另一个配置工具正在管理这个客户端,先停止它的代理或接管,再退出那个工具。

  2. 选择并安装配置工具

    选择你正在使用的一个,下方会显示对应教程。已安装的可以直接进入下一步。

    你使用哪个配置工具?

    安装 Magpie

    下载后安装并打开,保持 Codex Desktop 完全退出。

    选择适合电脑系统的版本。配置完成后,使用 Codex Desktop 时也要保持 Magpie 运行。

  3. 3

    登录后导入到 Magpie

    获取导入配置,再点「打开 Magpie 导入」。浏览器询问时允许打开 Magpie,在「供应商 / Providers」的「来自链接 / From link」确认页核对名称与端点,点「添加 / Add」。已有同名配置时会显示「替换 / Replace」。

    界面示意按 Magpie 开源界面还原 · 示例数据
    1核对后在 Magpie 点「添加 / Add」。若同名配置已存在,按钮会显示「替换 / Replace」。

    添加后在供应商卡片查看模型是否加载成功。模型列表为空时,先检查供应商的端点、密钥和可用模型,再进行接入。

  4. 4

    在 Magpie 中接入 Codex Desktop

    打开「Agent」,找到 Codex 行,点击模型下拉框,选择刚导入的 AI 通道 供应商下要使用的模型。选择 Magpie 模型后会自动接入;确认该行的接入开关已开启。

    Codex Desktop 与 Codex CLI 共用 Codex 配置。如果 CLI 也在运行,结束旧进程后重新启动,让它读取新配置。

    界面示意按 Magpie 开源界面还原 · 示例数据
    1–3Agent → Codex 的模型下拉框 → 本站供应商下的模型。选择后会接入 Magpie。
    模型名称仅为示例,以你的密钥实际获取的列表为准。

    按下方步骤重启后,新建会话,确认使用刚选的模型,再发一条消息验证。

    整个使用过程中保持 Magpie 运行;退出 Magpie 会让通过本机网关的请求无法连接。

  5. 5

    重启 Codex Desktop

    必须完整退出、再打开一次才生效。

    Windows

    1. 1在任务栏右下角点 ∧ 展开隐藏图标。
    2. 2找到 Codex 图标。
    3. 3右键点击,选「退出 Exit」。
    4. 4重新打开 Codex Desktop。

    没看到 Codex 图标?它可能被收进了系统托盘的隐藏区,先点任务栏右下角的 ∧ 展开。

    macOS

    1. 1先点一下 Codex 窗口,让它处于最前面。
    2. 2点顶部菜单栏的 Codex 菜单(或直接按快捷键)。
    3. 3选「退出 Codex ⌘Q」。
    4. 4重新打开 Codex Desktop。
    ⌘+Q窗口在最前时最快

    别停在浏览器页面按 ⌘Q,那样退出的是浏览器,不是 Codex。先点一下 Codex 窗口。

    能正常对话即说明已生效。

常见问题

Codex Desktop 怎么下载?

本页提供 Codex Desktop 最新安装包的公开 GitHub Release 下载:Windows 是 MSIX 安装包,macOS 可选 Apple Silicon 或 Intel 版 DMG。

macOS 应该选 Apple Silicon 还是 Intel?

M1、M2、M3、M4 等 M 系列 Mac 选 Apple Silicon;较早的 Intel Mac 选 Intel 版。本页已按你的设备自动选好;若识别有误,在「下载 Codex」按钮下方的「其他版本」里选另一个即可。

可以选择哪些配置工具接入 AI 通道?

选择 CC Switch 或 Magpie,先完全退出 Codex Desktop,再按对应教程导入。CC Switch 保持「导入后立即切换到这个供应商」开启;Magpie 导入供应商后,到接入页 Codex 行选择模型。配置完成后重新打开 Codex Desktop;使用 Magpie 时保持它运行。

导入后怎么重启 Codex Desktop?

Windows:在屏幕右下角任务栏的系统托盘里找到 Codex 图标(没看到就点 ∧ 展开隐藏图标),右键选「退出」,再重新打开。Mac:先点一下 Codex 窗口让它处于最前面,再按 Cmd + Q(⌘Q)完全退出,然后重新打开;不要停留在浏览器页面按 Cmd + Q,那样退出的是浏览器。

点导入按钮没弹出所选配置工具怎么办?

先确认你选择的 CC Switch 或 Magpie 已安装并至少启动过一次;浏览器询问时选择「打开」。仍无反应时,使用当前导入面板的复制链接功能,再将链接粘贴到浏览器地址栏打开。

provider 名为什么不要写成 OpenAI?

不要把 provider 名写成 OpenAI,否则可能导致 Codex 上下文压缩失败。一键导入会写入合适的 provider 名,保留即可。

Codex 一直 Reconnecting 怎么办?

使用 CC Switch 时,在 Codex 供应商编辑页的 config.toml 中,已有的 [model_providers.xxx] 段落下加入 supports_websockets = false,保存后完全退出并重启 Codex Desktop。使用 Magpie 时,先确认 Magpie 正在运行、供应商模型可用且 Codex 已接入,再完全退出并重新打开客户端。