标题：Claude Opus 5 API 接入教程：model ID、base_url 到 Claude Code / Cline 首次调用全流程（2026）

正文：
本文记录从申请 API Key 到在 Claude Code / Cline 中完成首次调用的完整流程。model ID 为 claude-opus-5，Anthropic 原生协议和 OpenAI 兼容协议均可接入。中间有两个常见错误需要注意：model 字段拼写错误会返回 404，缺少 max_tokens 会返回 400，下文均有说明。

这篇适合谁

• 想使用 Opus 5 但不确定 model 字段填写方式的开发者
• 已在使用 Claude Sonnet 4.5 / Opus 4.8，计划升级到 Opus 5 的用户
• 使用 Claude Code 或 Cline 辅助编程，需要切换底层模型的用户
• 团队需要统一 API 网关，希望通过一个 base_url 同时调用 Opus 5 和 GPT-5 的用户

整体流程

graph LR
 A[1.注册/登录 Anthropic Console] --> B[2.创建 API Key]
 B --> C[3.安装 SDK 或配置 HTTP]
 C --> D[4.填 model=claude-opus-5]
 D --> E[5.首次调用验证]
 E --> F[6.接入 Claude Code / Cline]

六步，最快 10 分钟跑通。

先说结论

项目	直连 Anthropic	聚合网关（如 ofox.io）
Model ID	claude-opus-5	anthropic/claude-opus-5
base_url	https://api.anthropic.com	https://api.ofox.io/v1
消息端点（endpoint）	/v1/messages	/chat/completions
Anthropic 特有必填请求头	x-api-key、anthropic-version: 2023-06-01	由网关处理，通常只需 Authorization
必填参数	model、max_tokens、messages	model、max_tokens、messages
定价	官方未公布，参考上代 claude-opus-4-8：input $15/M tokens, output $75/M tokens	视网关定价策略而定

⚠️ Opus 5 定价截至 2026 年 7 月官方未正式公布，上表价格仅为 claude-opus-4-8 参考值，请以 Anthropic 官方定价页 为准。

⚠️ base_url 与消息端点（endpoint）是不同概念。SDK 初始化时传入的是 https://api.anthropic.com，/v1/messages 是具体接口路径，两者不可混用。

⚠️ https://api.anthropic.com 本身不提供可浏览的页面，直接访问会返回 404，这属于正常现象；SDK 和 HTTP 客户端在调用具体接口路径（如 /v1/messages）时工作正常。

第一步：拿 API Key

登录 console.anthropic.com，左侧菜单点 API Keys → Create Key。

复制并妥善保存，页面关闭后将无法再次查看。新账号有少量免费额度（具体金额以 Console 实时显示为准）。

第二步：安装 SDK

Python 用户：

pip install anthropic

Node.js 用户（最低 Node 版本要求请以 @anthropic-ai/sdk npm 页面 的 engines 字段为准）：

npm install @anthropic-ai/sdk

不想安装 SDK？直接使用 requests 或 curl 也可以，参见第五步的原生 HTTP 方案。

第三步：首次调用（Anthropic 原生协议）

以下是完整可运行示例：

import anthropic

client = anthropic.Anthropic(api_key="sk-ant-xxx")
msg = client.messages.create(
    model="claude-opus-4.8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(msg.content[0].text)

model 填 claude-opus-5，注意拼写——写成 claude-opus5 或 opus-5 会返回 404。

流式输出版本

构建对话产品时通常需要 streaming：

import anthropic

client = anthropic.Anthropic(api_key="sk-ant-xxx")
with client.messages.stream(
    model="claude-opus-4.8",
    max_tokens=2048,
    messages=[{"role": "user", "content": "写一段快排"}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

第四步：OpenAI 兼容协议接入（聚合网关方案）

如果项目已在使用 OpenAI SDK，或者需要通过一个 base_url 同时调用 Claude / GPT / Gemini，使用 OpenAI 兼容协议最为便捷。OpenRouter、ofox.io 等聚合网关均支持，修改 base_url 和 model 字段即可。

from openai import OpenAI

client = OpenAI(
    api_key="your-ofox-key",
    base_url="https://api.ofox.io/v1"
)

resp = client.chat.completions.create(
    model="anthropic/claude-opus-4.8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "解释一下 Rust 的所有权"}]
)
print(resp.choices[0].message.content)

注意：聚合网关的 model 字段需要带 provider 前缀，即 anthropic/claude-opus-5；Anthropic 直连时则填 claude-opus-5。

第五步：原生 HTTP 调用（无 SDK 环境）

在无法安装 SDK 的场景（如 Serverless 冷启动追求极致轻量）下，可直接发送 HTTP 请求：

import requests

headers = {
    "x-api-key": "sk-ant-xxx",
    "anthropic-version": "2023-06-01",
    "content-type": "application/json"
}

data = {
    "model": "claude-opus-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
}

r = requests.post(
    "https://api.anthropic.com/v1/messages",
    headers=headers,
    json=data
)
print(r.json())

anthropic-version 当前值为 2023-06-01，请以 Anthropic 官方文档 为准，勿擅自修改为其他值。

第六步：接入 Claude Code / Cline

Claude Code 配置

Claude Code 原生支持 Anthropic API。以下配置方式供参考，具体支持的字段和路径请以 Claude Code 官方文档 为准。

在项目根目录的 .claude/settings.json 中配置（字段支持情况请核对官方文档）：

{
  "apiKey": "sk-ant-xxx",
  "model": "claude-opus-5"
}

或使用环境变量：

export ANTHROPIC_API_KEY="sk-ant-xxx"

如需通过聚合网关接入，可额外设置：

export ANTHROPIC_BASE_URL="https://api.ofox.io/v1"

⚠️ ANTHROPIC_MODEL 等非标准环境变量是否被 Claude Code 原生识别，请以官方文档为准，此处不作断言。

重启 Claude Code 后生效。

Cline 配置（VS Code 插件）

打开 Cline 设置面板：

1. API Provider 选 OpenAI Compatible（走聚合网关）或 Anthropic（直连）
2. Base URL 填聚合网关地址或留空（Anthropic 直连）
3. API Key 填对应平台的 Key
4. Model ID 填 anthropic/claude-opus-5（聚合网关）或 claude-opus-5（直连）

保存后可让其修改一个文件，验证是否有响应。

Codex CLI 配置

export OPENAI_API_KEY="your-key"
export OPENAI_BASE_URL="https://api.ofox.io/v1"
codex --model anthropic/claude-opus-5 "重构这个函数"

不同场景怎么选

场景	推荐方案	原因
个人开发者快速原型	Python SDK + Anthropic 直连	配置最简单，5 行代码跑通
已有 OpenAI SDK 的项目	OpenAI 兼容协议 + 聚合网关	只改 base_url，不动业务逻辑
团队多人共用、需要用量审计	聚合网关（OpenRouter 等）	后台可查各成员 token 用量
Claude Code 写代码	Anthropic 直连	原生支持，配置最少
Cline 做 AI 辅助编程	聚合网关 + OpenAI Compatible	一个 Key 可切换 Opus 5 / gpt-5 / Sonnet 4.5
Serverless / Edge Function	原生 HTTP（无 SDK）	冷启动快，包体小

报错对照表

报错现象	原因	解法
401 {"type":"authentication_error","message":"invalid x-api-key"}	Key 错误或已过期	在 Console 重新生成，注意不要复制多余空格
400 {"type":"invalid_request_error","message":"max_tokens: field required"}	缺少 max_tokens	添加 max_tokens=1024，该字段为必填
404 {"type":"not_found_error","message":"model: claude-opus-5 not found"}	模型名拼写错误（可能原因之一：账号尚无该模型访问权限）	确认拼写为 claude-opus-5，并确认账号具有 Opus 级别访问权限
429 {"type":"rate_limit_error","message":"Number of request tokens has exceeded your per-minute rate limit"}	超出速率限制	降低并发，或升级 usage tier，或通过聚合网关自动负载均衡
Connection error / timeout	网络不通或 DNS 解析失败	检查网络连通性；或切换至聚合网关
Cline 里选了模型但无响应	Base URL 与 Provider 类型不匹配	选 Anthropic provider 时不填 base_url；选 OpenAI Compatible 时才需要填

404 错误示例——将 model 写成 claude-opus5（缺少连字符）时的返回：

anthropic.NotFoundError: 404
{"type":"error","error":{"type":"not_found_error",
"message":"model: claude-opus5 not found"}}

常见问题 FAQ

Q: Claude Opus 5 和 Opus 4.8 有什么区别？

Opus 5（model ID：claude-opus-5）是 Claude 第五代旗舰模型，属于大版本升级。如需了解两者的详细对比，请参阅 Anthropic 官方技术文档，以官方发布的信息为准。

Q: Opus 5 的 API 调用方式和之前有变化吗？

没有变化。请求结构、鉴权方式、SDK 用法完全一致，唯一的改动是将 model 字段从 claude-opus-4-8 改为 claude-opus-5。

Q: Opus 5 的定价是多少？

截至 2026 年 7 月官方未正式公布 Opus 5 定价。参考上代 claude-opus-4-8 为 input $15/M、output $75/M tokens（以 Anthropic 官方定价页 为准）。建议先小规模测试，待官方公布定价后再决定是否全量切换。

Q: 我用 Cline 配了 base_url 但一直报 401？

最常见原因是 Key 与接入方式不匹配：走聚合网关需使用对应平台签发的 Key；走 Anthropic 直连需使用 sk-ant- 开头的 Key。两套 Key 不通用。

Q: Claude Code 能用聚合网关吗？

可以。设置环境变量 ANTHROPIC_BASE_URL 指向聚合网关地址并配置对应 Key 即可。Claude Code 对 Anthropic 原生协议支持最完整，非必要建议优先使用直连方式。

Q: 一个 Key 能同时调 Opus 5 和 GPT-5 吗？

Anthropic 原生 Key 仅支持 Claude 系列模型。如需通过一个 Key 调用多家模型，需使用聚合网关。不同网关的定价策略不同，建议在使用前查阅各平台当前的费率说明。

小结

整个流程的核心是三件事：获取 API Key、填写正确的 model ID（claude-opus-5）、选择合适的接入方式。

两种接入方式的选择逻辑：Anthropic 直连配置最简单，适合 Claude Code 日常使用；聚合网关适合需要多模型切换或已有 OpenAI SDK 的项目，model 字段需加 anthropic/ 前缀。