macOS ARM Codex 安裝的實現(xiàn)步驟
發(fā)布時間:2026-07-22 10:08:30 作者:hello_zzw
我要評論
本文教你用清華鏡像一鍵配置macOS ARM環(huán)境,并解決DeepSeek適配難題,輕松搞定brew update阻塞和/responses 404報錯,快速啟用Codex圖形與終端工具,感興趣的可以了解一下
一、環(huán)境基礎(chǔ)
- 設(shè)備:macOS Apple Silicon M系列 ARM
- Homebrew 源:清華鏡像(外網(wǎng)高峰Git拉取排隊
Waiting in queue) - 核心痛點:
- brew install/uninstall 默認觸發(fā)
brew update拉取Git倉庫,清華外網(wǎng)限流排隊; - brew cask 默認隱藏下載進度,無法直觀查看下載狀態(tài);
- Codex 原生調(diào)用OpenAI
/v1/responses接口,DeepSeek不兼容,直連會404; - 中科大舊鏡像地址失效,無法使用。
- brew install/uninstall 默認觸發(fā)
二、清華Homebrew鏡像一鍵配置腳本
功能說明
- 自動清空舊阿里/USTC鏡像環(huán)境變量;
- 寫入完整清華五件套鏡像(brew/core/cask/bottle/api);
- 僅替換存在的tap倉庫遠程地址,規(guī)避目錄不存在報錯;
- 不全局關(guān)閉自動更新,僅安裝卸載時臨時屏蔽。
# 清空歷史所有HOMEBREW鏡像環(huán)境變量 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 完整卸載腳本
腳本功能
- 臨時關(guān)閉Homebrew自動更新,規(guī)避清華Git鏡像排隊;
- 登出Codex、清除鑰匙串密鑰、卸載npm全局CLI;
- 刪除二進制、App本體、全部緩存/配置/日志;
- 清理zshrc內(nèi)Codex相關(guān)環(huán)境變量;
- 全程
echo輸出操作流程,無#注釋。
export HOMEBREW_NO_AUTO_UPDATE=1 echo "開始執(zhí)行:退出Codex登錄并清除鑰匙串授權(quán)信息" codex auth logout 2>/dev/null security delete-generic-password -s "openai-codex" 2>/dev/null echo "開始執(zhí)行:卸載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 "開始執(zhí)行:刪除手動安裝的codex二進制程序文件" sudo rm -f /opt/homebrew/bin/codex /usr/local/bin/codex 2>/dev/null echo "開始執(zhí)行:brew卸載Codex桌面應(yīng)用,清理無用依賴與緩存" brew uninstall --cask codex 2>/dev/null brew autoremove 2>/dev/null brew cleanup 2>/dev/null echo "開始執(zhí)行:刪除Applications目錄下Codex客戶端本體" rm -rf /Applications/Codex.app 2>/dev/null echo "開始執(zhí)行:清理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 "開始執(zhí)行:刪除zshrc中Codex相關(guān)環(huán)境變量并重載配置" 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. 檢查應(yīng)用目錄是否存在Codex.app:" ls /Applications | grep Codex echo "3. 檢查家目錄隱藏配置文件夾:" ls ~ | grep .codex
四、Codex 完整安裝腳本
腳本功能
- 臨時關(guān)閉自動更新,不觸發(fā)
brew update排隊; - 開啟curl可視化下載進度條;
-v輸出完整安裝日志,復(fù)用已配置的清華鏡像;- 安裝完成輸出版本、啟動、登錄命令。
export HOMEBREW_NO_AUTO_UPDATE=1 export HOMEBREW_CURL_ARGS="-# -L" echo "當(dāng)前使用清華鏡像源,跳過brew自動更新,強制開啟下載進度條安裝Codex" brew install --cask codex -v echo "==============================" echo "Codex 安裝完成" echo "==============================" echo "當(dāng)前codex版本信息:" codex --version echo "啟動桌面圖形客戶端命令:codex app" echo "打開終端交互工具命令:codex" echo "登錄OpenAI賬號命令:codex auth login"
五、CC-Switch 配置 DeepSeek 適配 Codex(解決 /responses 404)
核心原理
Codex 原生請求OpenAI專屬 /v1/responses 接口,DeepSeek僅支持標(biāo)準(zhǔn) /v1/chat/completions,直連DeepSeek會返回404;CC-Switch本地路由做協(xié)議轉(zhuǎn)換,攔截并重寫請求路徑。
- 添加 DeepSeek 供應(yīng)商
- CC-Switch 切換至「Codex」標(biāo)簽 → 右上角「+添加供應(yīng)商」→ 預(yù)設(shè)選擇 DeepSeek
- 填入 DeepSeek
sk-xxxAPI Key,請求地址保持默認https://api.deepseek.com - 高級設(shè)置:開啟本地路由映射(必填),接口自動轉(zhuǎn)為 OpenAI Chat Completions
- 模型映射:
deepseek-v4-flash/deepseek-v4-pro,保存
- 開啟全局路由轉(zhuǎn)發(fā)
- CC-Switch 設(shè)置 → 路由頁面:打開「本地路由總開關(guān)」+「Codex應(yīng)用路由開關(guān)」,保存
- 啟用供應(yīng)商并重置 Codex 配置
- 主界面選中DeepSeek,點擊啟用,狀態(tài)變?yōu)?Active
- 終端執(zhí)行
codex auth logout清除舊直連配置
- 驗證配置生效
cat ~/.codex/config.toml | grep base_url
正常輸出本地代理地址:http://127.0.0.1:15721/v1
終端執(zhí)行codex切換模型即可正常對話,無404報錯
六、全會話報錯、原因、解決方案匯總
| 報錯信息 | 根因 | 解決方案 |
|---|---|---|
| brew update 卡在 Fetching /opt/homebrew... | 清華Git鏡像外網(wǎng)并發(fā)限流,拉取倉庫阻塞 | 1. 安裝/卸載腳本增加export HOMEBREW_NO_AUTO_UPDATE=1跳過自動更新; 2. 需手動更新時臨時切官方Git源:HOMEBREW_BREW_GIT_REMOTE=https://github.com/Homebrew/brew brew update -v |
| remote: Waiting in queue... (Position: 1xxx) | 清華Git鏡像外網(wǎng)用戶排隊限流 | 全程使用HOMEBREW_NO_AUTO_UPDATE=1,徹底屏蔽自動更新邏輯 |
| fatal: repository 'https://mirrors.ustc.edu.cn/misc/brew.git/' not found | USTC舊鏡像路徑攜帶/misc/,地址失效 | 放棄USTC源,使用文檔內(nèi)清華鏡像配置腳本 |
| 復(fù)制腳本提示 zsh: command not found: # | 注釋#單獨分行被識別為命令 | 采用無注釋、echo輸出流程的腳本 |
| fatal: cannot change to '/opt/homebrew/Library/Taps/xxx': No such file or directory | 新機未自動拉取core/cask tap,目錄不存在 | 清華源配置腳本增加目錄判斷,僅存在時執(zhí)行g(shù)it遠程替換 |
| brew install codex 下載無進度展示 | Homebrew默認隱藏curl下載進度 | 安裝腳本增加export HOMEBREW_CURL_ARGS="-# -L"展示可視化進度條 |
| 校驗完93.8MB安裝包后長時間停滯不動 | 1. 后臺解壓tar包; 2. macOS Gatekeeper聯(lián)網(wǎng)公證App簽名阻塞 | 1. 新開終端`ps aux |
| unexpected status 404 Not Found, url: https://api.deepseek.com/responses | Codex調(diào)用OpenAI專屬/responses接口,DeepSeek不支持該路由 | 使用CC-Switch本地路由協(xié)議轉(zhuǎn)換,禁止Codex直連DeepSeek官網(wǎng),完整配置見第五節(jié) |
到此這篇關(guān)于macOS ARM Codex 安裝的實現(xiàn)步驟的文章就介紹到這了,更多相關(guān)macOS ARM Codex 安裝內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

Codex Desktop 安裝教程:Windows、macOS 全平臺完整攻略
Codex Desktop 是 OpenAI 推出的 AI 編程桌面客戶端,支持并行處理多個任務(wù)線程,截至 2026 年 7 月,它主要支持 Windows 和 macOS,接下來通過本文給大家介紹Codex Desktop2026-07-17


