CCMAX-20X 支持哪些 Claude 模型和 Anthropic API 路由？

CCMAX-20X 在 MaxPlus AI 文档中对应一组第三方 API 路由，而不是 Anthropic 官方 Max 20x 订阅本身。要确认它支持哪些 Claude 模型，最可靠的方法是使用自己的 API Key 请求对应池的 /v1/models，再把返回的模型 ID 用于 Anthropic Messages 兼容接口。文档列出的模型和路由可能调整，因此程序不应把当前清单永久写死。

先区分服务名称与官方产品

MaxPlus AI 是提供兼容 API 和多模型池的第三方服务。它使用自己的域名、API Key、余额、倍率和路由规则。名称中的 CCMAX 或 Claude Max 20x 不表示请求直接进入 Anthropic 官方个人订阅，也不等于用户拥有 Anthropic 官方 Max 20x 权益。

这一区分会影响认证、计费、隐私和故障归属。Anthropic 官方 API Key 与该平台的 ccsk- Key 不能互换；第三方接口返回的模型 ID、错误格式和可用性也应以该平台文档与实时响应为准。接入前应自行评估第三方服务条款、数据处理方式和业务风险。

API 的基础地址与认证方式

文档给出的生产基础域名是 api.maxplus-ai.cc。普通推理请求使用平台生成的 ccsk- API Key，可放在 Authorization: Bearer 请求头中，也可使用 Anthropic 风格的 x-api-key 请求头。

密钥只应保存在服务端秘密管理系统或本地安全环境变量中，不应写入前端代码、仓库、截图和日志。文档还区分了推理 Key 与管理 Token：推理 Key 用来查询模型、余额和调用模型，管理 Token 用来创建、轮换或撤销 Key。不要为了方便给日常推理程序配置管理权限。

为什么必须先请求模型列表

多模型网关的模型可用性通常由账户权限、Key 绑定的池、当前渠道和服务端配置共同决定。文档中的表格只能说明平台曾声明支持哪些模型，不能证明每个 Key 在任意时刻都能使用全部模型。

对应池的 /v1/models 返回当前 Key 实际可见的模型。程序启动、配置变更或模型调用失败时，先获取这个列表，比猜测模型名更可靠。响应中的 id 才是后续请求应提交的模型标识，展示名称只用于界面。

curl "$CCMAX_BASE_URL/v1/models" 
  -H "Authorization: Bearer $CCMAX_API_KEY"

示例中的基础地址应由环境变量保存，避免在多个代码文件中重复配置。实际请求前要确认该地址对应 Key 所属的池；有些池使用独立路径前缀，而不是根路径。

文档列出的 Claude 模型范围

当前文档在原生 Anthropic 池的模型列表中列出 Claude Opus、Sonnet 和 Haiku 系列，并展示了 Opus 4.8、4.7、4.6、Sonnet 4.6、4.5 与 Haiku 4.5 等示例。文档示例响应还可能出现更新的模型条目。

这些名称应视为当前文档快照，不应被解释为长期 SLA。模型可能新增、下线、改名或只对特定池开放。生产系统应允许管理员更新模型 ID，并在部署前通过 /v1/models 验证，而不是将营销名称转换为自认为正确的 ID。

CCMAX 相关的主要路由

文档为不同模型池分配不同路径前缀。CCMAX 组合池示例使用 /ccmax/v1/messages，模型 ID 带有 ccmax/ 前缀。Claude Max 20x Lite 示例使用 /cmax-lite/v1/messages，Full 示例使用 /cmax-full/v1/messages，另有 Specials 路径。

路径前缀与模型 ID 是一组契约。把某个池的模型 ID 发到另一个池的路由，可能返回找不到模型、无权限或路由不匹配。接入时应把“基础地址、池前缀、模型 ID”作为一个配置对象管理，不要让用户在三个独立输入框中随意拼接。

Anthropic Messages 兼容调用

Claude 文本调用采用 Anthropic Messages 风格，请求路径以 /v1/messages 结尾，请求体包含 model、max_tokens、messages 和可选的 stream。请求头通常需要 API Key、JSON 内容类型和 Anthropic API 版本。

curl "$CCMAX_BASE_URL/ccmax/v1/messages" 
  -H "Authorization: Bearer $CCMAX_API_KEY" 
  -H "anthropic-version: 2023-06-01" 
  -H "content-type: application/json" 
  -d '{
    "model": "ccmax/claude-sonnet-4-6",
    "max_tokens": 128,
    "stream": false,
    "messages": [{"role":"user","content":"Reply with pong"}]
  }'

上例仅演示文档中的请求形状，模型 ID 是否可用仍要以自己的模型列表为准。不要把真实 Key 直接写进命令历史；可通过环境变量、秘密文件或进程注入传递。

流式请求与普通请求

把 stream 设为 false 时，客户端等待完整 JSON 响应，适合最小连通性测试。设为 true 时，服务以 SSE 流返回事件，适合 Claude Code、交互式终端和长文本生成。

测试路由时应先用非流式短请求，确认认证、模型名和响应结构；随后再测试流式事件解析、断线重连与超时。这样能把“模型不可用”和“客户端不会解析 SSE”分开定位。代理层还需允许较长连接，避免把正常生成误判为超时。

不同池为什么要使用独立前缀

文档中的池不仅按模型家族划分，还可能代表不同上游、缓存策略、可用性和倍率。独立前缀让网关能在请求进入时确定路由范围，也避免同名模型在多个渠道之间产生歧义。

因此，模型名相同不代表价格、延迟、上下文限制和稳定性相同。应用应保存实际调用的池、模型 ID、请求时间与错误码，便于核对和定位故障，但不要记录提示词、响应正文或完整 Key 等敏感数据。

如何在程序中动态选择模型

推荐在服务启动时获取一次模型列表并短期缓存，同时提供手动刷新机制。配置中的首选模型若不在列表内，程序应停止或降级到经过批准的备用模型，而不是自动选择列表第一项。自动选错模型可能带来能力变化和意外成本。

模型选择界面应展示来自 API 的 ID，并附上本地维护的用途说明。不要根据字符串包含 Opus、Sonnet 或 Haiku 就推断全部能力；工具调用、视觉输入、上下文长度和提示缓存等特性都需要单独做兼容测试。

1. 请求当前池的 /v1/models
2. 验证首选模型 ID 是否存在
3. 发送非流式最小请求
4. 验证流式事件与工具调用
5. 记录池、模型和计费结果

余额与用量接口的作用

文档提供 /v1/me 查询账户余额、Key 状态和消费上限，也提供 /v1/usage 查看指定时间范围内的请求数、Token 与成本。上线前可用这些接口检查 Key 是否有效以及是否接近限制。

余额充足不等于模型一定可用，模型可见也不等于 Key 没有消费上限。健康检查最好分别验证账户、模型目录和一次低成本请求。对生产任务设置独立 Key 与支出上限，可降低测试脚本或泄露密钥造成的影响。

常见错误的分层判断

认证失败时先检查请求头、Key 类型与是否已撤销；模型不存在时检查当前池的模型列表、路径前缀和模型 ID；余额或上限错误时查询账户与 Key 的消费状态；请求过多时按响应头与平台限制退避，不要无界重试。

如果返回成功但客户端解析失败，应保存脱敏后的状态码、内容类型和事件名称，对照 Anthropic Messages 格式检查兼容差异。兼容 API 并不保证所有 SDK 功能都完全一致，尤其是 Beta 请求头、工具调用细节和新增字段，需要通过集成测试确认。

接入第三方路由的安全边界

通过第三方网关发送的提示词、代码和文件会经过该服务的基础设施。涉及源码、个人信息、密钥、客户数据或受监管数据时，应先完成供应商评估、数据处理协议和最小化设计。不能因为接口兼容 Anthropic 就假设其隐私、留存和审计规则与 Anthropic 官方相同。

建议为开发、测试和生产分别创建 Key，设置最小额度与轮换周期，并限制日志内容。发现 Key 泄露后立即撤销或轮换，不能只在代码仓库中删除字符串，因为历史提交、构建日志和缓存仍可能保留副本。

上线前的验收清单

验收时应确认基础地址来自受控配置，TLS 校验未被关闭，Key 只存在于秘密存储，模型 ID 来自目标池的实时列表。分别执行非流式、流式和错误请求，检查响应解析、超时、重试和成本记录。

随后验证 Key 的消费上限、余额告警和轮换流程，并模拟模型从列表消失时的行为。系统应给出明确错误或切换到审批过的备用模型，而不是静默改走另一个价格与数据边界不同的渠道。

结论

CCMAX-20X 支持范围不能只靠一张静态模型表判断。当前 MaxPlus AI 文档展示了多个 Claude 模型和 CCMAX、cmax-lite、cmax-full 等 Anthropic Messages 兼容路由，但每个 Key 的真实可用范围应由相应池的 /v1/models 返回值决定。

正确接入方式是把池前缀、模型 ID 和认证配置成一组，先查询模型，再做最小请求与流式验证，同时检查余额、限额和数据安全。并且始终明确：这是第三方兼容服务的路由能力，不是 Anthropic 官方 Max 20x 订阅或官方 API 的能力声明。