#集成问题排查

#工具仍在使用旧 Provider

• 重启工具。
• 检查是否读取了其他 Profile 或配置文件。
• 确认 GUI 和后台服务也能读取环境变量，而不仅是当前 Shell。
• 在 CC Switch 中确认已为正确的目标应用启用 Provider。

#模型列表为空

很多工具即使无法加载列表，也能手动填写模型 ID。请从模型页面复制。模型列表为空不代表 Chat Completions 或 Responses 一定不可用。

#Chat 正常但 Codex 失败

聊天工具通常使用 /v1/chat/completions，Codex 使用 /v1/responses。请选择支持 Responses 的模型，并在 Codex Provider 中设置 wire_api = "responses"。

#Chat 正常但 Tool Calling 失败

需要同时验证：

1. 模型支持 Tool Calling；
2. GetRouter 通过当前协议提供该能力；
3. 工具能理解返回的 Tool Call Event。

#URL 路径重复

以下请求路径是错误示例：

/v1/v1/chat/completions
/v1/responses/responses
/v1/chat/completions/chat/completions

请使用对应工具的集成指南，并删除重复路径。

#配置修改不生效

• 检查 JSON 或 TOML 语法。
• 保持工具要求的配置层级。
• 重启进程。
• 检查项目级配置是否覆盖用户级设置。
• 确认 CC Switch 或其他管理工具没有重写文件。

#安全升级问题

请提供版本、协议、模型 ID、Request ID、时间戳和脱敏配置。分享前将 Key 替换为 YOUR_API_KEY。