ccswitch配置deepseek 有两条路：走 CC Switch 的本地路由（127.0.0.1:15721）由它做协议转换，或直接改 Codex 的 config.toml 走 DeepSeek 官方原生的 Responses API。差别在于请求是否多绕一层本机代理。另外，第三方教程里普遍还在用已退役的模型名 deepseek-v4-flash，本文按官方文档更正。 ccswitch配置deepseek的两条路径怎么选
CC Switch 是个跨平台桌面应用：Tauri 2 构建、Rust 写后端，把 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes 这七个工具的供应商配置收进一个界面，MIT 协议开源。它本身不跑模型推理，只负责写入和切换本地工具读取的配置，所以它并不是唯一选项。 决定选择的是 DeepSeek 这边的能力。官方文档写明：Codex 通过 Responses API 与模型通信，而 DeepSeek 的 API 原生支持 Responses API，配好之后 Codex 可以直接连上去。上游既然能说 Codex 的语言，中间就不必再有一层翻译。
两条路径的分工因此是：
- 走本地路由：CC Switch 把 Codex 的 base_url 改写成
http://127.0.0.1:15721/v1，请求先到本机代理，由它负责格式转换、故障转移、请求日志与用量统计，再转发给 DeepSeek。
- 走官方原生：在
~/.codex/config.toml 里新增一个 [model_providers.deepseek] 段，把 base_url 指向 DeepSeek 官方地址、协议声明为 responses，请求直连，不经过任何中间服务。
判断标准其实只有一条：你还要不要在多个供应商、多个工具之间来回切。只接 DeepSeek 一家、只用一个 Codex，官方原生少一层转发；手上同时挂着几家 API、又要管 Claude Code 和 Codex 两套配置，CC Switch 的图形界面和托盘快切才划得来。 本地路由路径的4步接入流程
把 DeepSeek 接进 Codex 是四步：
- 从 CC Switch 官网（ccswitch.io）下载对应平台的安装包并安装。官方标注支持 macOS 12+、Windows 10+ 与 Linux；macOS 版已做代码签名与公证，直接装即可。认准官网，要用最新版，旧版本的供应商预设可能仍在填已退役的模型名。
- 打开 CC Switch，在顶部的工具标签里切到 Codex，点右上角加号添加供应商，在预设下拉框里选 DeepSeek，填入 API Key 后保存。预设会自动填好端点地址，你只需要填 Key。
- 进入设置，打开本地路由总开关，本地代理会在 127.0.0.1:15721 端口启动；再到「路由启用」里把 Codex 单独打开。
- 关闭并重新打开终端，启动 Codex 验证。能正常应答即接入成功。
第 4 步最容易被跳过。CC Switch 官方把各工具的生效方式分开列了：Claude Code 支持热重载、即时生效，而 Codex 必须关闭终端再重开，Gemini 每次请求重新读取配置，OpenCode、OpenClaw 同样需要重开终端。换句话说，Codex 用户切完供应商直接在原终端里试，看到的一定是旧配置。 两处细节容易忽略。API 密钥只在创建时显示一次，平台关闭弹窗后无法再看，丢了只能重建；路由接管生效后 Codex 侧的 base_url 会被改写成上面那个本地地址，这是接管成功的标志，不是配置被改坏。
补一条 CC Switch 用户常会碰到的映射规则。若同一个 DeepSeek Key 也接到 Claude Code，DeepSeek 的 Anthropic 兼容接口会对你传进去的 Claude 模型名做一次重映射：以 claude-opus 开头的落到 deepseek-v4-pro，以 claude-haiku 或 claude-sonnet 开头的落到 deepseek-flash；如果传的是完全不支持的模型名，后端统一映射到 deepseek-flash。所以即便工具是按 Claude 的型号去请求，实际落到哪个 DeepSeek 模型是可预期的，排查时按这张映射表对就行。 官方原生路径的配置文件怎么写
DeepSeek 官方文档明确说明，Codex CLI、ChatGPT 桌面应用与 VS Code 的 Codex 扩展共用同一份配置文件，所以只需配一次，三个客户端同时生效，不存在分别配置的问题。
官方给了一键脚本，也给了手写方案。脚本路径按系统分两条：macOS 与 Linux 用户在终端执行 bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh)，Windows 用户在 PowerShell 执行 irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex。启动后从菜单选动作：选 1 配成 deepseek-flash（该模型同时接受图像输入），选 2 配成 deepseek-v4-pro，选 9 还原成 Codex 默认配置。脚本会先把原来的 config.toml 备份到 ~/.codex/backup-deepseek/，再写入 models.json、修改 config.toml，写盘前先校验语法，校验不过就中止、不落盘。
不想跑脚本就手改，官方给的 config.toml 关键片段是这样：
官方字段表把每一项都写明了用途：model 是默认模型，model_provider 要对应下面那段 [model_providers.<id>] 的 id，preferred_auth_method 与 forced_login_method 用来走 API Key 认证、跳过 ChatGPT 账号登录，model_reasoning_effort 控制思考深度，model_catalog_json 指向自定义模型目录文件。而 [model_providers.deepseek] 段里的 wire_api 必须写成 "responses"，因为 Codex 说的是 Responses API 这套协议。
models.json 的作用容易被低估。按官方给出的一份完整内容，它声明的是模型元数据：上下文窗口 1048576、支持的推理档位为 low / high / max、输入模态同时含 text 与 image（正是这一项让 Codex 知道该模型可以收图）、支持并行工具调用，另有一个最低客户端版本号。缺了这个文件，Codex 会把 DeepSeek 当成来历不明的模型，表现就是模型挑不到或行为异常。
还有个容易漏的前提：跑脚本前要先装好 Codex CLI 或 ChatGPT 桌面应用，并且至少启动过一次，目的是让 ~/.codex 目录先存在，否则脚本无处写入。
验证方式也按客户端分了三档。Codex CLI 看启动横幅，显示 model: deepseek-flash 即为生效；ChatGPT 桌面应用的模型选择器显示「Custom」或直接显示模型名（例如 DeepSeek-Flash）都算生效，出现哪个取决于你的客户端版本，显示 Custom 时实际调用的就是 deepseek-flash；VS Code 扩展与 CLI 共用配置，装完直接用。
还有一条与直觉相反的官方说明：切到 DeepSeek 后如果发现以前的会话不见了，并不是被删了。Codex 按登录方式把会话历史分组存放，官方订阅建立的会话与第三方 API 建立的会话分开保存，界面只显示与当前配置匹配的那一组。用脚本的第 9 项还原配置，旧会话就回来了。
两条路径的关键差异对照
两条路径的差别集中在请求走向和换供应商的成本上：
| | |
|---|
| | 官方脚本，或手写 config.toml 与 models.json |
| 先到本机 127.0.0.1:15721，再由代理转发 | |
| | 新增 model_providers 段并指向官方地址 |
| | |
| | |
| | |
两边还有个共通的坑：只要 Codex 走的不是官方 ChatGPT 订阅，web_search 就不可用。官方字段表里写明 web_search「对于 DeepSeek 模型是禁用的」，所以接入后如果发现联网搜索失效，那是预期行为，不是配置错了。
模型名与价格先对齐再动手
动手前先对齐模型名，能省掉大半排查时间。DeepSeek 官方文档写明：现行的模型名是 deepseek-flash 与 deepseek-v4-pro，而旧名 deepseek-v4-flash、deepseek-v4-flash-vision-exp 虽然仍可调用，但对应模型已经下线，请求会被转到 DeepSeek-V4.1-Flash 并按其价格计费。第三方教程里把 deepseek-v4-flash 当作默认模型填进去的写法，来源就在这里。官方脚本也已处理这一点：重跑一次会把旧的这两条目录清掉，只留 deepseek-flash 与 deepseek-v4-pro。
价格以人民币每百万 tokens 计，空闲与高峰两档，空闲价是高峰价的一半：
高峰时段为北京时间周一至周五 9:00 至 12:00、14:00 至 18:00，其余时间按空闲价计。两个模型的上下文长度都是 1M，最大输出 384K，都支持 JSON Output、Tool Calls、Responses API 与 Anthropic API；差别在 flash 额外支持图像理解，pro 不支持，而 pro 的定位是复杂推理与深度思考。并发按账号计算，与用哪一个 API Key 无关，超限会返回 429。
有一处流传较广的过期信息要更正：V4 Pro 并未下线。官方在定价页写明，已决定在 2026 年 9 月 14 日之后继续提供 V4 Pro 的 API 调用服务，计费方式不变。第三方教程里「9 月 14 日后下线、请求将路由至 Flash」的说法，已经不再成立。
接入后没生效怎么排查
报错分两层：一层来自 DeepSeek 的接口，一层来自本地配置与工具链。错误码的定义官方写得很直接：
| | |
|---|
| | |
| | |
| | |
| | |
| | |
| Base URL 写错，或 API 格式与地址不匹配 | Anthropic 格式用 /anthropic 后缀，OpenAI 兼容用 /v1，官方原生用根路径配 responses |
| | 改成 deepseek-flash 或 deepseek-v4-pro |
| | 关掉终端重开；Codex 与 OpenCode、OpenClaw 都要重开 |
| | 重装该工具，或用 which / where 定位后修 PATH |
| | 重启 CC Switch；必要时重启系统让两者共享同一环境 |
Base URL 这一行要单独记，三种格式的地址确实不同，写混了必然报错：官方原生接 Codex 用的是根地址加 responses 协议；接 Claude Code 这类原生说 Anthropic 协议的工具用 https://api.deepseek.com/anthropic；只支持 OpenAI 兼容格式的工具用 https://api.deepseek.com/v1。同一家的 Key，地址后缀选错就是 404。
ccswitch配置deepseek的注意事项
- 模型名以官方为准：现行是 deepseek-flash 与 deepseek-v4-pro，旧名 deepseek-v4-flash 对应的模型已下线，虽然仍能调用但会被转给 V4.1-Flash 计费，别把它当默认值填。
- Codex 不支持热切换：切换供应商后必须关闭并重新打开终端，这是官方文档写明的生效规则，不是偶发故障。
- API 密钥只显示一次：创建后立即保存，关闭弹窗无法再看，遗失只能重建；不要把密钥提交到 Git。
- 密钥存在本地，云同步要评估：CC Switch 把配置与密钥存在本地数据库（默认位于用户目录下的 .cc-switch 目录），若开启云同步，配置会经你选定的云盘流转，是否启用按团队安全策略定。
- 官方原生方案会把密钥写进配置文件：字段表里的 experimental_bearer_token 就是直接存密钥的位置，注意文件权限与版本控制。
- 多一层代理多一分变量：走本地路由时请求先到本机端口，排查问题要把代理状态一起看；只想接一家供应商，官方原生更省事。
- 会话没有丢，只是分组了：Codex 按登录方式分开存放会话历史，切回原配置旧会话即恢复，不必担心数据被删。
- web_search 对 DeepSeek 模型是关闭的：这是官方明确写下的限制，接入后联网搜索失效属预期行为。
- 第三方教程在模型名和价格上普遍过期：动手前对照 DeepSeek 官方文档与 CC Switch 官方文档各核一遍，尤其是模型名、单价与高峰时段三处。
ccswitch配置deepseek常见问题
Q：用 ccswitch 配置 deepseek 可行吗？
A：可行，它通过本地路由接管 Codex 与 Claude Code 等工具的供应商配置。但如果只接 DeepSeek 一家，DeepSeek 官方已提供原生 Codex 集成，少一层转发更直接。
Q：CC Switch 要收费吗？
A：不用。官网写明 MIT 协议开源、完全免费；DeepSeek 侧按 token 用量计费，费用从充值余额或赠送余额中扣减。
Q：Codex 该填哪个 Base URL？
A：走官方原生用根地址配 responses 协议；接说 Anthropic 协议的工具用 /anthropic 后缀；只支持 OpenAI 兼容格式的用 /v1 后缀。三者不能混用。
Q：切换供应商后 Codex 还是旧配置怎么办？
A：关掉终端重新打开。官方把各工具的生效方式分开列了，Codex 属于必须重开终端那一类，只有 Claude Code 支持热重载。
Q：为什么模型列表里看不到 DeepSeek 模型？
A：官方原生方案依赖 models.json 声明模型元数据，config.toml 里的 model_catalog_json 要指向这个文件，Codex 才能像用内置模型一样使用它。
Q：填了 deepseek-v4-flash 会怎样？
A：仍可调用，但该模型已下线，请求会由 DeepSeek-V4.1-Flash 提供服务并按 Flash 价格计费。建议直接改用现行的 deepseek-flash。
Q：API Key 忘了保存还能查看吗？
A：通常不能。密钥只在创建时显示一次，遗失后需到 DeepSeek 开放平台新建，必要时删除旧密钥。
Q：切换后以前的会话历史会丢吗？
A：不会。Codex 按登录方式分组存放会话，官方订阅会话与第三方 API 会话分开保存，还原配置后旧会话即可恢复。
Q：高峰时段是什么时候，费用差多少？
A：高峰为北京时间周一至周五 9:00 至 12:00、14:00 至 18:00，其余为空闲时段；空闲价是高峰价的一半，错峰调用可直接省一半。
模型名、单价与并发上限都会随官方调整，改配置前先在 DeepSeek 官方文档核对当期口径即可。想持续跟进 ccswitch配置deepseek 的接入方式与模型变化，可以关注本站 AI 工具栏目。
AI 速览
