先认识这条接入链路
Codex（OpenAI）和 Claude（Anthropic）是两类强大的 AI 编程助手：前者擅长代码生成、补全与解释，后者在代码理解、重构、文档编写和复杂问题解决上表现出色。本教程使用 CCSwitch 统一管理它们的 API 配置，再通过本地路由接入你的编辑器。
教程中的控制台名称可能会随版本更新略有变化。如果你看到的是 API Keys、Credentials 或 Access Tokens，它们通常对应同一类凭证入口。
下载 CCSwitch
CCSwitch 允许你在 Codex、Claude 以及其他大语言模型之间快速切换，并统一管理 API 配置。请始终从官方或可信来源获取安装包。
OFFICIAL RELEASESCCSwitch / GitHub Releasesgithub.com/farion1231/cc-switch/releases选择你的操作系统
下载 .exe 安装程序或 .zip 压缩包。解压版可将可执行文件路径加入 PATH。
下载 .dmg 后，将 CCSwitch 拖入 Applications；.pkg 文件则双击按向导安装。
.deb、.rpm 或 .AppImage 均可。AppImage 需要先执行权限。
sudo dpkg -i ccswitch_xxx.deb
chmod +x ccswitch.AppImage ./ccswitch.AppImage
安全提示：不要从不明镜像下载二进制文件。安装前检查发布来源，并使用杀毒软件扫描文件。
注册 SuperTokens API 账号
登录 SuperTokens 后，你需要创建一把用于 CCSwitch 的 API 密钥，并记下 API Base URL。密钥只应保存在本地安全位置，不要提交到 Git 仓库。
访问 SuperTokens 官网
打开 https://supertokens.net/，点击页面右上角或显眼位置的注册入口。
创建账户
输入邮箱并设置强密码。若收到验证邮件，请点击邮件中的链接完成验证。
创建 API Key
进入控制台，找到 API Keys / Credentials / Access Tokens，点击创建按钮。
sk-。完整密钥通常只展示一次。确认 API 端点
在创建密钥的页面或账户设置中找到 API Base URL。本教程对应的网关地址是：
https://supertokens.net/在 CCSwitch 中配置 API
工具和密钥准备好后，把它们关联起来。下面的流程对应 PDF 中的通用供应商配置与本地路由设置。
打开 CCSwitch 设置
启动应用，首次运行时进入欢迎页或空白配置面板。找到 Settings、Configure 或齿轮图标。
添加统一供应商
点击右上角加号，选择“统一供应商”，然后添加一个新的供应商配置。
保存并同步
下方配置保持默认，确认 API Key 与 Base URL 后点击“保存并同步”。
打开本地路由
进入 CCSwitch 的设置页，在 路由 Tab 中打开 本地路由 开关。保持 CCSwitch 运行，它会为编辑器提供本地访问入口。
在编辑器中验证与使用
路由打开后，在真实的编码环境中发起一次请求，确认编辑器插件可以找到 CCSwitch。
安装编辑器插件
在 IDE 插件市场安装 AI 插件。IDEA 用户可以搜索 cc gui；也可以使用 Codex、Claude 官方插件或其他兼容插件。
进行测试
官方插件通常无需额外配置，CCSwitch 运行后即可生效。发送一个简单的代码解释请求，确认返回正常。
常见问题排查
Invalid API KeyAPI 密钥无效
检查密钥是否复制正确，前后是否有多余空格，并确认密钥在 SuperTokens 中仍处于激活状态。
Connection Error连接错误
检查网络连接与 API Base URL，确认防火墙没有阻止 CCSwitch 的连接。
Plugin not found插件找不到 CCSwitch
确保 CCSwitch 应用正在运行，且插件配置指向了正确的本地路由或可执行文件路径。
开始你的下一次编程
完成下载、注册和配置后，你已经搭建好 Codex 与 Claude 的双 AI 编程环境。把重复劳动交给 AI，把判断与创造留给自己。
探索高级功能
研究 CCSwitch 的配置模板、上下文管理与多项目切换。
管理成本
关注 SuperTokens、OpenAI 和 Anthropic 的用量，设置预算提醒。
保持审查
把 AI 生成的代码当作初稿，务必测试、审查和重构。