首页 > AI教程 >macOS安装CC-Switch并配置Codex教程(2026.6)

macOS安装CC-Switch并配置Codex教程(2026.6)

来源:互联网 2026-07-23 06:19:14

CC-Switch是一款管理AI编程工具供应商配置的桌面应用,最新版v3.16.3支持macOS12及以上,兼容Intel和AppleSilicon芯片。可通过下载DMG安装包或Homebrew安装。配置Codex时需添加自定义供应商,填写名称、APIKey和API地址,启用后重启终端即可生效。

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,发布时间为 2026 年 6 月 14 日。根据官方说明,macOS 版本要求 macOS 12 Monterey 及以上,同时支持 Intel x64Apple Silicon arm64 两种 Mac 机型。

长期稳定更新的攒劲资源: >>>点此立即查看<<<

macOS 用户建议优先下载以下安装包:

CC-Switch-v3.16.3-macOS.dmg

如果页面显示其他版本号,例如 v3.16.4,请以 GitHub Releases 页面最新版本为准。macOS 安装包通常为 Universal Binary,可同时适配 Intel 芯片和 Apple Silicon 芯片,使用更加便捷。

如何判断当前 Mac 的芯片类型?打开终端执行以下命令:

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
  1. 找到最新版本,例如:
CC Switch v3.16.3
  1. 在 Assets 中下载 macOS 安装包:
CC-Switch-v3.16.3-macOS.dmg
  • 双击打开 .dmg 文件。
  • CC Switch.app 拖入 Applications 应用程序目录。
  • 打开启动台或访达中的“应用程序”,启动 CC Switch

如果 macOS 安全提示无法打开,可进入以下路径:

系统设置 → 隐私与安全性 → 仍要打开

新版 CC Switch 已具备 Apple 签名和 notarization 认证,通常情况下无需额外操作即可直接使用。

方式二:使用 Homebrew 安装

如果已安装 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. 新建供应商

点击右上角的 + 按钮,进入“添加新供应商”页面。

macOS安装CC-Switch并配置Codex教程(2026.6)

3. 选择自定义配置

在“添加新供应商”页面中:

  1. 选择 Codex 供应商
  2. 点击 自定义配置

macOS安装CC-Switch并配置Codex教程(2026.6)

4. 填写供应商信息

以下以 wagbrio 为例,用户可根据实际使用的中转服务商名称、API Key 和 API 地址进行替换。

配置内容示例:

供应商名称:wagbrio
官网链接:可不填,或填写供应商官网
API Key:填写你的供应商 API Key
API 请求地址:https://www.wagbrio.com/v1

macOS安装CC-Switch并配置Codex教程(2026.6)

如果供应商提供的地址与此不同,请以供应商后台显示的地址为准。常见格式通常为:

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

示例:

供应商名称:wagbrio
API Key:sk-xxxxxxxxxxxxxxxxxxxxxxxx
API 请求地址:https://www.wagbrio.com/v1

填写完成后,点击右下角 添加

5. 启用供应商

返回 Codex 供应商列表后,选中刚刚创建的供应商,例如:

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

然后点击启用或切换按钮。切换完成后,建议重新打开终端或重启 Codex CLI,使配置生效。CC Switch README 中提示,大多数工具切换供应商后需要重启终端或对应的 CLI 工具。

6. 验证 Codex 配置是否生效

重新打开终端后执行:

codex

如果能够正常进入 Codex 并发起对话,说明配置已成功生效。

如果遇到鉴权失败,请优先检查以下三项:

1. API Key 是否正确
2. base_url 是否填写为供应商要求的地址
3. 终端是否已重新加载环境变量

侠游戏发布此文仅为了传递信息,不代表侠游戏网站认同其观点或证实其描述

热游推荐

更多
湘ICP备14008430号-1 湘公网安备 43070302000280号
All Rights Reserved
本站为非盈利网站,不接受任何广告。本站所有软件,都由网友
上传,如有侵犯你的版权,请发邮件给xiayx666@163.com
抵制不良色情、反动、暴力游戏。注意自我保护,谨防受骗上当。
适度游戏益脑,沉迷游戏伤身。合理安排时间,享受健康生活。