model字段必须填精确字符串不能用昵称。当前主力claude-sonnet-4-6轻量高频claude-haiku-4-5-20251001日期后缀必须完整旗舰推理claude-opus-4-8。当前全部可用 Model IDOpus 4 系列旗舰推理Model ID官方价 输入/输出ClaudeAPI 价 输入/输出说明claude-opus-4-8$5 / $25 /MTok$4 / $20 /MTok最新旗舰新项目首选claude-opus-4-7$5 / $25 /MTok$4 / $20 /MTok稳定在线版claude-opus-4-6$5 / $25 /MTok$4 / $20 /MTok稳定在线版长上下文强claude-opus-4-5-20251101$5 / $25 /MTok$4 / $20 /MTok版本锁定 ID一致性强Sonnet 4 系列主力均衡Model ID官方价 输入/输出ClaudeAPI 价 输入/输出说明claude-sonnet-4-6$3 / $15 /MTok$2.4 / $12 /MTok最新主力90% 场景默认claude-sonnet-4-5-20250929$3 / $15 /MTok$2.4 / $12 /MTok版本锁定稳定版Haiku 4 系列轻量高频Model ID官方价 输入/输出ClaudeAPI 价 输入/输出说明claude-haiku-4-5-20251001$1 / $5 /MTok$0.8 / $4 /MTok⚠️ 日期后缀必须完整错误写法速查表❌ 你写的✅ 正确的报错原因claude-haiku-4-5claude-haiku-4-5-20251001model not found缺日期后缀claude-sonnet-4.6claude-sonnet-4-6model not found点号→连字符claude-opus-4.8claude-opus-4-8model not found点号→连字符claude-sonnet-4.5claude-sonnet-4-5-20250929model not found点号缺日期后缀Claude Sonnetclaude-sonnet-4-6invalid_request_error不能用显示名claude-sonnetclaude-sonnet-4-6model not found缺版本号两条规律全程用连字符不用点号有日期后缀的必须完整填写。OpenAI SDK 接入示例fromopenaiimportOpenAI clientOpenAI(api_keysk-xxx,base_urlhttps://gw.claudeapi.com/v1# 注意带 /v1)# 基础调用responseclient.chat.completions.create(modelclaude-sonnet-4-6,messages[{role:user,content:用 Python 写一个快速排序}],max_tokens2048)print(response.choices[0].message.content)# 流式输出streamclient.chat.completions.create(modelclaude-sonnet-4-6,messages[{role:user,content:写一篇关于 RAG 的技术文章}],max_tokens4096,streamTrue)forchunkinstream:ifchunk.choices[0].delta.content:print(chunk.choices[0].delta.content,end,flushTrue)Anthropic Native SDK 接入示例importanthropic# Anthropic Native SDK 接入 ClaudeAPI不带 /v1clientanthropic.Anthropic(api_keysk-xxx,base_urlhttps://gw.claudeapi.com# 注意不带 /v1)# 基础调用messageclient.messages.create(modelclaude-sonnet-4-6,max_tokens1024,messages[{role:user,content:解释 Python 的 GIL 是什么}])print(message.content[0].text)# 流式输出withclient.messages.stream(modelclaude-sonnet-4-6,max_tokens2048,messages[{role:user,content:写一篇关于 RAG 架构的技术文章}],)asstream:fortextinstream.text_stream:print(text,end,flushTrue)⚠️两种 SDK 的 Base URL 不同OpenAI SDKhttps://gw.claudeapi.com/v1带/v1Anthropic SDKhttps://gw.claudeapi.com不带/v1混用时一定分开配置否则报 404模型分层调用成本优化实战同一个 AI 应用里不同任务复杂度差异很大——全用 Opus 贵全用 Haiku 质量不够。分层路由是生产项目必备# 三层路由配置按任务复杂度MODEL_ROUTING{# 轻量任务格式化、路由判断、初筛 → Haikuformat:claude-haiku-4-5-20251001,route:claude-haiku-4-5-20251001,filter:claude-haiku-4-5-20251001,# 主力任务代码生成、内容撰写、数据分析 → Sonnetcode:claude-sonnet-4-6,content:claude-sonnet-4-6,analysis:claude-sonnet-4-6,# 旗舰任务复杂推理、长文档、多 Agent → Opusreasoning:claude-opus-4-8,legal:claude-opus-4-8,multiagent:claude-opus-4-8,}defget_model(task_type:str)-str:returnMODEL_ROUTING.get(task_type,claude-sonnet-4-6)# 默认 Sonnetdefrun_task(task_type:str,prompt:str)-str:modelget_model(task_type)respclient.chat.completions.create(modelmodel,messages[{role:user,content:prompt}],max_tokens2048)print(f[{task_type}] →{model})returnresp.choices[0].message.content成本对比ClaudeAPI 价格100 万 token 内容生成策略成本说明全用 Opus 4.8~$12最强最贵全用 Sonnet 4.6~$4.8主力均衡三层分层20% Opus / 60% Sonnet / 20% Haiku~$3.9节省 67%全用 Haiku~$1.2最省只适合轻量任务批量验证脚本上线前验证所有用到的 Model ID 都有效importhttpx,json API_KEYsk-xxxBASE_URLhttps://gw.claudeapi.com/v1# 你项目中用到的所有 Model IDMODELS_TO_CHECK[claude-opus-4-8,claude-opus-4-7,claude-opus-4-6,claude-opus-4-5-20251101,claude-sonnet-4-6,claude-sonnet-4-5-20250929,claude-haiku-4-5-20251001,]defget_available_models()-set[str]:resphttpx.get(f{BASE_URL}/models,headers{Authorization:fBearer{API_KEY}},timeout10)resp.raise_for_status()return{m[id]forminresp.json()[data]}availableget_available_models()print(f✅ 当前可用模型数{len(available)}\n)formodel_idinMODELS_TO_CHECK:status✅ 可用ifmodel_idinavailableelse❌ 不可用检查 ID 或联系支持print(f{model_id:45s}{status})环境变量与 CLI 别名# 写入 ~/.bashrc 或 ~/.zshrcexportANTHROPIC_BASE_URLhttps://gw.claudeapi.comexportANTHROPIC_API_KEYsk-xxxexportOPENAI_BASE_URLhttps://gw.claudeapi.com/v1exportOPENAI_API_KEYsk-xxx# 快速测试别名aliasclaude-testcurl -s $OPENAI_BASE_URL/chat/completions \ -H Authorization: Bearer $OPENAI_API_KEY \ -H Content-Type: application/json \ -d {\model\: \claude-sonnet-4-6\, \messages\: [{\role\: \user\, \content\: \hi\}], \max_tokens\: 10} \ | python3 -m json.toolaliasclaude-modelscurl -s $OPENAI_BASE_URL/models \ -H Authorization: Bearer $OPENAI_API_KEY | python3 -m json.toolCLI 别名踩坑症状原因解法401同时设了ANTHROPIC_API_KEY和OPENAI_API_KEY库优先读错了统一用OPENAI_API_KEY或代码里显式传api_keyAnthropic SDK base_url 报错ANTHROPIC_BASE_URL不带/v1OpenAI SDK 需要带/v1两个环境变量分开设PowerShell alias 不生效PowerShell 没有 alias 命令用function claude-test { ... }写入$PROFILE写在最后新项目选型不用纠结三步走默认claude-sonnet-4-6先跑起来某类任务质量不够 → 切claude-opus-4-8有明显轻量任务补全/格式化→ 切claude-haiku-4-5-20251001Model ID 填错是最常见的接入问题碰到model not found先对照本文速查表逐字检查。如果需要查看持续更新版本参考 ClaudeAPI 官网原文。
