CC Switch：管理 8848API 配置与应用接管

把服务商配置管理、模型选择和本地代理分开操作。按 Claude Code、Codex CLI 与桌面应用选择流程，先备份、再启用、最后核对实际生效位置。

从这里开始返回文档首页

更新：2026-10-15 · 菜单随客户端版本变化，以实际版本为准。模型权限、协议和价格以当前账户可用服务为准。

1. 先弄清它负责什么

先登录控制台，在「令牌管理」创建单独用于此工具的令牌。检查有效期、额度、允许模型和访问限制；令牌不是网站登录密码，也不是厂商官方账号。

模型 ID：从当前账户可用列表复制完整名称，不用中文显示名或凭印象填写版本。列表可见不等于该模型支持每一种协议和工具功能。
预算：首次选一个已授权的模型，先进行一轮短对话。Agent 可能一项任务连续调用多轮；工具、附件、长历史和自动重试都会增加用量。
保护密钥：不要粘贴到聊天、截图、工单正文、公开项目或分享链接。日志和配置备份也按敏感文件保管。
已有配置：先用客户端自带导出/备份，或私下保存原配置，再合并新增条目；不要用教程整份覆盖已有服务商、MCP、项目或认证设置。

CC Switch 是第三方配置管理工具，不是模型供应商，也不会让一个只支持聊天的模型自动获得 Responses、视觉或工具调用能力。启用供应商可能修改本地配置；开启代理接管则会改变请求路径，两者不是同一操作。

CC Switch 并非 Claude 或 Codex 官方产品。不同版本的面板、代理协议转换和桌面应用支持范围可能不同；本文不把旧截图中的按钮、端口或功能当作所有版本的固定契约。

2. 下载安装与保留原配置

从项目发布页选择匹配系统及CPU架构的安装包，阅读该版本说明，不安装来历不明的修改包。
先确认目标工具本身已经安装。只查看版本和帮助即可，不必为了创建配置先发起模型对话。
记录原来使用哪个服务商、哪种登录方式，使用应用提供的备份功能；手工备份含密钥的文件时不要上传到公共云盘或项目仓库。
打开CC Switch后先核当前选择的目标应用，再新增配置。不要同时在多个配置管理器、shell环境变量和项目配置中写相互冲突的地址。

如果系统提示安装包不可信，先核来源和签名，不通过关闭系统保护来强行安装。

3. 按客户端选择正确协议

目标	优先配置路径	不能混用的内容
Claude Code CLI	Claude Code配置 / Anthropic Messages网关	不能仅填OpenAI Chat Completions地址；原生网关基地址为站点根地址
Codex CLI	Codex自定义Provider / Responses	wire_api=responses，Base URL到/v1；不是Claude的env配置
Codex桌面应用	先查看该版本官方设置与CC Switch版本说明	CLI面板存在不证明桌面接管、官方登录保留或手机远程全部兼容

详细步骤分别见 Claude Code教程、Codex CLI教程；官方远程与API接入的区别见远程说明。

4. 配置 Claude Code CLI

选择Claude Code对应面板，新增自定义供应商，名称写为8848API。
采用原生Anthropic Messages网关时，基地址填写 https://api.884819.xyz，令牌按该版本界面要求填写。最终应请求 /v1/messages；不要因为首页曾展示通用/v1地址就重复拼接。
按模型映射字段填写当前账户可用且支持Messages与工具调用的模型ID；不要把界面中的Sonnet/Opus档位名当成平台实际模型ID。
保存后明确启用该供应商；「保存」不一定等于「切换成功」。
重新启动新的CLI进程，检查终端中的 /status 和 /model；留意shell、项目设置或旧认证覆盖。

若当前版本要求不同地址格式，应检查实际最终URL，不能盲目在根地址与/v1之间来回切换。代理模式下客户端也可能只显示本机地址，要结合上游配置和脱敏日志判断。

5. 配置 Codex CLI

选择Codex对应面板，确认目标是CLI，不把ChatGPT桌面应用与CLI混为一谈。
新建8848API条目：上游为 https://api.884819.xyz/v1，模型ID按当前账户填写，协议使用Responses。
如果界面可编辑TOML，核对 model_provider 指向新增条目、wire_api = "responses"；密钥字段采用该版本已支持的方式，不凭空添加不认识的选项。
启用后私下检查 ~/.codex/config.toml（或自定义CODEX_HOME下配置）是否对应目标Provider。不要粘贴含认证信息的整个文件来排查。
普通直连配置不需要额外启动代理。确实需要转换时，先确认该版本对客户端与上游协议组合有明确支持。

若配置管理器没有明确支持你的模式，优先按官方Provider手工配置，不要强套旧版桌面代理教程。

6. 只有确实需要时才开启代理接管

代理路径通常是「客户端 → 本机代理 → 上游平台」。只有该版本明确支持目标应用和协议组合时才启用；本文不预设固定端口，也不保证任意桌面版都可被接管。

记录面板实际显示的监听地址/端口，保持回环监听 127.0.0.1；不要改成 0.0.0.0 或开放防火墙供公网使用。
核对接管开关作用于哪个应用，是否需要重开应用，退出代理后如何恢复原配置。
确认上游Provider、模型映射与认证完整。代理启动成功，只证明本地进程运行，不证明上游调用通过。
客户端显示本机地址属于代理模式的正常现象，但应从脱敏请求日志核对真实上游，不凭UI颜色判断成功。
如果还有HTTP_PROXY、VPN或其他转发器，避免代理递归和端口冲突；不通过关闭TLS校验排错。

官方登录与第三方API令牌职责不同。不要手工伪造auth.json、复制他人账号令牌，或宣称「保留登录」即可保证远程同步及所有官方功能。

7. 分三层验证

会产生真实调用：以下发消息、检查模型连接或执行 Agent 任务可能计费；先核预算，不反复点击检测、不批量试模型。只查看版本、静态配置和本地状态不等于模型已经可用。

配置层：选对应用、启用正确供应商、最终路径与模型名正确。
本机层：若使用代理，确认实际监听与转发日志；直连模式不用为了测试再开代理。
服务层：经确认预算后用一轮短请求验证，并核平台调用记录。后续工具调用与长任务单独测试，不能由短对话成功推出全部兼容。

出现401、404或502时，先记录错误正文、请求ID和时间，再看分层排障指南，不连续点击测速产生额外费用。

8. 安全恢复与常见误区

切换后仍走旧地址

检查是否只是新增未启用、是否运行旧进程、是否有环境变量/项目配置覆盖。每次只改一个配置来源。

停了代理，客户端突然不可用

可能仍指向本机地址。使用应用提供的停止接管/恢复流程，确认上游配置恢复后再退出；不要直接删除认证文件或全部配置。

需要换回原账号

先关闭本次接管，恢复原服务商或备份，再按官方客户端登录流程处理。API Key不能替代官方账号权益。

配置导出可以直接发客服吗？

不可以。导出、数据库和日志可能包含完整密钥。只提交脱敏字段、版本、错误码和请求ID。

官方资料与核验边界

本文整理安装与配置方法，不代表所有客户端版本、模型、工具调用或远程功能均已实测。本次文档更新未发起付费模型请求；文中的模型验证、首次对话和自动化运行可能计费，请确认模型与预算后自行执行。