Codex登录又崩了？零基础CCSwitch秒连教程

平时使用 Codex 进行开发，一直依赖 auth 登录方式。最近登录体验变得不太稳定，于是切换回 API 模式。今天分享一套更直观、适合新手的 API 连接 Codex 配置路径，希望能帮助遇到类似情况的朋友。

安装 cc-switch

Windows：

推荐使用最新 v3.10.3 便携版，通过 PowerShell 命令即可快速完成安装部署：

1. 下载压缩包
Invoke-WebRequest -Uri "https://github.com/farion1231/cc-switch/releases/download/v3.10.3/CC-Switch-v3.10.3-Windows-Portable.zip" -OutFile "$env:USERPROFILE\Downloads\CC-Switch-Portable.zip"

2. 解压到桌面
Expand-Archive -Path "$env:USERPROFILE\Downloads\CC-Switch-Portable.zip" -DestinationPath "$env:USERPROFILE\Desktop\CC-Switch"

3. 启动程序
Start-Process "$env:USERPROFILE\Desktop\CC-Switch\CC Switch.exe"

Mac：

# 添加 cc-switch 的 brew 源
brew tap farion1231/ccswitch

# 安装 cc-switch（cask 是桌面应用安装方式）
brew install --cask cc-switch

启动 cc-switch

安装完成后，在终端输入 cc-switch 命令，然后从「应用程序」文件夹中找到 CC Switch 图标并双击启动即可。

首次启动时可能会遇到系统提示「未识别的开发者」，处理步骤非常简单：

1. 先关闭系统警告弹窗；
2. 打开「系统设置」→「隐私与安全」；
3. 找到 CC Switch 相关提示，点击「仍然打开」；
4. 之后即可正常启动。

至此，你就成功安装并拥有 CC Switch 这个实用工具了。

添加提供商

启动 CC Switch 后，切换到 Codex 页面，点击「+」按钮添加提供商。

从原理上看，cc-switch 切换 Provider 或模型时，核心修改的是配置文件。但实际生效的文件不止一个：认证信息通常还会涉及 auth.json（或系统 keychain）来存储密钥。简单来说，就是 config.toml 和 auth.json 共同起作用——不过 CC Switch 已经将这些手动操作全部封装，你无需再手动修改文件。

配置完成后，重启 Codex 或 IDE，你会在右下角看到新增的供应商选项。点击即可正常使用。

更多 AI 应用相关的内容，后续再和大家慢慢分享。