macOS ARM 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报错

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