平时使用 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 图标并双击启动即可。
首次启动时可能会遇到系统提示「未识别的开发者」，处理步骤非常简单：
- 先关闭系统警告弹窗；
- 打开「系统设置」→「隐私与安全」；
- 找到 CC Switch 相关提示，点击「仍然打开」；
- 之后即可正常启动。
至此，你就成功安装并拥有 CC Switch 这个实用工具了。
添加提供商
启动 CC Switch 后，切换到 Codex 页面，点击「+」按钮添加提供商。
从原理上看，cc-switch 切换 Provider 或模型时，核心修改的是配置文件。但实际生效的文件不止一个：认证信息通常还会涉及 auth.json（或系统 keychain）来存储密钥。简单来说，就是 config.toml 和 auth.json 共同起作用——不过 CC Switch 已经将这些手动操作全部封装，你无需再手动修改文件。
配置完成后，重启 Codex 或 IDE，你会在右下角看到新增的供应商选项。点击即可正常使用。
更多 AI 应用相关的内容，后续再和大家慢慢分享。
