Claude Haiku 5.5 API 接入：3 步配 effort

2026 年 10 月 8 日，Anthropic 发布 Claude Haiku 5.5，这是目前官方定位「最便宜、最快、能力最强」的小模型，平均运行成本比上一代 Haiku 4.5 低约 75%。API 接入只需 3 步：控制台拿 Key、把模型 ID 填成 claude-haiku-5-5、按任务轻重配置 effort 档位。

这台小模型是首个带 effort 设置的 Haiku，五个档位（Low / Med / High / Xhigh / Max），要省钱还是拼能力，都由你来定。它已经全平台上线，Claude Platform、Claude Code、AWS、谷歌云 Vertex 和 Azure 都能直接用。下面从零带你把 API 接上。

准备工作：注册 Claude 控制台并拿到 API Key

API 接入走的是 Claude 开发者控制台（platform.claude.com），和网页版 claude.ai 登录互通，但需要一个能正常访问 Anthropic 服务的网络。注册完成后，主页侧边栏切到「API Keys」，点 Create Key，就会生成一串以 sk-ant- 开头的凭据，复制保存，后面代码里要用。

国内使用提示：Claude API 对大陆网络不一定直连，需要能访问支持区域（中国香港、日本等地）的网络环境。这一步先行确认，否则后面的调用会连不上。接线之前，先看清 Anthropic 官方的支持地区列表。

接入第 1 步：确认模型 ID 与接口端点

代码里要填两个东西：接口地址和模型名。官方兼容 OpenAI 风格，也支持官方 SDK。用 Anthropic 官方 Python 库时，模型 ID 直接写 claude-haiku-5-5 即可。

如果走 OpenAI 兼容端点，endpoint 填 Anthropic 的兼容域名，model 填 claude-haiku-5-5。模型 ID 是 API 路由的唯一标识，别的模型（比如 Sonnet 5.5 的 claude-sonnet-5-5）地址不同，别串。
关于 Sonnet 5.5 的模型能力与价格，可参考站内这篇 Sonnet 5.5 详解。

接入第 2 步：五档 effort 参数怎么选

Haiku 5.5 是第一个带 effort 档位的 Haiku 模型，共五档。effort 决定模型在回答前去想多少步、要不要多次检查，档位越高越聪明，token 也耗得越多。

调用时把 effort 设定进请求参数，服务端按你选的档位运行，不同档位结算单价不同。

省钱建议：高并发、对答案质量要求不苛刻的调用，从 Low 或 Med 起步；跑通后再根据评测结果决定要不要升档，别一上来就开 Max 无谓烧钱。

接入第 3 步：用 Python 跑通一条真实请求

装 Anthropic 的 Python 包后，下面是 3 个开源可跑的最小示例。

pip install anthropic

import anthropic

client = anthropic.Anthropic(api_key="sk-ant-你的Key")

resp = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "把下面这段英文总结成 3 句中文："}],
)
print(resp.content[0].text)

跑通的前提：网络 reachable、Key 有效、账户有可用额度。返回正常后，把 max_tokens 和 effort 档位按你的场景调好，就能上线了。

Haiku 5.5 价格与成本对比

以下价格为公开报道核实的 API 单价，均按每百万 token 计费：

整体平均运行成本比 Haiku 4.5 低约 75%，是目前成本敏感任务的首选之一。定价数据来源为网易公开渠道的定价明细，最终生效价格请以 Anthropic 官方 Pricing 页面 为准。

把 Haiku 5.5 当编码 subagent 用（Claude Code）

Claude Code 里也能用 Haiku 5.5。在 ~/.claude/settings.json 或项目级 settings.json 里，把 subagent 的 model 指到 claude-haiku-5-5，再配一个 effort 档位，跑 agent 的子任务就用这台便宜模型，而不是默认的 Sonnet。

大概这样一段配置（以你所装版本的 schema 为准）：

{
  "subagent": {
    "model": "claude-haiku-5-5",
    "effort": "Medium"
  }
}

配完后，编程 agent 里那些要拆给 subagent 的重复步骤（提取依赖、改单文件、生成注释），都落到 Haiku 5.5 上，主线程的复杂决策仍交给大模型。

Haiku 5.5 适合做什么（场景定位）

官方定位很明确：适合范围窄、量大、对成本敏感的活。典型的三类场景是上下文压缩、摘要，以及把子任务切给 subagent。以前这些活丢给 Claude 跑成本划不来，现在 Haiku 5.5 把单价打了下来（成本较旧版降了约 75%）。

跑分上，Haiku 5.5 在 OSWorld 2.1 到 72.4%（Haiku 4.5 仅 15.4%）、Terminal-Bench 4.0 拿 39.2%、Humanity's Last Exam 带工具 57.4%，把小模型在 coding / computer use 上的短板补了上来（数字来自腾讯新闻的评测稿）。但和 Sonnet 5.5 仍有距离，复杂 Agentic 编码主任务还是交给大模型更稳当。

如果对 Claude 家族怎么排梯队还不熟，可以顺着 Claude Sonnet 5.5 相关文章 和 Claude Fable 5.1 指南 看下去。

最后更新

2026 年 10 月。作者署名：AI345