必须通过本地桥接服务转换协议才能正常通信，因为Codex默认使用Responses协议而DeepSeek只支持Chat Completions格式，不转换会导致502错误或“unsupported call”提示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Mac版Codex无法直接调用DeepSeek模型，必须通过本地桥接服务转换协议才能正常通信——因为Codex默认使用Responses协议，而DeepSeek只支持Chat Completions格式，不转换就会返回502错误或“unsupported call”提示。
安装必要依赖环境
打开终端，依次执行以下命令：
检查Node.js版本：node --version。若低于v18.0，请前往nodejs.org/zh-cn下载安装v22 LTS版本。
执行npm config set prefix ~/.npm-global，再运行echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc，否则后续全局命令会报错。
安装Codex CLI：npm install -g @openai/codex --registry=https://registry.npmmirror.com。安装完成后运行codex --version确认输出版本号。
获取DeepSeek API Key
访问platform.deepseek.com，登录账号 → 左侧导航栏点击「API Keys」→ 点击「Create API Key」→ 复制生成的密钥并保存到安全位置。
【注意：密钥仅显示一次，关闭页面后无法再次查看，务必立即复制】
如未充值，需先在「Top Up」页面完成最低10元充值，否则API请求将被拒绝。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
配置CC Switch代理（推荐）
方法一：从CC Switch GitHub Releases下载最新macOS .dmg安装包，双击挂载后拖入Applications文件夹。
启动CC Switch，顶部标签页切换至「Codex」→ 右上角点击「+」→ 在预设列表中选择「DeepSeek」→ 自动填充Base URL为https://api.deepseek.com/v1。
在API Key栏粘贴你刚复制的密钥，供应商名称填“DS-V4-Flash”之类易识别的标识，点击「添加」。
点击右侧「测试」按钮：若返回HTTP 200且模型列表出现deepseek-v4-flash，说明配置成功。
启动Codex并验证连接
第一步：关闭所有已打开的Codex进程，包括后台活动监视器中的残留进程。
第二步：在终端执行codex --provider ccswitch启动（不是codex start，后者会走默认OpenAI通道）。
第三步：输入dir指令。如果返回当前目录结构，而非unsupported call或502错误，表示协议桥接生效。
若首次启动卡在“Loading…”，请退出CC Switch并重新打开，再试一次；Mac系统偶尔因权限缓存导致代理端口绑定失败，重启CC Switch可解决。
