Codex + cc-switch 如何接入 DeepSeek？完整配置和避坑指南

大家好，我是 Codex 中文网的站长宇哥。

这篇文章主要聊「Codex + cc-switch 如何接入 DeepSeek？完整配置和避坑指南」。很多新手刚开始使用 Codex 时，最容易卡在安装、登录、模型、API、MCP、cc-switch 和本地配置这些环节。其实大多数问题都有固定排查路径，只要按顺序检查，就能少走很多弯路。

适合谁看

这篇文章适合下面几类朋友：

• 正在学习 Codex 的开发者；
• 想把 Codex 用到真实项目里的用户；
• 想接入 DeepSeek、GLM、Qwen、OpenRouter 等模型的用户；
• 想用 cc-switch 管理多模型路由的用户；
• 遇到 Codex 登录、配置、报错问题的人；
• 想系统学习 AI Coding 工具链的人。

核心思路

在处理 Codex 相关问题时，不要只盯着一个命令。建议先把链路拆开：

Codex CLI
  ↓
本地配置
  ↓
账号 / API Key
  ↓
API Base URL
  ↓
模型服务
  ↓
网络环境

只要其中一个环节不对，就可能导致登录失败、401、429、模型不存在、请求超时或者工具不可用。

DeepSeek 接入思路

可以直接让 Codex 连接 DeepSeek，也可以通过 cc-switch 转发。

直接配置示例：

export DEEPSEEK_API_KEY="你的 DeepSeek Key"

model = "deepseek-chat"

[model_provider.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/v1"
env_key = "DEEPSEEK_API_KEY"

如果你通过 cc-switch 使用，就让 Codex 指向本地 cc-switch 地址，再在 cc-switch 里配置 DeepSeek 上游。

常见问题

model not found 多半是模型名不对；401 多半是 Key 或环境变量问题；timeout 多半是网络或上游服务问题。

建议检查清单

操作完成后，建议你按下面清单检查一遍：

Codex 是否能正常启动
当前账号或 API Key 是否正确
Base URL 是否写成 API 地址
模型名是否和平台一致
终端环境变量是否生效
网络和代理是否正常
配置文件是否被误删或写错

常见误区

1. 把官网地址当成 API 地址

这是最常见的问题。官网地址、控制台地址、文档地址都不是 API Base URL。

2. 模型名自己随便写

模型名一定要从服务商控制台或文档复制，尤其是中转平台，不同平台可能有自己的模型别名。

3. Key 写进公开仓库

API Key 不要提交到 GitHub，建议使用环境变量或本地配置。

4. 一出错就重装

大多数 Codex 问题不需要重装，先查配置、Key、Base URL、网络和认证文件。

推荐操作习惯

我建议你养成这几个习惯：

每次改配置前先备份
每次换模型后先做简单测试
重要项目一定用 Git 管理
不要一次让 AI 大面积改代码
遇到报错先复制完整错误信息

总结

「Codex + cc-switch 如何接入 DeepSeek？完整配置和避坑指南」这个问题，本质上还是 Codex 配置链路的问题。你只要按账号、Key、Base URL、模型名、网络、配置文件这个顺序排查，大多数问题都能定位出来。

Codex 中文网后面会继续更新 Codex、Claude Code、MCP、cc-switch、国产模型接入和 AI Coding 实战教程。如果你正在学习 AI 编程，可以收藏本站，后面会持续整理更多可复现的教程。