Codex 避坑指南：安装+双模型（DeepSeek+七牛云）共存配置，告别报错
作为一名经常用命令行工具写代码的开发者，最近尝试用 Codex 搭配 DeepSeek 提升效率，结果踩了一连串坑——Mac 恶意软件隔离、配置不生效、模型切换失败、API 余额不足……
折腾了大半天，终于搞定了 Codex 安装、Mac 环境兼容，还实现了 DeepSeek 官方 + 七牛云 AI 双模型共存（随便切换，互不冲突），全程实操可复现，分享给同样踩坑的掘金小伙伴，少走弯路！
先放最终效果：✅ Codex 正常启动 ✅ 双模型自由切换 ✅ 无任何警告报错 ✅ 七牛云免费额度可用（解决 DeepSeek 402 余额不足）
一、前置说明（必看）
-
环境：Mac（M1/M2/M3 芯片，Intel 芯片同样适用，跳过恶意软件重签步骤即可）
-
Codex 版本：**0.80.0**（唯一能直连 DeepSeek 的版本，新版 ≥0.81.0 不兼容）
-
核心需求：Codex 搭配 DeepSeek 用，同时备用七牛云 AI（免费、国内直连），双模型自由切换
-
避坑重点：Mac 安全隔离、配置文件路径、模型切换逻辑（很多人栽在这）
二、第一步：安装 Codex 0.80.0（唯一可用版本）
Codex 新版（≥0.81.0）强制使用 OpenAI 新接口，无法直连 DeepSeek，必须安装 0.80.0 版本，全程终端操作，复制命令即可。
1. 卸载旧版（如有）
npm uninstall -g @openai/codex
npm cache clean --force # 清除缓存，避免安装残留
2. 安装 0.80.0 版本
npm install -g @openai/codex@0.80.0
3. 解决 Mac 恶意软件隔离（M 芯片必做）
安装后启动 Codex 会弹出“未打开codex，因其包含恶意软件”，这是 Mac Gatekeeper 安全拦截，不是软件有毒，按下面步骤放行+重签即可。
# 1. 递归清除整个 Codex 目录的隔离属性（路径替换成自己的 node 路径）
sudo xattr -rd com.apple.quarantine ~/.nvm/versions/node/v18.16.0/lib/node_modules/@openai/codex/
# 2. 给 Codex 二进制文件本地重签（解决 M 芯片签名拦截）
sudo codesign --force --deep --sign - ~/.nvm/versions/node/v18.16.0/lib/node_modules/@openai/codex/vendor/aarch64-apple-darwin/codex/codex
# 3. 增加执行权限（保险起见）
chmod +x
~/.nvm/versions/node/v18.16.0/lib/node_modules/@openai/codex/vendor/aarch64-apple-darwin/codex/codex
补充：执行命令时输入开机密码（输入不显示），看到「replacing existing signature」就是重签成功。
最后一步：运行 codex \-\-version，弹出隔离提示后，打开「系统设置 → 隐私与安全性 → 安全性」，找到 codex 拦截提示，点击「仍要打开」即可。
三、第二步：双模型配置（DeepSeek + 七牛云 AI 共存）
核心需求：同时保留 DeepSeek 官方模型（充值后可用）和七牛云 AI（免费 300 万 token，国内直连），配置后可自由切换，互不冲突。
1. 准备 API Key
-
DeepSeek 官方：登录 DeepSeek 官网，创建 API Key（需充值，余额不足会报 402 错误）
-
七牛云 AI：登录 七牛云官网，进入「AI 大模型推理」，创建 API Key（新用户免费送 300 万 token，不用充值）
2. 一键配置双模型（覆盖 config.toml）
终端复制整段命令，自动创建/覆盖配置文件，无需手动编辑，避免写错格式：
mkdir -p ~/.codex
cat > ~/.codex/config.toml << 'EOF'
# ==============================================
# Codex 双模型配置：DeepSeek 官方 + 七牛云 AI（共存版）
# 适配 Codex 0.80.0，解决 chat wire API 弃用警告
# ==============================================
# 1. DeepSeek 官方模型配置（原生）
[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/v1"
env_key = "DEEPSEEK_API_KEY" # 对应 DeepSeek 的 API Key 环境变量
wire_api = "chat" # 兼容 0.80.0 版本，忽略弃用警告（不影响使用）
# 2. 七牛云 AI 配置（免费、国内直连）
[model_providers.qiniu]
name = "QiniuAI"
base_url = "https://api.qnaigc.com/v1"
env_key = "QINIU_API_KEY" # 对应七牛云的 API Key 环境变量
wire_api = "responses" # 解决 chat wire API 弃用警告
# ----------------------------
# 模型配置文件（切换用）
# ----------------------------
# DeepSeek 官方配置文件（需充值）
[profiles.deepseek]
model = "deepseek-chat" # DeepSeek 基础聊天模型（稳定）
model_provider = "deepseek"
# 七牛云 AI 配置文件（免费）
[profiles.qiniu]
model = "deepseek-v4-pro" # 七牛云部署的 DeepSeek V4 Pro（能力更强）
model_provider = "qiniu"
EOF
3. 设置 API Key 环境变量
两种方式，选一种即可（临时生效/永久生效）：
方式 1：临时生效（重启终端失效）
# 设置 DeepSeek API Key（替换成自己的）
export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 设置七牛云 API Key（替换成自己的）
export QINIU_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
方式 2：永久生效（Mac zsh 终端，推荐）
# 写入环境变量（替换成自己的 Key）
echo 'export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' >> ~/.zshrc
echo 'export QINIU_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' >> ~/.zshrc
# 生效环境变量
source ~/.zshrc
四、第三步：双模型切换使用（核心操作）
配置完成后，启动 Codex 时指定配置文件，即可切换模型，全程简单易懂。
1. 启动 Codex（选对应模型）
-
用七牛云 AI（目前免费，适合白嫖党）：
codex \-\-profile qiniu -
用 DeepSeek 官方（需充值）：
codex \-\-profile deepseek
2. 启动后选择安全模式
启动后会出现两个选项，**必选第 2 个**（安全第一，避免误改文件）：
1. Allow Codex to work in this folder without asking for approval
› 2. Require approval of edits and commands
解释：
-
选项 1：全自动操作，Codex 可直接改文件、执行命令（有风险，易误删代码）
-
选项 2：所有修改、命令都需手动确认（安全，推荐开发者使用）
选中选项 2，按回车即可进入 Codex 交互界面。
3. 模型切换（不用看列表，直接输命令）
很多小伙伴会疑惑：输入 /model 后，列表里只有 OpenAI 官方模型，看不到 DeepSeek 和七牛云的模型？
✅ 正常现象！Codex 的 /model 列表是硬编码的，只显示 OpenAI 自家模型，第三方模型不会出现在列表里，但直接输入模型名字就能用！
# 切换到七牛云的 deepseek-v4-pro（免费）
/model deepseek-v4-pro
# 切换到 DeepSeek 官方的 deepseek-chat（需充值）
/model deepseek-chat
# 切换到 OpenAI 模型（需科学上网+API Key）
/model gpt-4o
输入后显示「Using model: 模型名」，就是切换成功了。
五、常见报错解决方案（踩坑汇总）
整理了我过程中遇到的所有报错，对应解决方案，直接对照排查即可：
1. 报错：Error: spawn ... ENOENT
原因：Codex 二进制文件缺失/路径错误，或未安装 0.80.0 版本。
解决方案：重新执行「第一步：安装 Codex 0.80.0」，确保路径正确。
2. 报错：未打开“codex”，因其包含恶意软件
原因：Mac Gatekeeper 安全拦截，未重签/未放行。
解决方案：重新执行「第一步 3. 解决 Mac 恶意软件隔离」，最后在系统设置点击「仍要打开」。
3. 报错：xattr: No such xattr: com.apple.quarantine
原因：文件已无隔离属性，无需再执行放行命令。
解决方案：忽略此报错，直接启动 Codex 即可。
4. 报错：config profile `deepseek` not found
原因：配置文件路径错误/内容写错，Codex 未读到配置。
解决方案：重新执行「第二步 2. 一键配置双模型」，确保配置文件正确生成。
5. 报错：402 Payment Required: Insufficient Balance
原因：DeepSeek 官方 API Key 余额不足。
解决方案：切换到七牛云 AI（codex \-\-profile qiniu），用免费额度；或给 DeepSeek 充值。
6. 警告：Support for the "chat" wire API is deprecated
原因：Codex 提醒旧协议即将过期，不影响当前使用。
解决方案：忽略即可；若想消除警告，可将 DeepSeek 配置的 wire\_api = \&\#34;chat\&\#34; 改成 wire\_api = \&\#34;responses\&\#34;（但可能影响 DeepSeek 兼容性，不推荐）。
六、总结
整个过程核心就是 3 件事：
-
安装 Codex 0.80.0 版本（唯一兼容 DeepSeek 的版本）；
-
解决 Mac 恶意软件隔离（M 芯片重点，Intel 芯片可跳过重签）；
-
配置双模型（DeepSeek+七牛云），用配置文件切换，忽略模型列表的“假象”。
这样配置后，既能用 DeepSeek 官方模型（充值后），也能随时切换到七牛云 AI（免费、国内直连），再也不用为报错、余额不足烦恼。
🎁 粉丝福利：七牛云 AI 300 万 Token 免费白嫖
看完文章想直接体验的小伙伴，福利来了！
通过我的专属邀请链接注册七牛云 AI 推理平台，新用户直接免费领取 300 万 Token，不用充值、不用复杂任务，支持 DeepSeek 系列模型，国内直连超快，搭配本文 Codex 配置直接起飞 🚀
👉 专属领取链接：s.qiniu.com/fIBJZb
Token 可直接用于 API 调用、命令行 AI 工具，个人开发者日常使用完全够用，白嫖真香！
如果操作过程中遇到其他问题，欢迎在评论区留言，我会第一时间回复～
最后，求个掘金三连（点赞+收藏+关注），后续会分享更多命令行工具、AI 配置实操指南！🙏
（注：文档部分内容由 AI 生成）
