Codex + CC Switch 专项教程

1. 如何同步不同 Provider 的 Codex 数据

Codex 切换 model_provider 后，旧会话可能在 Desktop 或 /resume 里不可见。通常不是会话文件丢了，而是会话文件、SQLite 线程表、项目路径缓存中的 provider / metadata 不一致。可参考 codex-provider-sync。

下载或安装

• Windows：下载 CodexProviderSync.exe（v0.2.5）。
• macOS / Linux / CLI：用 npm 从 GitHub 安装。

npm install -g git+https://github.com/Dailin521/codex-provider-sync.git

# 只诊断当前 provider / rollout / SQLite / 项目可见性
codex-provider status

# 不切换登录状态，只同步历史会话 metadata 到当前 provider
codex-provider sync

# 明确切换到 jaycue 后同步
codex-provider switch jaycue

Windows GUI 步骤

1. 先关闭 Codex / Codex Desktop / app-server，避免 state_5.sqlite 被占用。
2. 打开 CodexProviderSync.exe。
3. 点击 Refresh。
4. 目标 Provider 选择 jaycue。
5. 点击 Execute。

恢复备份

工具会在同步/切换前备份到 ~/.codex/backups_state/provider-sync/<timestamp>。

codex-provider restore ~/.codex/backups_state/provider-sync/<timestamp>
codex-provider prune-backups --keep 5

2. CC Switch 下载链接和 jaycue 配置

CC Switch 用来管理 Codex 的供应商配置。本教程只配置 Codex，Provider 名称固定为 jaycue。

下载链接

• 最新核对版本：CC Switch v3.14.1
• 始终获取最新版本：CC Switch Releases Latest
• 项目主页：farion1231/cc-switch

在 CC Switch 中添加 Codex Provider

1. 打开 CC Switch，左侧选择 Codex。
2. 点击 + 添加供应商。
3. 选择自定义 / OpenAI Compatible / 兼容 OpenAI Response 格式的供应商。
4. 按下表填写 CC Switch 表单字段。
5. 保存后点击 启用。

CC Switch 表单怎么填

model_provider = "jaycue"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.jaycue]
name = "jaycue"
base_url = "https://newapi.jaycue.dpdns.org/v1"
wire_api = "responses"
requires_openai_auth = true

{
  "OPENAI_API_KEY": "sk-你的New-API令牌"
}

3. Codex 下载方式和 CC Switch 联用教程

步骤 1：安装 Codex CLI

官方安装方式可使用 npm、Homebrew，或从 OpenAI Codex Release 下载二进制。

• 官方 GitHub：openai/codex
• 官方入门说明：OpenAI Codex CLI Getting Started
• 最新核对 Release：rust-v0.128.0 / 0.128.0

# npm 通用
npm install -g @openai/codex
codex --version

# macOS Homebrew
brew install --cask codex

# 二进制发布页
# https://github.com/openai/codex/releases/latest

步骤 2：安装并配置 CC Switch

1. 从 CC Switch Releases 下载并启动。
2. 按上一步教程添加 jaycue Provider。
3. 点击 启用。

步骤 3：重启终端并启动 Codex

# 关闭旧终端，重新打开后运行
codex

# 在 Codex 中发送：
# 你好，确认当前 provider 和模型

如果 Codex 正常回复，并且 New-API 控制台能看到令牌调用记录，就说明联用成功。

4. Codex 桌面版安装方式

Codex 桌面版适合想要 App 体验的用户。官方入口有两种：先安装 Codex CLI 后运行 codex app，或直接打开 Codex App 页面。

方式一：通过 Codex CLI 启动桌面版

1. 先按第 3 步安装 Codex CLI。
2. 在终端运行 codex app。
3. 按界面提示登录或继续配置。

npm install -g @openai/codex
codex app

方式二：打开 Codex App 页面

浏览器访问：https://chatgpt.com/codex?app-landing-page=true。

5. VS Code 插件安装方式

Codex IDE 插件可在 VS Code 以及 Cursor、Windsurf 等 VS Code 兼容编辑器中使用，也可以委派任务到 Codex Cloud。

安装入口

• 官方 IDE 文档：https://developers.openai.com/codex/ide
• VS Code Marketplace：openai.chatgpt
• VS Code 一键打开：vscode:extension/openai.chatgpt

VS Code 中安装

1. 打开 VS Code。
2. 进入 Extensions / 扩展市场。
3. 搜索 Codex 或打开 Marketplace 链接 openai.chatgpt。
4. 点击 Install。
5. 安装后在侧边栏打开 Codex；如果没看到，重启 VS Code。
6. 按插件提示使用 ChatGPT 账号或 API Key 登录。

Cursor / Windsurf

官方 IDE 文档也提供 Cursor、Windsurf 的安装入口；如果扩展图标被隐藏，可在 Activity Bar / 侧边栏里固定 Codex 图标。

6. 验证与排障

成功标准

• CC Switch 的 Codex 当前启用卡片为 jaycue。
• ~/.codex/config.toml 中是 model_provider = "jaycue"。
• ~/.codex/auth.json 中有 New-API 令牌。
• 运行 codex 可正常回复。
• New-API 控制台「日志」出现对应令牌调用记录。

常见问题