交給 AI 接入

請在當前項目中只通過 HopBase 接入 Claude 模型，嚴格遵守以下接入說明；與廠商官方 API 文檔不一致時，以本說明為準。

本次範圍
- 只實現 Claude API（Anthropic Messages）或 Claude Code 所需的接入；不要添加、配置或測試其他模型種類。
- 保留項目現有框架、SDK 和代碼風格，只做最小必要修改。
- 先判斷這是本地單用戶工具、內部服務，還是代表下游客戶 / 多租戶發起請求，再決定密鑰放置和調用架構。

密鑰
- 只使用 Claude 系列密鑰。每把密鑰只綁定一個控制檯分組，只能調用該分組內的模型：
  - SDK、HTTP、編輯器與 Claude Code：「Claude Max(官號滿血版)」或「Claude Max(官號滿血版)- 限時特惠」。
  - 「Claude Max（ccmax）」只能在 Claude Code 客戶端內使用；用這把密鑰走 SDK 或 HTTP 調用會失敗。
- 多模型項目讀取 HOPBASE_CLAUDE_API_KEY 或現有密鑰管理器；只有明確為單模型項目時才複用 HOPBASE_API_KEY。
- 不要創建新密鑰、不要讀取其他模型種類的密鑰，也不要讓我把真實密鑰粘貼進對話。密鑰不存在時停止，提示我在控制檯「API 金鑰」中創建對應分組的密鑰，並在本機或密鑰管理器中配置。

模型
- 先用這把密鑰調用 GET https://api.hop-base.com/v1/models，只使用返回列表中以 claude- 開頭的 ID，原樣複製。
- 在售：claude-fable-5-1、claude-sonnet-5、claude-sonnet-5-5、claude-opus-5-5、claude-fable-5、claude-opus-5、claude-opus-4-8、claude-opus-4-7、claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5-20251001。
- 404 model_not_found 表示該 ID 不在這把密鑰的分組裡：重新讀取 /v1/models 並使用返回的 ID，絕不猜測、縮寫或改寫模型名。

連接
- Base URL 為 https://api.hop-base.com，不帶 /v1（SDK 會自行拼上 /v1/messages）。Base URL 多寫 /v1 會變成 /v1/v1/messages 並返回 404。
- 鑑權：SDK 用 api_key 參數，原生 HTTP 用 x-api-key 請求頭；保持 SDK 原生鑑權方式。
- 端點：POST /v1/messages 與 POST /v1/messages/count_tokens。Claude 密鑰調用 OpenAI 路徑（/v1/chat/completions、/v1/responses）返回 404；不要把 Messages 調用改寫成 Chat Completions。
- Claude Code：ANTHROPIC_BASE_URL=https://api.hop-base.com，ANTHROPIC_AUTH_TOKEN=<Claude 密鑰>。一鍵配置會把兩者寫進 ~/.claude/settings.json 的 env 塊，該文件優先於 shell 環境變量。

請求規則
- 始終顯式傳 max_tokens。省略時按 4096 補齊，長輸出會以 stop_reason "max_tokens" 截斷。
- claude-opus-5-5：思考恆開——傳 thinking {"type":"disabled"} 或 budget_tokens 返回 400；用 output_config.effort 控制深度（默認 medium）。tool_choice 為 any / tool 返回 400（改用 auto）。不支持 assistant 預填。
- 歷史中的 thinking 塊必須按收到時原樣回傳（含 signature）；改寫、合併或跨模型複用會返回 400 "Invalid signature in thinking block"。
- 非流式調用總時長上限 300 秒（超時 504）。長輸出請用流式，並原樣透傳 Anthropic SSE；count_tokens 請求同樣佔用併發。

錯誤與重試
- 按 HTTP 狀態碼和 error.code 分支，不要匹配 message 文本；記錄響應頭 x-request-id 以便排查。
- 可退避重試（2 秒、5 秒、15 秒，最多 3 次，遵守 Retry-After）：429、502、503、504，以及中斷的流。
- 不要原樣重試：400、401、402、403、404、413、422——先修正請求、密鑰、分組或餘額。
- Anthropic 形狀的錯誤體沒有 code 字段；密鑰類錯誤（401、402、403）即使在 /v1/messages 上也使用 OpenAI 形狀 {"error":{"code":…}}。
- 404 "This API path is not supported by the current platform" = 協議選錯或 Base URL 多了 /v1。修正配置，不要重試。
- 流式開始後出錯時 HTTP 仍是 200，錯誤以 event: error 事件到達；在讀取循環中處理，並整體重發請求。

實施要求
- 把 Base URL、密鑰變量名和默認模型寫進項目現有配置體系，並同步更新 .env.example；禁止寫入真實密鑰。
- 下游 / 多租戶調用必須把密鑰留在服務端，複用調用方鑑權，並加上模型 allowlist、請求限制、超時、限流、用量歸因和脫敏日誌；本地單用戶工具不要引入這一層。
- 賬戶默認併發 5 個請求，超出立即返回 429 並帶 Retry-After: 1，不會排隊；請在客戶端限流。

驗證與交付
- 配置後發送一次最小真實請求；只有項目實際使用流式時才追加流式測試。
- 用返回列表中的 claude- 模型發送一條 max_tokens 為 1024、要求“只回復 ok”的 Messages 請求，並驗證 content[0].text。
- 最後報告修改的文件、密鑰變量名、模型 ID、端點、HTTP 狀態和脫敏響應摘要，並給出啟動、驗證和回滾命令。