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

# Anthropic Claude 模型

> Claude Haiku / Sonnet / Opus 系列,含思考模式

OpenPAI 同时通过 **OpenAI 兼容** 与 **Claude 原生 `/v1/messages`** 两种协议接入 Anthropic Claude。

## 可用模型

| 模型 ID               | 上下文  | 最大输出 | 主要定位                          |
| ------------------- | ---- | ---- | ----------------------------- |
| `claude-opus-4-8`   | 1M   | 128K | 最新顶级,复杂推理与长程智能体编码最强           |
| `claude-sonnet-4-6` | 1M   | 64K  | 速度与智能的最佳平衡,代码 / 推理 / Agent 推荐 |
| `claude-haiku-4-5`  | 200K | 64K  | 最快,近前沿智能,日常对话与代码首选            |

### 旧版本(仍可用)

| 模型 ID                        | 上下文  | 备注         |
| ---------------------------- | ---- | ---------- |
| `claude-opus-4-7`            | 1M   | 上一代顶级      |
| `claude-opus-4-5`            | 200K | 旧旗舰        |
| `claude-sonnet-4-5`          | 200K | 上一代 Sonnet |
| `claude-3-7-sonnet-20250219` | 200K | 中间版本       |
| `claude-3-5-sonnet-20241022` | 200K | 旧版,兼容用途    |

## 思考模式

Claude 支持在最终回答前进行内部推理。不同代际有两种方式:

* **扩展思考(Extended Thinking)**:`claude-sonnet-4-6`、`claude-haiku-4-5` 通过 `thinking` 参数设置 `budget_tokens` 思考预算。
* **自适应思考(Adaptive Thinking)**:`claude-opus-4-8`、`claude-opus-4-7` 通过 `effort` 参数(`low` / `medium` / `high`)控制,Opus 4.8 默认 `high`,不再使用 `budget_tokens`。

### 通过模型 ID 启用扩展思考

| 模型 ID                        | 行为                |
| ---------------------------- | ----------------- |
| `claude-sonnet-4-6-thinking` | Sonnet 4.6,自动启用思考 |
| `claude-haiku-4-5-thinking`  | Haiku 4.5,自动启用思考  |

### 通过参数启用(Claude 原生协议)

```bash theme={null}
# 扩展思考:Sonnet 4.6 / Haiku 4.5
curl https://openp.ai/v1/messages \
  -H "x-api-key: $OPENPAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 4096,
    "thinking": { "type": "enabled", "budget_tokens": 8000 },
    "messages": [{"role": "user", "content": "证明哥德巴赫猜想"}]
  }'
```

```bash theme={null}
# 自适应思考:Opus 4.8(effort 默认 high)
curl https://openp.ai/v1/messages \
  -H "x-api-key: $OPENPAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 4096,
    "effort": "high",
    "messages": [{"role": "user", "content": "证明哥德巴赫猜想"}]
  }'
```

<Note>思考产生的 token 与最终回答 token **分别计费**(thinking\_tokens 与 output\_tokens),控制台日志会区分展示。具体参数支持以控制台为准。</Note>

## 调用示例

### OpenAI 兼容协议

```python theme={null}
from openai import OpenAI
client = OpenAI(api_key="sk-...", base_url="https://openp.ai/v1")

resp = client.chat.completions.create(
    model="claude-opus-4-8",
    messages=[
        {"role": "system", "content": "你是高级 Go 工程师。"},
        {"role": "user", "content": "用 Go 实现一个一致性哈希环。"},
    ],
)
```

### Claude 原生 SDK

```python theme={null}
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-XXXXXXXXXXXXXXXX",
    base_url="https://openp.ai",
)

resp = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=2048,
    system="你是高级 Go 工程师。",
    messages=[{"role": "user", "content": "用 Go 实现一个一致性哈希环。"}],
)
print(resp.content[0].text)
```

## 工具调用

Claude 原生支持 `tools` / `tool_use` / `tool_result` 三步式工具调用,完整兼容 Anthropic 官方协议。
通过 OpenAI 兼容端点访问时,工具调用会自动转换为 OpenAI 的 `tools` / `tool_calls` 结构。
详见 [函数调用](/advanced/function-calling)。

## 视觉

支持图片 URL 和 base64 输入:

```json theme={null}
{
  "model": "claude-opus-4-8",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "图中是什么?"},
        {"type": "image_url", "image_url": {"url": "https://example.com/x.png"}}
      ]
    }
  ]
}
```

## 提示缓存

Claude 支持 `cache_control` 标记长上下文片段以命中提示缓存,缓存命中按更低倍率结算。
OpenPAI 完整透传该字段,详见 [缓存计费](/pricing/cache-billing)。

## 其他能力

Anthropic 还提供 **消息批处理(Message Batches,异步、约 5 折)**、**Files API**、**1M 长上下文**、**引用(citations)** 与 **记忆(memory)** 等能力。是否经 OpenPAI 网关开放以 **控制台 / 站点公告** 为准。

## 接口文档

* [Claude Messages 接口](/api-reference/anthropic/messages)
* [Count Tokens 接口](/api-reference/anthropic/count-tokens)