- 博客(31)
- 收藏
- 关注
RSS订阅原创 Claude Code 遇到 529 overloaded_error？用 --fallback-model 切换备用模型实测
已确认是 529，没有把 500/429 混入；主模型和备用模型 ID 都来自当前 Provider 的真实模型列表或文档；使用--print，并显式传入--model与；成功必须同时有模型切换、固定文本和退出码 0；主备都失败时有最大等待、最大尝试和停止信号；日志只留状态、脱敏 request-id 与模型 ID，不输出凭据和用户数据；回环结果只写成本机当前版本实测，不外推线上稳定性。
2026-09-04 12:48:03
349
原创 Chatbox 1.22.3 换机导入后服务商不能用？先检查 Settings 和 API KEY
Chatbox 1.22.3 换机后自定义服务商不能用，先不要同时改 Host、Key 和模型。第一步只读，确认 ZIP v2 和setting；第二步按导出时是否勾选判断 credential 缺失是不是预期；第三步让导入器完成 size/SHA-256 校验并 relaunch；第四步回读 Provider、API Host 和模型 ID，安全恢复凭据后做一次最小对话。把“设置迁移”和“凭据恢复”拆开，既能减少误判，也能避免为了排错把真实 Key 暴露在终端、截图或公开内容中。
2026-08-31 17:39:28
350
原创 OpenAI Python SDK 报 CERTIFICATE_VERIFY_FAILED？给 httpx 指定 CA，不要 verify=False
只是 SDK 的外层包装，真正要看的通常是。如果底层是，优先给 HTTPX 一个明确的 CA 文件或。会让测试请求通过，却同时关闭证书验证，不应该作为生产修复。
2026-08-11 11:41:21
357
原创 Claude Code 配 ANTHROPIC_BASE_URL 后 404？检查 /v1/messages 是否重复
Claude Code 配自定义 Anthropic 端点遇到 404 时，先确认请求路径，再换模型或 Key。对当前2.1.219，根 Base URL 会生成；Base URL 末尾再加/v1会生成，夹具返回 404。把配置收敛到一个 settings source，用做最小复现，并以访问日志中的真实路径作为成功信号，才能把路由错误和模型、认证问题分开。
2026-08-11 11:41:05
385
原创 LiteLLM 1.95.0 启动报 get_flat_dependant ImportError？锁定 FastAPI 0.136.3
本文解决一个很具体的启动故障：在 Python 3.11 虚拟环境里安装后，执行我实测的环境是 macOS arm64、Python 3.11.15、LiteLLM 1.95.0。当前可复现的最小修复，是把 FastAPI 从自动解析到的 0.141.1 固定为 0.136.3，然后用pip check、Proxy 启动和本地回环请求逐层确认。用于继续验证的最小配置位置是你启动命令显式传入的文件，例如当前目录的这里的地址和密钥都只用于本地夹具，不是线上服务配置。$(pwd成功日志应出现。
2026-08-07 12:24:58
323
原创 OpenAI Python SDK 429 后又断流？按 Retry-After 与 finish_reason 分层
OpenAI Python SDK 遇到 429 后又流式中断时，先按阶段拆开：429 发生在可用响应体之前，符合条件时由 SDK 按有限重试；HTTP 200 后已经收到部分 SSE 再断开，则要按响应体不完整处理，不能假设会自动重放。把实际请求次数、、调用方 request ID、最后文本和放在同一条记录里，才能避免重复请求，也避免把半段答案写成成功。
2026-08-06 12:50:13
386
原创 Cherry Studio 检测 API Key 报 401？同一路径做 401/200 对照定位
Cherry Studio 的 Custom Provider 报 401 时，先固定同一个/v1/models路径，只改变鉴权，得到一组可比较的 401/200 信号。认证没有通过前不换模型；认证通过后再检查 Model ID、聊天路径和请求体。这样可以把 Key、Base URL、模型和协议拆开处理，避免一次改四个字段后仍然不知道是哪一层出了问题。
2026-08-03 14:32:18
378
原创 Dify OpenAI 兼容模型报 502/超时？先把插件调用层和 Nginx 部署层分开
Dify 配置 OpenAI-API-compatible 模型后出现 502 或 timeout，先做分层，不先调参数。第一步用 compose 状态和容器内/health证明 Dify API；第二步直连精确的；第三步保留上游请求标识；第四步用 connect timeout、总耗时和首包信号区分超时阶段。只有 Dify 自身健康失败时，才优先查 Nginx、API 容器和依赖；Dify 健康而模型端点 502 时，应转向模型服务或其代理。
2026-08-03 14:31:57
360
原创 Codex CLI 报 wire_api=“chat“ 不再支持？改为 Responses 并验证 /v1/responses
Codex CLI 0.144.1 读取旧 config.toml 时，wire_api="chat" 会在联网前直接失败。本文给出用户级配置位置、最小 Responses 配置、删除字段使用默认值的替代修法，并用脱敏回环夹具实测两种有效配置都会 POST /v1/responses、stream=true，最终返回 CODEX_WIRE_OK。
2026-07-31 12:25:19
889
原创 Chatbox 1.22.1 获取不到模型？先验 /models，再对齐精确 model ID
Chatbox 1.22.1 的自定义 OpenAI 兼容服务中，Fetch 会请求 API Host 下的 /models，并从 data[].id 建立模型列表。本文用本地夹具复现“HTTP 200 但没有 data”“友好名称导致 model_not_found”和精确 ID 成功三条分支，并说明 Check 可能继续发送图像与工具调用测试。
2026-07-29 19:57:24
369
原创 Dify OpenAI-Compatible 插件报 model_not_found：校准 Base URL 与模型 ID
Dify 的 OpenAI-API-compatible 插件保存自定义模型时报 model_not_found，问题常在界面模型名与 API endpoint 模型名没有对齐。本文基于官方插件 0.0.55 的字段和源码，先查 /models，再用 404/200 最小请求确认 Base URL 与精确模型 ID；本地实测不冒充完整 Dify 或线上模型调用。
2026-07-28 15:37:11
376
原创 Cline 配置 OpenAI Compatible 前怎么验证？先查 Base URL、/models 与模型 ID
Cline 填写 OpenAI Compatible 的 Base URL、API Key 和 Model ID 前，先用 /models 与最小聊天请求把端点、模型目录和协议分开验证。本文依据 Cline v4.0.11 官方文档和源码，使用本地 fixture 复现错误模型 404、正确模型 200，并明确没有执行线上 provider 或本机 Cline 客户端请求。
2026-07-27 18:47:22
310
原创 OpenAI Python SDK 遇到 502/503 怎么排？先看自动重试、request_id 与 timeout
OpenAI Python SDK 遇到 502/503 或超时时，不要在 SDK 外再盲目套重试。本文锁定 openai 2.48.0，以本地 fixture 实测默认两次自动重试后成功、max_retries=0 首次 503 即失败、失败 request_id 回读和 APITimeoutError，并给出避免重试放大的排查顺序。
2026-07-27 18:47:00
433
原创 Anthropic Python SDK 报 400：把 system 从 messages 移到顶层修正
Anthropic Python SDK 调用兼容接口报 400 时，先检查 system 是否被错误放进 messages；本文用 0.64.0 和本地 HTTP 夹具复现错误 400、修正后 200，并给出最小请求与结构排查路径。
2026-07-26 13:13:51
324
原创 Claude Code 配置 settings.json 后报 401？按 Base URL 与鉴权变量修正
Claude Code 已写入 settings.json 仍报 401 时，先确认变量是否放在 env、Base URL 是否指向 Anthropic Messages 根地址，再区分 ANTHROPIC_AUTH_TOKEN 的 Bearer 与 ANTHROPIC_API_KEY 的 X-Api-Key。本文以 Claude Code 2.1.219 访问本地 fixture，复现错误鉴权 401 和正确配置 200，并给出失败路径。
2026-07-26 13:13:40
435
原创 OpenCode 配置 Base URL 后报 model_not_found？用 opencode.json 和 /v1/models 修正模型 ID
OpenCode 配置 OpenAI 兼容接口后出现 model_not_found？本文用 OpenCode 1.18.4 复现 Base URL、/v1/models、精确模型 ID 和流式请求的排错链路，给出可复制配置、成功信号与路径 404/认证失败的区分方法。
2026-07-25 16:16:32
553
原创 Codex CLI 401 怎么定位？先证明 config.toml 真的被读取
Codex CLI 接入 OpenAI 兼容接口后返回 401，先别换 Key。本文用一个最小配置和 /v1/models 检查，把没读到配置、provider 选错、Base URL 拼错、环境变量为空、模型名不对拆成可验证的五步，并给出每一步的成功信号。
2026-07-24 12:46:40
344
原创 Cursor 接 OpenAI 兼容 API 后 401？按 settings.json、Base URL、模型名和认证方式定位
Cursor 接 OpenAI 兼容 API 后出现 401 时，先从当前版本设置页打开 settings.json，核对 Base URL 和模型 ID，再用 /v1/models 与最小对话请求区分认证、路径和模型问题。本文提供脱敏本地 401/200 对照。
2026-07-24 12:46:20
425
原创 Codex CLI 报 model_not_found？用 config.toml、/models 和真实模型 ID 逐层定位
Codex CLI 配好自定义 provider 仍提示 model_not_found，先确认 ~/.codex/config.toml、Base URL 和 wire_api，再从 /v1/models 复制真实模型 ID，最后用最小请求区分模型不存在、重复 /v1 和认证问题。本文以 Codex CLI 0.144.1 为范围，并明确本地夹具与线上 provider 的边界。
2026-07-24 12:45:29
527
原创 Codex 安装/换肤后下一步：用 CodeLink 完成首次真实调用（CLI 实测）
很多人装好 Codex、甚至换完皮肤后，仍没完成第一次真实模型调用。本文先区分 Codex CLI、Codex 桌面应用和 ChatGPT Desktop，再用 Codex CLI 0.144.1 的脱敏 doctor 回读与一次真实最小请求，证明自定义 provider 已加载、接口可达并返回预期结果，同时给出配置、失败分层和用量回读清单。
2026-07-23 23:27:45
599
原创 Cherry Studio 自定义 Provider 报 404/model_not_found？按 Base URL、/v1 和模型 ID 三步验证
Cherry Studio 自定义 Provider 报 404 或 model_not_found 时，先按官方字段顺序检查 Provider 类型和 API 地址，再用 /v1/models 获取真实模型 ID，最后用最小对话请求确认路径。文中给出可复制配置、成功信号、失败分层和本地脱敏夹具。
2026-07-22 12:48:02
712
原创 Dify 工作流遇到 429/Timeout 怎么排？按 Retry-After、首包/总耗时、重试上限和 Base URL 分层
Dify 工作流调用遇到 429、首字节超时或 HTTP 200 后流内失败时，先核对 /v1/workflows/run 的路径，再记录 Retry-After、首包时间和总耗时，最后用有上限的重试验证恢复，避免把网络超时误判成 Key 或模型问题。
2026-07-22 06:42:14
488
原创 从 Chat Completions 迁到 Responses API，发布前至少做这 7 个验收
把旧的 Chat Completions 代码迁到 Responses API，不是把 messages 改成 input 就结束。发布前至少验收资源路径、输入字段、文本读取、流式事件、工具调用、状态延续、网关兼容和回滚路径，避免把 200 请求误判成完整迁移成功。
2026-07-21 16:20:45
318
原创 AI 编程工具太多，API Key 怎么统一管理？先把 Cursor、Codex、Claude Code 分成两类协议
同时使用 Cursor、Codex、Claude Code、Chatbox、Cherry Studio 等 AI 编程工具时，不要把同一个 API Key 复制到每个配置页。先把工具分成 OpenAI-compatible 和 Anthropic Messages 两类协议，再分别记录 Base URL、环境变量、模型 ID、预检命令和轮换方式。
2026-07-21 16:20:34
388
原创 Chatbox API Path 填错后 404？先用 /models 区分 Base URL 和接口路径
Chatbox 自定义 OpenAI 兼容接口时，/models 能返回但对话请求 404，先核对 API Host、API Path 和模型名是否重复拼接。本文用本地 Python 夹具复现 /v1/v1/chat/completions 失败路径，并给出可复制的排查顺序。
2026-07-20 15:53:55
358
原创 Dify API Base URL 填到 /v1 后 404？先拆开 /v1/chat-messages
Dify API 返回 404 时，先不要换模型或重发 Key。本文按官方 API 路径复核 Base URL 与 /v1/chat-messages 的边界，用 /v1/info 做预检，再用本地回环夹具复现正确的 200 和重复 /v1 的 404，并补充自托管 Docker 的端口位置与失败分层。
2026-07-20 15:52:25
340
原创 Claude Code 报 model_not_found？在 settings.json 里映射模型排查
Claude Code 接入自定义 Anthropic 兼容端点后报 model_not_found，不要只换 Key。本文按 settings.json 作用域、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL 和默认模型映射逐层检查，并用 Claude Code 2.1.191 访问本地 loopback 夹具，复现错误模型 404 与正确模型 200 的分界。
2026-07-18 17:05:45
397
原创 API中转报401怎么办？检查Key、Base URL与轮换状态
API中转返回401时，按Base URL、Authorization请求头、Key状态和模型权限顺序排查。本文提供最小curl验证、Python日志脱敏以及Key轮换失败判断。
2026-07-17 14:28:45
329
原创 API中转返回200仍报错？检查choices和usage字段
API中转返回200但SDK仍报错时，如何检查choices、message.content和usage字段？本文提供可复制的JSON响应保存方法、Python契约检查器及401/429分流排查。
2026-07-17 14:27:37
302
原创 API 中转服务怎么测：OpenAI SDK 兼容性、流式输出与错误排查
本文提供一套可复现的 API 中转服务检查方法，涵盖 OpenAI SDK 兼容性、模型列表、流式输出、延迟测试、401/429/5xx 错误排查以及 API Key 安全边界。
2026-07-17 00:49:59
490
原创 Codex Desktop 换肤教程：Mac 与 Windows 安装、验证和恢复完整指南
本文介绍 Codex Dream Skin 的工作原理，以及 macOS 和 Windows 的安装、启动、交互验证与恢复方法。主题通过本机 CDP 注入，不修改官方 Codex 安装包，并说明使用时需要注意的安全边界。
2026-07-16 16:47:18
1911
2
空空如也
空空如也
TA创建的收藏夹 TA关注的收藏夹
TA关注的人