交给 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 状态和脱敏响应摘要，并给出启动、验证和回滚命令。