一、环境基础

今天来聊聊在macOS ARM架构上，如何高效配置Homebrew、折腾Codex的安装和卸载，以及如何让Codex用上DeepSeek的API。先说清楚环境基础：

• 设备：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 完整卸载脚本

脚本功能

这个脚本负责把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报错。

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

《夸克》非常好用的免费AI浏览器

下载APP查看