> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude API:三档、版本号与接入

> Claude 的档位 —— Haiku、Sonnet、Opus,以及旗舰 Claude Fable 5:各有什么区别、版本号怎么读(claude-fable-5、claude-opus-5、claude-sonnet-5),以及如何用 OpenAI 兼容协议接入。

Anthropic 的 Claude 以写代码、做智能体和处理长文档见长。所有模型都走 OpenAI 兼容协议,用任意 OpenAI SDK 就能接 —— 只需改 `base_url`。下面讲三档怎么分、版本号怎么读,以及怎么发第一个请求。

## 三档:Haiku、Sonnet、Opus

Claude 分三个命名档位。规律很简单:档位越"高",模型越强,但也更慢、更贵。

| 档位         | 最适合                  | 相对价格 |
| ---------- | -------------------- | ---- |
| **Haiku**  | 快、量大的任务:分类、打标、批量短回复  | 最便宜  |
| **Sonnet** | 日常全能:代码、分析、长上下文      | 中等   |
| **Opus**   | 最难的活:重度重构、多步智能体、深度推理 | 高端   |

<Tip>
  拿不准就从 **Sonnet** 起步(最新是 `claude-sonnet-5`),它能覆盖大多数任务。Sonnet 扛不住复杂度时再上 **Opus**;更看重速度和成本时再降到 **Haiku**。
</Tip>

## 版本号怎么读

ID 里同时编码了档位和代际,例如 `claude-sonnet-5` 或 `claude-opus-5`。只有一条规则:**同一档位内,数字越大越新、越强**。

* `claude-haiku-4-5-20251001` —— 快速的 Haiku 档。部分快照的 ID 带发布日期后缀,如这里所示。
* `claude-sonnet-4-5-20250929`、`claude-sonnet-4-6`、`claude-sonnet-5` —— Sonnet 档;`-5` 比 `-4-6` 新,`-4-6` 又比 `-4-5` 新。
* `claude-opus-4-5-20251101`、`claude-opus-4-6`、`claude-opus-4-7`、`claude-opus-4-8`、`claude-opus-5` —— Opus 档;`claude-opus-5` 是最新代际,比整条 `4-x` 分支都新。
* `claude-fable-5` —— **Fable**,凌驾于各档之上的独立旗舰(见下文),不在这套数字阶梯里。

跨档位比数字没有意义:`opus-4-8` 强于 `sonnet-5`,不是因为数字大,而是因为它是 Opus 档。

<Note>
  精确的当前 ID、版本和单价见 [www.ruapi.ai](https://www.ruapi.ai) 的\*\*「价格」\*\*页。名称跟 Anthropic 官方一致,新版本自动进目录。
</Note>

## Claude Fable 5 —— 旗舰

`claude-fable-5` 是 Anthropic 目前最强的公开发布模型,为最艰难的推理和长程智能体任务而生:大规模迁移、复杂的多步实现、能连续工作数小时的智能体。上下文窗口达 **1M token**;在困难的长程编码与分析任务上,Fable 强于 Opus 档,而在短小、边界清晰的任务上,Opus 与它接近且更便宜。

**选 Fable 还是 Opus?** 最难的活用 `claude-fable-5` —— 大型重构、多日智能体、深度分析。日常写代码和聊天用 `claude-opus-5` 更快,价格约为一半。Fable 位于价格区间的顶端,具体单价见[「价格」](https://www.ruapi.ai)页。

<Note>
  Fable 5 带有安全分类器,会拒答一小部分请求(网络安全、生化、蒸馏类话题)。被拒的请求会以正常的 HTTP `200` 返回,带 `stop_reason: "refusal"` —— 不是报错,所以请在客户端里处理这种情况。Haiku、Sonnet、Opus 没有这个行为。
</Note>

## Claude 最擅长什么

* **代码** —— 编写、重构、调试;是这个家族最强的方向之一,Sonnet 和 Opus 尤为突出。
* **智能体与工具调用** —— 模型返回结构化的函数调用,智能体和流水线就建在这上面(示例见[函数调用](/zh/function-calling))。
* **长文档** —— 大的上下文窗口能装下整个代码库和长文本。
* **视觉(vision)** —— 可以把图片当输入:截图、图表、扫描件(传图格式见[图像输入](/zh/vision))。

## 接入 Claude

`base_url` 始终是 `https://www.ruapi.ai/v1`。用任意 OpenAI SDK,在 `model` 字段填模型 ID:

```python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="你的密钥",
    base_url="https://www.ruapi.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",  # 最难的智能体任务用 claude-fable-5
    messages=[{"role": "user", "content": "你好!"}],
)
print(resp.choices[0].message.content)
```

密钥、`base_url` 和第一个请求的分步配置(Python 与 curl)见[快速入门](/zh/quickstart)。长回复用[流式输出](/zh/streaming)更顺手。领密钥、查余额见[充值](/zh/topup)页。

## 接下来

<CardGroup cols={2}>
  <Card title="接入与第一个请求" icon="bolt" href="/zh/quickstart">
    base\_url、密钥、Python 和 curl 代码。
  </Card>

  <Card title="GPT 模型" icon="robot" href="/zh/gpt-api">
    OpenAI GPT 各档怎么选。
  </Card>

  <Card title="Gemini 模型" icon="sparkles" href="/zh/gemini-api">
    Google Gemini:各档与能力。
  </Card>
</CardGroup>