#整合疑難排解

#工具仍在使用舊供應商

• 重新啟動工具。
• 檢查工具是否讀取了其他設定檔或組態檔。
• 確認 GUI 應用程式與背景服務也能取得環境變數，而非只有互動式 shell 能取得。
• 在 CC Switch 中，確認供應商已針對正確的目標應用程式啟用。

#模型清單是空的

許多工具即使無法顯示模型清單，仍可使用手動輸入的模型 ID。請從 Models 複製一個模型 ID。清單為空並不代表 Chat Completions 或 Responses 無法使用。

#聊天功能正常，但 Codex 失敗

聊天用戶端通常使用 /v1/chat/completions；Codex 使用 /v1/responses。請選擇支援 Responses 的模型，並在 Codex 供應商設定中設定 wire_api = "responses"。

#聊天功能正常，但工具呼叫失敗

請確認以下三個層面：

1. 模型支援工具呼叫；
2. GetRouter 透過所選協定提供該功能；
3. 工具能理解回傳的工具呼叫事件。

#URL／路徑重複

以下是錯誤的請求範例：

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

請依照該工具的整合指南設定，並移除重複的路徑片段。

#設定變更未生效

• 驗證 JSON 或 TOML 語法。
• 保留工具要求的巢狀結構。
• 重新啟動程序。
• 檢查是否有專案層級設定覆寫使用者設定。
• 確認 CC Switch 或其他管理工具未重寫檔案。

#安全地升級處理

請提供版本、協定、模型 ID、Request ID、時間戳記，以及經遮蔽的設定。分享前請將金鑰替換成 YOUR_API_KEY。