Mac ARM Codex装卸脚本 适配DeepSeek接口404报错解决方案

针对 Apple Silicon 架构 Mac 设备，Homebrew 默认官方源存在外网限流、更新排队卡顿等问题，且旧中科大镜像已失效，严重影响软件安装效率。同时 Codex 无法直连 DeepSeek 接口，会出现 404 报错。本文提供全套解决方案，包含清华镜像一键配置、Codex 完整装卸脚本、接口协议适配方案与常见报错排查指南。

一、环境基础

• 设备：macOS Apple Silicon M 系列 ARM
• Homebrew 源：清华镜像（外网高峰 Git 拉取排队Waiting in queue）
• 核心痛点：
  1. brew install/uninstall 默认触发brew update拉取 Git 仓库，清华外网限流排队；
  2. brew cask 默认隐藏下载进度，无法直观查看下载状态；
  3. Codex 原生调用 OpenAI /v1/responses 接口，DeepSeek 不兼容，直连会 404；
  4. 中科大旧镜像地址失效，无法使用。

二、清华 Homebrew 镜像一键配置脚本

功能说明

1. 自动清空旧阿里/USTC 镜像环境变量；
2. 写入完整清华五件套镜像（brew/core/cask/bottle/api）；
3. 仅替换存在的 tap 仓库远程地址，规避目录不存在报错；
4. 不全局关闭自动更新，仅安装卸载时临时屏蔽。

# 清空历史所有 HOMEBREW 镜像环境变量
sed -i '' '/export HOMEBREW_/d' ~/.zshrc
# 写入完整清华镜像配置
cat >> ~/.zshrc <<'EOF'
# 清华 Homebrew 全套镜像配置
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_CASK_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
EOF
# 重载 shell 配置生效
source ~/.zshrc
# 替换主 brew 仓库远程（必存在）
git -C "$(brew --repo)" remote set-url origin "$HOMEBREW_BREW_GIT_REMOTE"
# 存在 core 仓库才替换，避免目录不存在报错
CORE_PATH=$(brew --repo homebrew/core)
if [ -d "$CORE_PATH" ]; then
  git -C "$CORE_PATH" remote set-url origin "$HOMEBREW_CORE_GIT_REMOTE"
fi
# 存在 cask 仓库才替换，避免目录不存在报错
CASK_PATH=$(brew --repo homebrew/cask)
if [ -d "$CASK_PATH" ]; then
  git -C "$CASK_PATH" remote set-url origin "$HOMEBREW_CASK_GIT_REMOTE"
fi
echo "清华 Homebrew 镜像配置完成，brew 安装软件自动走清华加速"
echo "如需手动更新 brew：unset HOMEBREW_NO_AUTO_UPDATE && brew update -v"

三、Codex 完整卸载脚本

脚本功能

1. 临时关闭 Homebrew 自动更新，规避清华 Git 镜像排队；
2. 登出 Codex、清除钥匙串密钥、卸载 npm 全局 CLI；
3. 删除二进制、App 本体、全部缓存/配置/日志；
4. 清理 zshrc 内 Codex 相关环境变量；
5. 全程echo输出操作流程，无#注释。

export HOMEBREW_NO_AUTO_UPDATE=1

echo "开始执行：退出 Codex 登录并清除钥匙串授权信息"
codex auth logout 2>/dev/null
security delete-generic-password -s "openai-codex" 2>/dev/null

echo "开始执行：卸载 npm 全局 Codex CLI 工具并清理 npm 缓存"
npm uninstall -g @openai/codex 2>/dev/null
sudo npm uninstall -g @openai/codex 2>/dev/null
npm cache clean --force 2>/dev/null

echo "开始执行：删除手动安装的 codex 二进制程序文件"
sudo rm -f /opt/homebrew/bin/codex /usr/local/bin/codex 2>/dev/null

echo "开始执行：brew 卸载 Codex 桌面应用，清理无用依赖与缓存"
brew uninstall --cask codex 2>/dev/null
brew autoremove 2>/dev/null
brew cleanup 2>/dev/null

echo "开始执行：删除 Applications 目录下 Codex 客户端本体"
rm -rf /Applications/Codex.app 2>/dev/null

echo "开始执行：清理 Codex 全部本地配置、缓存、日志文件"
rm -rf ~/.codex
rm -rf ~/.config/codex ~/.cache/codex ~/.local/share/codex ~/.local/state/codex
rm -rf ~/Library/Application\ Support/Codex ~/Library/Caches/Codex
rm -rf ~/Library/Logs/Codex ~/Library/Preferences/com.openai.codex.plist

echo "开始执行：删除 zshrc 中 Codex 相关环境变量并重载配置"
sed -i '' '/OPENAI_API_KEY/d' ~/.zshrc
sed -i '' '/CODEX/d' ~/.zshrc
source ~/.zshrc

echo "=============================="
echo "Codex 卸载&残留清理全部完成"
echo "=============================="
echo "正在校验是否存在残留文件："
echo "1. 检查 codex 命令是否残留："
which codex
echo "2. 检查应用目录是否存在 Codex.app："
ls /Applications | grep Codex
echo "3. 检查家目录隐藏配置文件夹："
ls ~ | grep .codex

四、Codex 完整安装脚本

脚本功能

1. 临时关闭自动更新，不触发brew update排队；
2. 开启 curl 可视化下载进度条；
3. -v输出完整安装日志，复用已配置的清华镜像；
4. 安装完成输出版本、启动、登录命令。

export HOMEBREW_NO_AUTO_UPDATE=1
export HOMEBREW_CURL_ARGS="-# -L"

echo "当前使用清华镜像源，跳过 brew 自动更新，强制开启下载进度条安装 Codex"
brew install --cask codex -v

echo "=============================="
echo "Codex 安装完成"
echo "=============================="
echo "当前 codex 版本信息："
codex --version
echo "启动桌面图形客户端命令：codex app"
echo "打开终端交互工具命令：codex"
echo "登录 OpenAI 账号命令：codex auth login"

五、CC-Switch 配置 DeepSeek 适配 Codex（解决 /responses 404）

核心原理

Codex 原生请求 OpenAI 专属 /v1/responses 接口，DeepSeek 仅支持标准 /v1/chat/completions，直连 DeepSeek 会返回 404；CC-Switch 本地路由做协议转换，拦截并重写请求路径。

1. 添加 DeepSeek 供应商
   • CC-Switch 切换至「Codex」标签 → 右上角「+添加供应商」→ 预设选择 DeepSeek
   • 填入 DeepSeek sk-xxx API Key，请求地址保持默认 https://api.deepseek.com
   • 高级设置：开启本地路由映射（必填），接口自动转为 OpenAI Chat Completions
   • 模型映射：deepseek-v4-flash / deepseek-v4-pro，保存
2. 开启全局路由转发
   • CC-Switch 设置 → 路由页面：打开「本地路由总开关」+「Codex 应用路由开关」，保存
3. 启用供应商并重置 Codex 配置
   • 主界面选中 DeepSeek，点击启用，状态变为 Active
   • 终端执行 codex auth logout 清除旧直连配置
4. 验证配置生效

   cat ~/.codex/config.toml | grep base_url
   

   正常输出本地代理地址：http://127.0.0.1:15721/v1

终端执行codex切换模型即可正常对话，无 404 报错

六、全会话报错、原因、解决方案汇总

本文针对性解决了 Mac ARM 设备下 Homebrew 镜像卡顿、下载无进度、自动更新阻塞，以及 Codex 兼容 DeepSeek 接口报错等核心问题。通过替换全套清华镜像、临时屏蔽自动更新、本地路由协议转换等手段，高效规避各类适配故障，配套完整装卸脚本与报错汇总，可稳定实现开发环境高效、流畅运行。

以上关于Mac ARM Codex装卸脚本 适配DeepSeek接口404报错解决方案的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。