返回AI 通道
Codex Desktop · 下载与配置

Codex Desktop 安装、离线安装包下载与配置教程

按 3 步走:先安装 Codex Desktop,再安装 CCSwitch,最后登录 AI 通道 一键导入 Codex / codex 配置。Windows 优先用官方 Microsoft Store;Store 打不开或按钮不显示时再用离线安装包;macOS 直接下载对应 DMG。

3 步完成下载、安装和配置教程

  1. 1

    安装 Codex Desktop 与离线安装包下载

    1. Windows: 优先打开 Windows 官方 Store,在页面里点击获取或安装。
    2. Store 页面打不开或下载按钮不显示时,改用 Windows 离线安装包,下载后双击安装。
    3. macOS: M 系列 Mac 选 Apple Silicon,Intel Mac 选 Intel 版本。打开 DMG 后把 Codex 拖进 Applications。
    Windows 官方 Store Windows 离线安装包 macOS Apple Silicon macOS Intel Mac
  2. 2

    安装 CCSwitch

    1. CCSwitch 用来把 AI 通道 生成的配置导入 Codex Desktop。安装完成后建议先启动一次。
    2. Windows 下载 MSI 安装;macOS 下载 DMG,打开后把 CC Switch 拖进 Applications。
    CCSwitch · Windows CCSwitch · macOS
  3. 3

    登录 AI 通道,一键导入 Codex 配置

    1. 先登录 AI 通道。登录后这里会直接显示 Codex / codex 导入面板。
    2. 面板默认进入 Codex / codex,确认后会通过 CCSwitch 导入到 Codex Desktop。
    3. 导入完成后完全退出 Codex Desktop,再重新打开。重新打开后能正常对话,就说明配置已生效。

    提醒:不要把 provider 名写成 OpenAI,否则可能导致 Codex 上下文压缩失败。本页一键导入会写好合适的 provider 名,导入后不需要再改。

遇到 Reconnecting 或连接不稳定怎么处理

如果 Codex 反复显示 Reconnecting、长时间卡在重连,或者一开局就提示连接不稳定,通常是本地环境对 WebSocket 长连接接管得不稳定。通过 CCSwitch 导入的用户可以在 Codex 供应商配置里关闭 WebSocket,让 Codex 直接走普通 HTTPS 请求,连接更稳定。

  1. 1

    在 CCSwitch 里打开 Codex 供应商编辑

    顶部先切到 Codex 图标,在 AI 通道 这一行点击编辑按钮,进入供应商编辑页。

    CCSwitch 中切换到 Codex 并点击 AI 通道供应商编辑按钮
  2. 2

    在 config.toml 加入 WebSocket 关闭配置

    找到 config.toml (TOML),在已有的 [model_providers.xxx] 段落下面加入这一行,不要单独新建一个新的 provider 段落。

    [model_providers.ai]
name = "ai"
base_url = "https://ai.aitongdao.com/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false
    CCSwitch 供应商编辑页中在 config.toml 添加 supports_websockets = false
  3. 3

    保存并重启 Codex Desktop

    点击右下角保存。然后完全退出 Codex Desktop,再重新打开。重新打开后再发起一次对话,如果不再反复重连,说明配置已经生效。