CCSwitch 配置后仍然打到旧 API 地址怎么办？
很多团队改了 CCSwitch 配置，以为 AI API 接入已经切到新地址，结果日志里仍然是旧 Base URL、旧模型名或旧供应商。这个问题要从客户端、环境变量、profile 和网关日志一起看，不能只盯配置界面。
适用场景：配置看起来改了，请求却没走新链路
典型表现有三种：前端显示已选择新模型，但后端日志还是旧模型；本机调试命中新 Base URL，服务器任务仍走旧地址；AI 自动化办公里的定时任务没有变，只有手动请求变了。出现这些现象时，不要急着删除所有配置，先确认哪一层还在缓存旧值。
CCSwitch 配置通常涉及本地 profile、环境变量、客户端默认参数、代理层和模型服务端。只要其中一层有硬编码，AI API 接入就可能表面切换、实际没切换。永沃云枢建议把每次请求的 base_url_alias、model、profile、client_version 和 request_id 都打到日志里。
配置步骤：做一条可追踪的探针请求
第一步，准备一个不会误伤业务的探针请求，内容写明“endpoint-check-2026-07-23”，并只发到测试会话。第二步，在 CCSwitch 里确认当前 profile 的 Base URL、模型名、Key 名称和备注，截图或导出文本留档。第三步，在调用端临时打印最终配置，不要只打印配置文件路径。常用检查命令包括 rg "base_url|api_base|model|CCSwitch|OPENAI" .，用来找出硬编码和环境变量覆盖。
第四步，对比三处日志：客户端发起日志、CCSwitch 或代理层日志、AI 模型接口返回日志。三者的 request_id 能串起来，才说明模型调用管理链路完整。若只有客户端看起来正确，代理层没有记录，通常是客户端绕过了 CCSwitch；若代理层正确但模型端旧，可能是上游路由规则或默认模型名仍未更新。
失败表现：缓存、环境变量和客户端默认值
最容易漏的是客户端缓存。桌面工具、IDE 插件和长驻进程可能启动时读取一次配置，之后不会热更新。修改后要重启客户端，或明确执行 reload。第二类是环境变量覆盖，例如 OPENAI_BASE_URL、AI_API_BASE、MODEL_NAME 比 profile 优先级更高。第三类是代码里把模型名写死，导致 Base URL 切过去了，模型名却不被新接口识别，于是系统回退到默认模型。
如果 Codex 接入参与排查，让 Codex 先生成“只读证据表”：每个配置来源、优先级、当前值和对应文件。不要让它直接改全局设置。对开发者 AI 调用来说，配置来源透明比一次成功更重要。
常见问题/避坑
不要用生产请求做探针，也不要把真实 Key 打到排查文档。不要同时改 Base URL、模型名、代理和权限，否则失败后无法定位。不要把“新模型回答风格变了”当作切换成功证据，必须以日志里的 endpoint、模型名和 request_id 为准。若存在中间网关，还要检查它是否有独立缓存。
检查清单：确认真正切到新地址
最终验收看这些项：探针请求在客户端、CCSwitch、模型端三处可追踪；Base URL、模型名和 profile 名称一致；长驻进程已重启或 reload；环境变量没有覆盖 profile；旧硬编码已删除或注明弃用；AI 自动化办公的定时任务和手动任务都命中新地址；Codex 变更有 diff 和回滚备注；站内帮助链接覆盖 CCSwitch 配置专题、AI API 接入专题、Codex 安装专题 和 AI 自动化办公专题。
确认这些证据后，再比较模型效果和成本才有意义。否则你看到的可能只是旧接口的最后一次缓存结果。
验收样本：把手动请求和后台任务分开测
只测页面按钮是不够的。至少要准备三条样本：本机命令行请求、前端页面请求、后台队列或定时任务请求。三条样本使用同一个探针词，但分别记录入口、运行账号和读取到的 profile。若本机成功而后台失败，优先查服务启动参数；若页面成功而命令行失败，优先查 shell 环境变量；若只有某个用户失败，可能是用户级配置覆盖了团队 profile。
切换完成后保留一份简短验收表：旧 Base URL 是否还被命中、旧模型名是否还出现在日志、客户端是否重启、CCSwitch 配置导出是否和线上读取值一致。以后再做 AI API 接入、AI 自动化办公或开发者 AI 调用扩展时，这张表能直接复用，避免每次都从猜测开始。
团队协作时还要确认配置发布时间。有人在上午改了测试 profile，另一个人在下午复制旧配置覆盖，就会出现“昨天好好的今天又回旧地址”。可以给每份 CCSwitch 配置导出增加 version、owner 和 updated_at，并让探针请求带上期望版本。这样排查时不是口头确认，而是拿日志和配置版本对齐。
若接入层有多个语言客户端，也要分别检查。Node、Python、桌面工具和浏览器插件读取环境变量的方式不一样，某一端成功不能代表全部成功。每个客户端至少保留一条 endpoint-check 样本，才算完成模型接口切换验收。