返回AI 通道

Codex Desktop 安装与配置

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

  1. 1

    安装 Codex Desktop

    OpenAI 官方客户端,先装它。

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

  2. 选择并安装配置工具

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

    你使用哪个配置工具?

    安装 CC Switch

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

    教程适用 CC Switch 4.x,按 4.0.25 核对。旧版顶部标签界面请先升级到新版。

  3. 3

    登录后一键导入

  4. 4

    重启 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 已接入,再完全退出并重新打开客户端。