ChatGPT(codex)+CC Switch+DeepSeek

2026 · Codex 配置实战

给 Codex 换一颗
DeepSeek 大脑

从安装 Codex、领取 DeepSeek API Key，到用 CC Switch 一键切换模型。少改配置，少踩坑，最后用一条命令确认真的跑通。

适用 macOS / Windows / Linux 约 20–30 分钟最后核验：2026-10-27

先说结论：这套组合到底在做什么？

Codex 是负责读代码、改文件和执行命令的“编程外壳”；DeepSeek 是实际回答问题的“模型”；CC Switch 则像一个桌面端的配置中枢，把接口地址、密钥和模型名集中管理。配置完成后，你可以随时在官方模型与 DeepSeek 之间切换。

01 · CLIENT ChatGPT / Codex 你输入任务、查看改动、批准命令的客户端。

02 · SWITCH CC Switch 保存不同供应商配置，并在切换时写入 Codex。

03 · MODEL DeepSeek API 通过 Responses 协议接收请求并返回模型结果。

你最终会得到 一键切换供应商

在 CC Switch 中点选 DeepSeek，Codex 重启后即使用对应模型。

不需要 手改一长串 TOML

新版 CC Switch 的 DeepSeek 预设已包含端点和模型映射。

仍然需要 自己的 API Key

DeepSeek 会按实际 Token 用量计费，CC Switch 本身不提供额度。

阅读路线

01开始前准备 02安装 ChatGPT / Codex 03获取 DeepSeek API Key 04安装 CC Switch 05添加并启用 DeepSeek 06跑通第一次调用 07模型与搜索能力 08故障排查与回滚

开始前，先分清三个“账号”

这一部分很重要。许多“配置成功却没反应”的问题，并不是命令写错，而是把 ChatGPT 订阅、Codex 客户端和 DeepSeek API 混在了一起。

ChatGPT 账号 用于首次安装和使用 Codex 界面

桌面版首次启动通常需要登录 ChatGPT。它提供 Codex 工作区，但并不等于 DeepSeek 的 API 额度。

DeepSeek 平台账号 用于创建 API Key 和充值

切到 DeepSeek 后，请求由 DeepSeek 模型处理，费用按 DeepSeek 平台的 Token 或搜索用量结算。

本文的“Codex”指什么？

Codex CLI、ChatGPT 桌面应用里的 Codex，以及 VS Code 的 Codex 扩展会共享同一套 Codex 配置。本文以 Codex CLI + ChatGPT 桌面版共用配置为主线；只装其中一个，也能完成后面的接入。

系统时间与网络正常

安装和 API 调用都依赖网络；公司网络如果拦截终端请求，需要单独放行。

准备一个测试项目

建议使用 Git 仓库，并在测试前提交一次，方便回看 Codex 改了什么。

第 1 步：安装并启动 ChatGPT / Codex

如果你已经能运行 codex，或桌面版里已经出现 Codex 工作区，可以跳到下一步。首次安装时，先完整打开一次，让 ~/.codex 配置目录生成。

选择桌面版或命令行版

想要图形界面，从 ChatGPT 官方下载页安装桌面应用，登录后选择 Codex。想在终端里工作，则安装 Codex CLI。

用官方命令安装 Codex CLI

照着下面的方式选一种即可，不要同时把多个安装源混在一起。

打开新终端并验证

安装完成后重新打开终端。旧终端可能还没加载新的 PATH。

macOS / Linux · 推荐 standalone 安装

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
codex

Windows PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version
codex

也可以使用 npm 或 Homebrew，三选一即可：

可选安装方式

# Node.js 用户：npm 全局安装
npm install -g @openai/codex

# macOS Homebrew 用户
brew install --cask codex

首次启动时

CLI 会询问登录方式。先按提示完成 ChatGPT 登录，确认官方 Codex 本身可用，再去接入 DeepSeek。这样后续出错时能快速判断是客户端问题还是供应商配置问题。

第 2 步：创建 DeepSeek API Key

打开 DeepSeek 开放平台

进入 DeepSeek API Keys 页面，登录后创建一个新的 API Key。

确认账户余额

没有可用余额时，Key 即使格式正确也会调用失败。建议先准备少量测试额度，再开始调试。

立刻保存到密码管理器

Key 通常只在创建时完整显示。本文写作时 DeepSeek 的 Key 以 sk- 开头，请以控制台实际显示为准。

不要把真实 API Key 发到文章、截图或 Git 仓库

Codex 的第三方供应商配置会把 Key 写入本地 ~/.codex/config.toml 的 experimental_bearer_token 字段。建议使用专用、低额度的测试 Key，并确保该配置文件不会被同步或提交。

当前值得使用的两个模型

deepseek-flash 是日常编码优先尝试的默认模型，并支持图片输入；deepseek-v4-pro 面向更高难度的推理任务。模型和公开名称会继续演进，配置时应以 DeepSeek 官方文档当前展示为准。

第 3 步：安装 CC Switch

CC Switch 是开源桌面应用。请只从 ccswitch.io 或 GitHub 官方仓库获取安装包，不要搜索“绿色破解版”或来源不明的网盘链接。

macOS · Homebrew 推荐

brew install --cask cc-switch

# 后续更新
brew upgrade --cask cc-switch

Windows

下载 .msi 安装包或 Portable 绿色版；ARM 设备选择 arm64 版本。

macOS 手动安装

下载 Universal 版 .dmg，Apple Silicon 与 Intel 都可运行。

Ubuntu / Debian

选择 .deb；较新的 Fedora 可选择 .rpm，或其他系统对应的 AppImage。

Arch Linux

可使用 paru -S cc-switch-bin；安装前留意仓库说明与版本要求。

首次启动会自动导入现有配置

新版 CC Switch 首次运行时会读取 Codex 当前配置，并保留为名为 default 的供应商。第一次改写配置文件前也会自动备份，因此原配置通常不会因为点错一下就消失。

第 4 步：添加并启用 DeepSeek 供应商

在左侧栏选择 Codex

进入 Codex 页面，确认顶部当前是“直连”标签。DeepSeek 已经提供原生 Responses API，最新预设通常不需要经过本地路由转换。

点击“添加供应商”

在预设搜索框输入 DeepSeek，选中官方模型厂商预设；如果同一个品牌出现多个条目，根据页面提示选择正确的地区或套餐。

粘贴 API Key，检查请求地址

Base URL 应为 https://api.deepseek.com/，上游格式应为 Responses（原生）。名称和端点通常会由预设自动填好。

确认模型映射

映射表中至少应看到 deepseek-flash 和 deepseek-v4-pro。将 deepseek-flash 放在默认位置，或直接设为默认模型。

保存并启用

点击底部的“添加”，回到供应商列表后启用 DeepSeek。如果卡片出现“需要路由”标记，再打开同页面的“路由”标签并点击“开始路由”。

旧版预设可能残留旧模型名

CC Switch 的旧供应商卡片不会自动升级。若看到已停用的模型名、反复提示需要路由，或模型列表里找不到当前模型，最省时间的做法通常是删除旧卡片，重新添加新版 DeepSeek 预设，而不是继续修补旧配置。

展开：CC Switch 正常写入后，配置里应出现哪些关键字段？

下面的值用于核对，不建议新手手动替换整份配置。真实 API Key 不要出现在截图或文章中。

model = "deepseek-flash"
model_provider = "deepseek"
model_reasoning_effort = "high"
preferred_auth_method = "apikey"
forced_login_method = "api"

[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "你的 DeepSeek API Key"

切换后必须重启 Codex

CC Switch 只负责写入配置。Codex CLI 要退出当前会话并重新启动；ChatGPT 桌面版要完全退出后重新打开，而不只是关闭窗口。

第 5 步：跑通第一次 DeepSeek 调用

进入一个测试项目目录，重新运行 Codex。最直接的判断标准是启动横幅里的模型名称，以及测试请求能否正常返回。

Codex CLI 验证

cd /path/to/your-test-project
codex

# 进入交互界面后输入：
请只回复：DeepSeek × Codex 已连接

看模型名称

命令行启动界面通常应显示 deepseek-flash 或你配置的 DeepSeek 模型，而不是原来的 OpenAI 模型。

看桌面版模型选择器

ChatGPT 桌面版中，模型选择器显示“DeepSeek-Flash”或“Custom”都可能代表配置已生效；具体文案取决于客户端版本。

用一个真实但低风险的任务验收

可以让 Codex “先解释项目结构，不改任何文件”。成功返回后，再进行实际编辑和命令执行。

成功状态

CC Switch 中 DeepSeek 卡片处于启用状态；Codex 启动横幅显示对应模型；聊天能返回内容；修改变更前仍会出现 Codex 原有的权限与沙箱确认。

进阶：模型、推理强度与联网搜索怎么选

日常默认 deepseek-flash

适合日常问答、代码解释和常规修改。官方当前说明它支持图片输入，适合截图排错和界面任务。

更强推理 deepseek-v4-pro

适合复杂重构、长链路排查和需要更深推理的任务。更强通常也意味着响应更慢、成本更高。

推理强度可以在 Codex 内用 /model 查看与调整，也可以在 CC Switch 的供应商高级设置中配置。不是每个上游都完整支持所有思考等级；可选项以当前客户端和预设为准。

Codex 内置联网搜索需要单独启用

根据 DeepSeek 当前文档，Codex 的内置网页搜索只在 deepseek-v4-pro 下可用。启用时要将 web_search = "live"，并注意搜索请求可能单独计费。切换到模型不支持的配置时，请保持 web_search = "disabled"。

可选：于 ~/.codex/config.toml 中调整

model = "deepseek-v4-pro"
web_search = "live"

保存后完全重启 Codex。若你的网络环境无法访问搜索服务，或者不需要实时资料，保持关闭更稳定。

常见问题：按症状快速定位

症状	最可能的原因	处理方法
`codex` 找不到	安装后没有打开新终端，或多个安装源的 PATH 冲突	打开新终端；Windows 可用 `Get-Command codex` 检查实际路径，再清理重复安装。
401 / 403	Key 错误、被删除，或账户余额不足	回到 DeepSeek 平台重新创建 Key，并在 CC Switch 编辑供应商后替换；确认账户可用。
404 / 接口不存在	请求地址被填成了完整聊天接口，或多写了错误的 `/v1`	恢复为预设的 `https://api.deepseek.com/`，确认上游格式为 Responses。
模型不存在	仍在调用已停用的旧模型名	重新添加最新版 DeepSeek 预设，选择 `deepseek-flash` 或 `deepseek-v4-pro`。
卡片显示“需要路由”	旧预设或上游格式被设成了 Chat Completions	新版 DeepSeek 预设优先重建；实在需要使用旧配置时，再开始本地路由并保持 CC Switch 运行。
仍显示原来的 OpenAI 模型	切换后未重启客户端，或启用了另一个供应商卡片	确认 DeepSeek 卡片为当前启用项，完全退出 Codex CLI / 桌面版，再重新打开。
桌面版切到 DeepSeek 后仍停在登录页	第三方 API 的登录方式没有切换到 API Key	重新添加最新版预设并重启；仍异常时，对照 DeepSeek 官方指南核对 `preferred_auth_method` 与 `forced_login_method`。
切换后旧会话不见了	官方账号会话与第三方 API 会话分组保存	会话并未删除。切回原来的供应商并重启，旧分组会重新显示。
普通问答正常，某些工具调用失败	模型或网关未完整支持特定 agent 工具协议	先升级 Codex 与 CC Switch，再用最小任务复现；必要时暂时回退官方模型。
桌面版正常，终端仍失败	桌面版读取了新配置，而旧终端会话仍在使用旧环境	关闭旧终端和旧 Codex 会话，从项目目录重新运行 `codex`。

想回到 OpenAI 官方模型，怎么做？

在 CC Switch 切回官方供应商

选择 Codex 页面中的 OpenAI / ChatGPT 官方供应商（界面名称随版本可能略有不同），再点击启用。

完全退出后重新登录或打开

关闭当前 Codex 会话与桌面应用，重新打开，然后按官方登录流程继续使用 ChatGPT 账号。

配置异常时使用备份恢复

CC Switch 首次改写配置前会备份原文件；也可以使用设置中的数据管理或供应商编辑器恢复。不要直接删除整个 ~/.codex，否则会话、登录和自定义设置可能一起丢失。

撤销“切换”不等于立即停止计费

已经发出的请求按各平台规则结算。要停止后续调用，必须真正切回官方配置或停用第三方供应商，而不是只在 CC Switch 里关闭窗口。

上线前 Checklist

✓ Codex 已安装 ✓ Key 可用 ✓ CC Switch 官方版 ✓ 预设已启用 ✓ Responses 正常 ✓ 调用成功

最后的建议

先用一个小仓库测试，不要把刚领取的生产 API Key 直接放进含敏感代码的目录里长期运行。确认稳定性、工具调用和成本都符合预期后，再扩大使用范围。

参考资料

OpenAI · Codex CLI

官方安装方式、首次登录与命令行参考。

OpenAI · ChatGPT 桌面应用

桌面版下载、登录和 Codex 工作区入口。

DeepSeek · Codex 接入指南

DeepSeek 官方 Responses 配置、模型目录和桌面版说明。

CC Switch · 官方仓库

下载版本、界面说明、路由和故障转移文档。

最后补充：macOS 电脑桌面端安装与配置

如果你更习惯图形界面，希望在 Mac 上直接使用 ChatGPT 桌面版里的 Codex，而不执行前面列出的 curl、npm 或 Homebrew Codex 命令，可以按照这一节操作。

两种安装方式的区别

命令行方式安装的是 Codex CLI；macOS 桌面端安装的是 ChatGPT 应用内的 Codex。两者读取同一份 Codex 配置，所以后面的 CC Switch 和 DeepSeek 供应商设置仍然通用，但桌面端不需要先安装 Codex CLI。

从 OpenAI 官方页面下载 Mac 版本

打开 ChatGPT 桌面应用官方页面。Apple Silicon（M1、M2、M3、M4 等）选择默认的 macOS 下载；Intel Mac 点击下载按钮旁的“选择其他 ChatGPT 下载”，选择 macOS (Intel)。

安装并登录 ChatGPT

打开下载得到的安装文件，按系统提示将 ChatGPT 拖入“应用程序”文件夹，然后从“启动台”或“应用程序”中打开，并使用 ChatGPT 账号登录。

只打开一次 Codex 工作区

登录后在应用内找到并打开 Codex，创建一个对话或选择一个项目目录。第一次完整启动后，应用会准备 ~/.codex 配置环境，这一步不需要在终端执行命令。

以 App 方式安装 CC Switch

从 CC Switch 官方 Releases下载 macOS 的 .dmg，打开后将 CC Switch 拖入“应用程序”。这样整个桌面端流程也不需要 Homebrew。

在 CC Switch 中添加 DeepSeek

打开 CC Switch，在左侧选择 Codex，按本文第 4 步添加 DeepSeek 预设、填写 API Key，并确认上游格式为 Responses（原生）。网络地址和模型选择方式与命令行版相同。

完全退出后重新打开 ChatGPT

切换并启用 DeepSeek 后，在 ChatGPT 界面按 Command + Q 完全退出，而不仅仅是点击窗口左上角的红色关闭按钮；然后重新打开应用并进入 Codex。

在桌面版中确认配置生效

进入 Codex 新对话，查看模型选择器：显示“DeepSeek-Flash”或“Custom”都可能表示配置已经生效。随后发送一条测试消息，确认模型可以正常回复。

后续配置与命令行版相同

CC Switch 中的供应商卡片、DeepSeek API Key、模型选择和回滚方式完全沿用前文。区别只在首次安装：Mac 桌面端走 App 下载与拖拽安装，命令行版才使用 curl、npm 或 Homebrew。