尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
CC Switch 接入 Codex 详细教程
一、什么是 CC SwitchCC Switch 是一个本地代理桌面应用它可以将各种大模型如小米 MiMo、Claude、Gemini 等的 API 转换为 OpenAI 兼容格式从而让 Codex CLI / Codex Desktop 使用任意第三方模型。工作原理Codex ──请求── CC Switch (本地代理 127.0.0.1:15721) ──转发── 第三方模型 APICC Switch 充当一个翻译层将 Codex 发出的 OpenAI 格式请求转发到你配置的任意模型提供商。二、前置准备已安装 Codex CLI 或 Codex Desktop验证终端运行codex --version能正常输出版本号下载 CC Switch从 GitHub Release 下载https://github.com/farion1231/cc-switch/releasesWindows 用户下载.exe安装包准备至少一个模型的 API Key例如小米 MiMo (https://api.xiaomimimo.com)或其他兼容 OpenAI 格式的提供商三、安装与启动 CC Switch步骤 1安装双击下载的安装包按提示完成安装。安装后桌面会出现快捷方式。步骤 2启动 CC Switch双击桌面的CC Switch图标启动程序。首次启动后它会在系统托盘中运行并自动监听本地端口15721。验证是否启动成功netstat -ano | Select-String 15721看到类似TCP 127.0.0.1:15721 ... LISTENING即表示启动成功。四、在 CC Switch 中添加模型提供商步骤 1打开供应商管理打开 CC Switch 主界面点击左侧边栏的供应商标签页。步骤 2添加新供应商点击 添加按钮填写以下信息字段说明示例供应商名称自定义名称Xiaomi MiMoAPI 基础 URL模型的 API 地址https://api.xiaomimimo.com/v1API Key你的 API 密钥sk-xxxxxxxxxxxx模型 ID要使用的模型名称mimo-v2.5-pro步骤 3激活供应商在供应商列表中点击你想使用的供应商右侧的激活按钮圆形切换按钮使其变为当前激活状态。上图可以看到连接状态已连接 ✅代理端口15721代理模式模型直连当前激活Xiaomi MiMo178 copy/mimo-v2.5-pro步骤 4查看供应商列表点击左侧供应商可以看到所有已配置的提供商每个供应商显示名称、API 地址、模型列表和连接状态。五、CC Switch 自动管理的 Codex 配置CC Switch 启用接管功能后会自动修改~/.codex/config.toml关键配置说明配置项作用model_provider设为custom表示使用自定义提供商model当前使用的模型 ID如mimo-v2.5-promodel_catalog_json模型能力目录文件名base_url指向 CC Switch 本地代理http://127.0.0.1:15721/v1wire_api通信协议responsesrequires_openai_auth是否需要 OpenAI 认证重要不要手动修改这些配置CC Switch 会在切换供应商时自动更新。六、在 Codex 中使用配置完成后正常使用 Codex 即可# 命令行模式 codex # 或者直接提问 codex 帮我写一个 Python 快速排序七、CC Switch 核心功能7.1 热切换供应商在 CC Switch 中切换不同供应商时Codex 的配置会实时更新无需重启 Codex。7.2 自动备份CC Switch 会自动备份 Codex 配置到~/.cc-switch/backups/。7.3 代理模式模式说明模型直连请求直接转发到目标模型 API负载均衡在多个同模型供应商间轮转请求7.4 设置页面八、常见问题排查Q1: Codex 连接失败— 检查 CC Switch 是否运行端口 15721 是否监听。Q2: 模型返回 500 错误— 查看日志~/.cc-switch/logs/cc-switch.log通常是 API Key 无效或模型提供商异常。Q3: 切换供应商后没生效— 重启 Codex 即可。九、目录结构~/.codex/ ├── config.toml # Codex 主配置CC Switch 管理 ├── cc-switch-model-catalog.json # 自定义模型目录 ~/.cc-switch/ ├── settings.json # CC Switch 设置 ├── cc-switch.db # 数据库 ├── logs/cc-switch.log # 运行日志 └── backups/ # 配置备份十、总结安装并启动 CC Switch添加模型供应商填入 API 地址和 Key激活目标供应商正常使用 Codex、如有问题可以私信解决如果cc-switch提供的配置有问题也可以找我
RELATED

相关推荐

终极开源macOS光标主题:专业级桌面美学与跨平台体验重构

终极开源macOS光标主题:专业级桌面美学与跨平台体验重构

终极开源macOS光标主题:专业级桌面美学与跨平台体验重构 【免费下载链接】apple_cursor Free & Open source macOS Cursors. 项目地址: https://gitcode.com/gh_mirrors/ap/apple_cursor Apple Cursor项目为技术爱好者和开发者提供了一个完整的开源macOS…

📅 2026/9/4 10:40:56
5分钟掌握ppInk:Windows屏幕标注终极指南,让远程协作效率翻倍

5分钟掌握ppInk:Windows屏幕标注终极指南,让远程协作效率翻倍

5分钟掌握ppInk:Windows屏幕标注终极指南,让远程协作效率翻倍 【免费下载链接】ppInk Fork from Gink 项目地址: https://gitcode.com/gh_mirrors/pp/ppInk 你是否经常在视频会议中手忙脚乱地试图用鼠标指向屏幕上的内容?或者在做在线…

📅 2026/9/9 1:34:48
win11下Multipass修改默认MULTIPASS_STORAGE位置后,持续报错waiting for daemon的问题

win11下Multipass修改默认MULTIPASS_STORAGE位置后,持续报错waiting for daemon的问题

在学习juju时,Canonical 的教程推荐了自家的开源虚拟机软件 Multipass。据说基于 Windows 原生的 Hyper-V,优化很丝滑,且内置大部分 Ubuntu 版本。如此好用的东西肯定要尝尝咸淡。 当笔者兴致冲冲地下载好后,立刻发现问题&#x…

📅 2026/8/21 3:59:50
MORE NEWS

更多资讯

📰

Bilibook:Windows平台轻量级知识管理工具部署指南

1. Bilibook项目概述Bilibook是一个基于Windows平台的轻量级知识管理工具,专为中文用户设计。它采用本地化部署方案,无需复杂配置即可快速搭建个人知识库系统。作为一位长期使用各类笔记软件的资深用户,我发现Bilibook在以下场景特别实用&…

📰

【Rust入门知识点学与练】第12课:结构体 Struct

知识点1:定义和使用结构体 结构体让你把相关的数据组合在一起: // 定义结构体 struct Student {name: String,age: u32,score: f64, }fn main() {// 创建结构体实例let s1 Student {name: String::from("小明"),age: 18,score: 95.5,};// 访问…

📰

HDFS副本机制:原理、配置与生产实践

1. HDFS副本机制的核心价值与设计哲学在分布式存储系统中,数据可靠性始终是首要考量。HDFS作为Hadoop生态的核心存储组件,其副本机制的设计直接决定了数据安全性和集群吞吐能力。我曾在PB级集群运维中亲历过因副本配置不当导致的数据丢失事故&#xff0c…

📰

基于YOLOv8-pose的游泳动作识别实战:数据标注、训练与Gradio部署

简介:面向计算机视觉方向学生与毕业设计开发者,这份资源提供一套基于YOLOv8的游泳动作识别系统,包含完整可运行的源码、配套数据集、可视化界面与部署说明,适合快速复现并用于毕设、课程设计或初期立项演示。资源共97个文件&#…

📰

LangGraph智能体与长期记忆

LangGraph 智能体与长期记忆:从无状态对话到有记忆的协作者摘要:本文基于 DeepLearning.AI《LangGraph 中的 AI 代理》与《基于 LangGraph 的长期代理记忆》两门课程实践,拆解 LangGraph 智能体的三大核心机制:StateGraph 状态流、…

📰

Java聊天系统设计与实现:Socket多线程并发编程实战

简介:面向需要学习 Java 网络编程、完成课程设计或毕业设计的开发者,这一基于 Java 的聊天系统设计与实现资源提供了从客户端到服务器端的完整方案。资源包大小约 518KB,内含源代码、系统运行截图、项目报告和使用说明文档,覆盖用…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬