- 博客(13)
- 资源 (1)
- 收藏
- 关注
原创 Claude API 错误解析:error.type 会新增,状态码和类型也不是一一对应
自己写 HTTP 客户端调 Claude API 时,很多人会把错误响应反序列化成一个固定枚举:400 对应 invalid_request_error,500 对应 api_error,写个 switch 就完事。这样写平时没问题,等官方加了新的错误类型,或者某个状态码带回来的 type 和你预想的不一样,解析层会先崩,业务分支根本走不到。下面按官方 API errors 文档把几个容易踩的地方理一遍。
2026-11-16 09:10:07
186
原创 Claude API 返回 500:SDK 已经自动重试两次,外层重试和 request_id 该怎么处理
Claude API 偶尔返回 HTTP 500,很多人的第一反应是在外面再包一层重试循环。先别急着加,官方 SDK 自己就会重试,叠加之后实际请求次数会成倍增加。下面按官方 API errors 文档和 Python SDK 文档,把 500 的处理顺序理一遍。
2026-11-15 09:12:36
443
原创 Claude API 的 GET /v1/models:分页、lifecycle 过滤,以及怎么判断模型快退役了
代码里把模型 ID 写死,过一阵模型被弃用、再到退役,请求就开始报错。Claude API 有个 List Models 接口(),能直接查当前可用的模型和它们的生命周期状态。下面按官方 API Reference 的 List Models 页整理几个容易用错的地方。
2026-11-14 09:12:18
446
原创 Claude API 长任务报 timeout_error:什么时候改用 Message Batches,轮询和取结果要注意什么
调 Claude API 跑长任务,报或者连接中途断掉,常见的处理是把客户端超时调大再重试。官方文档给的方向不是这个:长请求,尤其预计超过 10 分钟的,用流式 Messages API 或者 Message Batches API。流式的用法之前写过,这篇只说 Batches:什么时候该用、怎么轮询、结果怎么对回去。下面的说法都来自官方 Errors 和 Batch processing 两页。
2026-11-13 09:11:32
1051
原创 Claude API 认证报错排查:Authorization 和 x-api-key、密钥过期、工作区 ID、浏览器直连
调 Claude API 时遇到 401 或者跟认证有关的 400、404,大多数时候不是密钥"被封"了,而是请求头、密钥类型、工作区或者调用位置有一处没对上。下面按官方文档 Authentication 和 API overview 两页的说法,整理一个排查顺序。
2026-11-12 09:11:05
327
原创 Claude Code 不按 CLAUDE.md 做事:先查这个文件到底有没有被加载
写了 CLAUDE.md,Claude Code 却像没看见一样,这种情况先别急着改措辞。官方文档里 CLAUDE.md 的加载规则有好几条,文件放的位置不对、在子目录里还没触发、或者被 AGENTS.md 的规则绕开了,内容根本不在上下文里,写得再清楚也没用。下面按官方文档 “How Claude remembers your project” 的说法,整理一个排查顺序。
2026-11-11 12:28:51
451
原创 换到新 Claude 模型后请求返回 400:assistant 预填、thinking 块和 thinking 参数三处校验
以前常见的写法是在messages{"role": "user", "content": "提取下面邮件里的姓名和邮箱,返回 JSON"},"error": {注意判断条件是"最后一条消息是 assistant"。多轮对话里有历史 assistant 消息是正常的,只要当前请求以 user 消息结尾就行。
2026-11-10 09:11:46
498
原创 Claude API 长输出请求:用 stream + get_final_message() 拿完整结果,以及几个容易漏的地方
把max_tokens调大以后,直接用发非流式请求,Python SDK 可能会直接拒绝。官方文档的说法是:SDK 会校验非流式 Messages 请求,预计会超过 10 分钟超时的不让发;对max_tokens很大的请求,SDK 要求走流式,避免 HTTP 超时。很多场景其实并不需要逐字显示,只想要一个完整结果。SDK 为这种情况留了一个现成的办法。
2026-11-09 09:11:52
466
原创 Claude count_tokens 计数接口:哪些输入会直接报错,结果为什么和账单对不上
想在调用 Claude 之前先知道这次请求有多少输入 Token,官方给的办法是。它接受和创建消息基本一样的参数,返回一个。用起来不复杂,但有几处细节不注意就会踩坑。
2026-11-08 23:47:20
323
原创 Claude API 返回 429,请求数明明没超:可能是 OTPM,也可能是月度上限
用 Claude API 跑批量任务时,遇到 429 第一反应往往是去看请求数。请求数没超、输入也不多,还是 429,这时候要往另外几个方向查。
2026-11-07 19:17:02
566
原创 Claude 登录提示 There was an error logging you in:官方的排查顺序
登录 Claude 时看到 “There was an error logging you in”,这是一条通用报错,本身不说明原因。Anthropic 帮助中心给了一个排查顺序,照着走,比反复刷新或者重新注册省事。
2026-11-02 09:09:40
189
原创 Cursor 提示 suspicious activity 怎么办:按这四步查
Cursor 报,意思是请求被当作安全措施拦下了,官方帮助页提到 VPN 有时会触发它。官方没有说反复重试有帮助。按下面的顺序来,一次只改一项,每改一项就发同一条短请求对比。
2026-11-01 18:41:33
141
原创 Claude 订阅被停用后,重新付款前先做这三件事:退款、申诉、自查
Claude 订阅被停用后,先别急着重新付款:按付款渠道核对退款方式,再看官方写明的申诉入口,最后做重新订阅前的一致性自查。区分官方明确写出的内容与社区经验,不承诺任何解封结果。
2026-10-17 18:30:58
347
空空如也
TA创建的收藏夹 TA关注的收藏夹
TA关注的人
RSS订阅