macOS 安裝 CC Switch 并配置 Codex 教程

一、準備工作

CC Switch 是一個用于管理 Claude Code、Codex、Gemini CLI 等 AI 編程工具供應商配置的桌面應用。官方 GitHub Releases 下載地址為：

https://github.com/farion1231/cc-switch/releases

截至 2026 年 6 月 26 日，GitHub Releases 頁面顯示的最新版為 CC Switch v3.16.3，發(fā)布時間為 2026 年 6 月 14 日。官方說明中，macOS 需要 macOS 12 Monterey 及以上，支持 Intel x64 和 Apple Silicon arm64 兩類 Mac。

macOS 用戶優(yōu)先下載：

CC-Switch-v3.16.3-macOS.dmg

如果你看到的是其他版本號，例如 v3.16.4，以 GitHub Releases 頁面最新版本為準。macOS 的安裝包通常是 Universal Binary，可以同時適配 Intel 芯片和 Apple Silicon 芯片。

芯片簡單判斷方式：

uname -m

返回含義：

arm64   表示 Apple Silicon，例如 M1、M2、M3、M4
x86_64  表示 Intel Mac

二、安裝 CC Switch

方式一：下載安裝包安裝，推薦

1. 打開 CC Switch Releases 頁面：

https://github.com/farion1231/cc-switch/releases

2. 找到最新版本，例如：

CC Switch v3.16.3

3. 在 Assets 中下載 macOS 安裝包：

CC-Switch-v3.16.3-macOS.dmg

• 雙擊打開 .dmg 文件。
• 將 CC Switch.app 拖入 Applications 應用程序目錄。
• 打開啟動臺或訪達中的“應用程序”，啟動 CC Switch。

如果 macOS 安全提示無法打開，可以進入：

系統(tǒng)設置 -> 隱私與安全性 -> 仍要打開

不過新版 CC Switch 已做 Apple 簽名和 notarization，一般不需要額外處理。

方式二：使用 Homebrew 安裝

如果你已經(jīng)安裝 Homebrew，也可以使用命令安裝：

brew install --cask cc-switch

更新 CC Switch：

brew upgrade --cask cc-switch

三、在 CC Switch 中添加 Codex 供應商

打開 CC Switch 后，頂部會看到多個工具圖標。配置 Codex 的步驟如下。

1. 切換到 Codex 配置頁

點擊頂部的 Codex / GPT 圖標，進入 Codex 供應商管理頁面。

2. 新建供應商

點擊右上角的 + 按鈕，進入“添加新供應商”頁面。

3. 選擇自定義配置

在“添加新供應商”頁面中：

1. 選擇 Codex 供應商
2. 點擊 自定義配置

4. 填寫供應商信息

以下以 wagbrio 為例。你可以換成自己的中轉(zhuǎn)服務商名稱、API Key 和 API 地址。

配置內(nèi)容示例：

供應商名稱：wagbrio
官網(wǎng)鏈接：可不填，或填寫供應商官網(wǎng)
API Key：填寫你的供應商 API Key
API 請求地址：https://www.wagbrio.com/v1

如果你的供應商給出的地址不是這個，請以供應商后臺提供的地址為準。常見格式通常是：

https://你的供應商域名/v1

示例：

供應商名稱：wagbrio
API Key：sk-xxxxxxxxxxxxxxxxxxxxxxxx
API 請求地址：https://www.wagbrio.com/v1

填寫完成后，點擊右下角 添加。

5. 啟用供應商

回到 Codex 供應商列表后，選中剛剛創(chuàng)建的供應商，例如：

wagbrio
https://www.wagbrio.com/v1

然后點擊啟用或切換按鈕。切換完成后，建議重新打開終端或重啟 Codex CLI，讓配置生效。CC Switch README 也提示，大多數(shù)工具切換供應商后需要重啟終端或?qū)?CLI 工具。

6. 驗證 Codex 是否生效

重新打開終端后執(zhí)行：

codex

如果可以正常進入 Codex 并發(fā)起對話，說明配置已生效。

如果遇到鑒權(quán)失敗，優(yōu)先檢查三項：

1. API Key 是否正確
2. base_url 是否填寫為供應商要求的地址
3. 終端是否已重新加載環(huán)境變量

到此這篇關(guān)于macOS下安裝CC-Switch并配置Codex 教程(最新2026.6)的文章就介紹到這了,更多相關(guān)CC-Switch安裝配置Codex內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論