Claude Fable 5.2 怎么用？Claude Code 与 Messages 接入教程

优先 Anthropic Messages，SDK Base URL 填 https://deepclub.net，模型名填 claude-fable-5-2。

模型 ID: claude-fable-5-2
推荐协议: Anthropic Messages
首选端点: POST /v1/messages
适配: Claude Code
计费: 按百万 Token

参数	值
模型 ID	`claude-fable-5-2`
类型	文本
调用端点	`POST /v1/messages`、`POST /v1/chat/completions`
推荐协议	Anthropic Messages（推荐）
客户端与 SDK	Claude Code、Anthropic Python SDK
计费方式	按百万 Token，实时价格见定价页

Claude Fable 5.2 适合做什么，不适合做什么？

适合复杂调查、编码和长时间多轮 Agent 任务。

Fable 系列在 Claude Code 中面向复杂、长时间自主任务。DeepClub 当前已发布 claude-fable-5-2 的 Messages 和 Chat 接口，优先使用 Messages 的原生内容块与工具调用格式。

适合的场景：

长时间代码调查与修改
需要多轮工具和验证的任务
复杂问题的根因分析

不太适合：预算紧张的简单高频请求；先对照实时价格和实际任务收益。

claude-fable-5-2 的 Base URL 和 API Key 怎么获取？

本文 Anthropic Python SDK 示例的 Base URL 为 https://deepclub.net，Key 在控制台创建。客户端地址拼接规则可能不同，请按下方对应客户端的步骤填写。

登录深云 DeepClub，进入控制台的 API 密钥 页面。
点击 创建 API 密钥，复制生成的 sk- 开头密钥。
在 Anthropic SDK 或 Claude Code 中填写以下三项（其他客户端按下文对应步骤填写，多为 https://deepclub.net/v1）：

Base URL: https://deepclub.net
API Key:  sk-你的DeepClub密钥
Model:    claude-fable-5-2

claude-fable-5-2 推荐哪个协议？

首选 Anthropic Messages：POST /v1/messages。

Claude 优先使用 Anthropic Messages，直接保留 content blocks、tool_use / tool_result、思考（thinking）和 cache_control 字段的原生结构；各型号接受的参数不同，见下文。OpenAI Chat 兼容接口适合已有 Chat 客户端，不应作为新集成的首选。

参考：Anthropic 原生 API 与 OpenAI 兼容层的差异。

选择依据是模型官方接口、DeepClub 已发布端点和客户端实际能力。使用缓存、推理或工具调用前，请先用小请求验证；端点可用不代表提供联网搜索等厂商托管工具、保证缓存命中或在服务端保存会话。

Claude Fable 5.2 在 Claude Code 里怎么配置？

ANTHROPIC_BASE_URL 设为 deepclub.net，不带 /v1。

在终端设置环境变量：export ANTHROPIC_BASE_URL=https://deepclub.net。
设置密钥：export ANTHROPIC_AUTH_TOKEN=sk-你的DeepClub密钥。
指定模型：export ANTHROPIC_MODEL=claude-fable-5-2。
在项目目录运行 claude，请求会走 /v1/messages。

Claude Code 会自己拼接 /v1/messages，所以 Base URL 不要带 /v1。请使用支持该型号的 Claude Code 版本（见 Claude Code 接入页的版本表）。

怎么用 Python 调用 claude-fable-5-2（推荐协议）？

安装 pip install -U anthropic，并在本地设置环境变量 DEEPCLUB_API_KEY。

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["DEEPCLUB_API_KEY"],
    base_url="https://deepclub.net",
)

response = client.messages.create(
    model="claude-fable-5-2",
    max_tokens=4096,
    messages=[{"role": "user", "content": "为这个工程制定一份可验证的错误排查清单"}],
)
print("".join(block.text for block in response.content if block.type == "text"))

用 curl 调用 Anthropic Messages（推荐）

curl https://deepclub.net/v1/messages \
  -H "x-api-key: $DEEPCLUB_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-fable-5-2","max_tokens":4096,"messages":[{"role":"user","content":"为这个工程制定一份可验证的错误排查清单"}]}'

用 curl 调用 OpenAI Chat Completions（兼容选项）

仅在现有客户端或集成需要该协议时选用；切换时必须同步修改请求体和响应解析。

curl https://deepclub.net/v1/chat/completions \
  -H "Authorization: Bearer $DEEPCLUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-fable-5-2","messages":[{"role":"user","content":"为这个工程制定一份可验证的错误排查清单"}]}'

claude-fable-5-2 怎么开启思考？哪些参数不能用？

claude-fable-5-2 在 /v1/messages 上不接受非 1 的 temperature、top_p、top_k，也不接受 thinking: {"type": "enabled", "budget_tokens": ...}，会返回 400。需要思考时使用自适应思考，用 output_config.effort 控制强度（low / medium / high）：

{
  "model": "claude-fable-5-2",
  "max_tokens": 4096,
  "thinking": {
    "type": "adaptive",
    "display": "summarized"
  },
  "output_config": {
    "effort": "medium"
  },
  "messages": [
    {
      "role": "user",
      "content": "为这个工程制定一份可验证的错误排查清单"
    }
  ]
}

如果客户端会在 Messages 请求里自动带温度、Top P 或思考预算，请先在客户端里关闭这些设置。走 /v1/chat/completions 时，网关会忽略这些采样参数，并把 reasoning_effort 转换为自适应思考。

Fable 5.2 在 Claude Code 中需要什么版本？

使用 Claude Code 2.1.321 或更新版本，并填写完整模型 ID。

通过 ANTHROPIC_MODEL=claude-fable-5-2 或 claude --model claude-fable-5-2 选择模型。使用完整 ID 可避免别名随客户端升级指向其他型号。

版本要求见 Claude Code 模型配置。网关上下文、价格和可用规格以本站目录为准。

claude-fable-5-2 API 怎么计费？

按百万 Token 计费，输入和输出分别计价。

实时价格见定价页。

计费单位：按百万 Token，价格可能调整，以定价页实时显示为准。
用量明细：在控制台 使用日志 中按请求查看消耗。
充值方式：支持信用卡、微信支付、支付宝等，以控制台充值页显示为准。

调用 claude-fable-5-2 报 401 怎么办？

401 表示密钥无效或缺失，先检查 Key 是否完整。

确认 API Key 前后没有空格或换行，且令牌未被禁用、未过期。
Messages 请求用 x-api-key: sk-... 并带 anthropic-version: 2023-06-01；Claude Code 的 ANTHROPIC_AUTH_TOKEN 使用网关支持的 Authorization: Bearer。OpenAI Chat Completions 请求使用 Authorization: Bearer sk-...。
如果返回 404，按上面的客户端步骤检查最终请求地址，避免重复或漏掉 /v1；模型 ID 必须完整匹配 claude-fable-5-2。Anthropic SDK、Claude Code 与桌面客户端的 Base URL 拼接规则不相同。

用 claude-fable-5-2 时请求内容会被存储吗？

不会，深云 DeepClub 实行零留存（ZDR）政策。

深云 DeepClub 实行 Zero Data Retention (ZDR) 零留存政策：请求的输入和输出内容不做持久化存储，详见隐私政策。

使用 Claude Fable 5.2 还有哪些常见问题？

以下问答汇总了调用时最常见的问题。

调用 claude-fable-5-2 返回 401 Unauthorized 怎么办？

401 表示密钥无效或缺失，先检查 API Key 是否复制完整、前后没有空格。Messages 请求用 x-api-key: sk-... 并带 anthropic-version: 2023-06-01；Claude Code 的 ANTHROPIC_AUTH_TOKEN 使用网关支持的 Authorization: Bearer。OpenAI Chat Completions 请求使用 Authorization: Bearer sk-...。

claude-fable-5-2 用哪个接口和协议调用？

优先用 Anthropic Messages，端点为 POST /v1/messages，Anthropic Python SDK 的 Base URL 为 https://deepclub.net。其他已开放端点 POST /v1/chat/completions；只有客户端限制或已有集成需要时才使用兼容路径。

claude-fable-5-2 API 怎么计费？

按百万 Token 计费，输入和输出分别计价。实时价格见 https://deepclub.net/pricing/claude-fable-5-2。

Fable 5.2 在 Claude Code 中需要什么版本？

使用 Claude Code 2.1.321 或更新版本，并填写完整模型 ID。

常见问题

调用 claude-fable-5-2 返回 401 Unauthorized 怎么办？: 401 表示密钥无效或缺失，先检查 API Key 是否复制完整、前后没有空格。Messages 请求用 x-api-key: sk-... 并带 anthropic-version: 2023-06-01；Claude Code 的 ANTHROPIC_AUTH_TOKEN 使用网关支持的 Authorization: Bearer。OpenAI Chat Completions 请求使用 Authorization: Bearer sk-...。
claude-fable-5-2 用哪个接口和协议调用？: 优先用 Anthropic Messages，端点为 POST /v1/messages，Anthropic Python SDK 的 Base URL 为 https://deepclub.net。其他已开放端点 POST /v1/chat/completions；只有客户端限制或已有集成需要时才使用兼容路径。
claude-fable-5-2 API 怎么计费？: 按百万 Token 计费，输入和输出分别计价。实时价格见 https://deepclub.net/pricing/claude-fable-5-2。
Fable 5.2 在 Claude Code 中需要什么版本？: 使用 Claude Code 2.1.321 或更新版本，并填写完整模型 ID。

更新于 2026-11-12