Claude Code command not found：Windows、macOS 与 PATH 修复
Claude Code command not found 发生在模型请求之前。先检查安装文件是否存在，再修当前终端的 PATH；同时确认 CLI、编辑器扩展和 WSL 环境，避免把启动错误当成 API Key 问题。
查看检查与修复步骤正在打开页面…
正在加载内容，请稍候。
Error Fix Hub
AI 工具 API 连接与报错排查
围绕 Claude Code、opencode、Cursor、Codex、Cherry Studio、Trae 六个高频工具，按错误信息定位 API Key、Base URL、模型名和限流问题。
安装、图片与任务恢复问题
GPT Image 2 图片编辑失败：上传、超时、结果与尺寸排查
GPT Image 2 图片编辑失败要区分上传、接口响应、结果保存和视觉验收。先保存请求与响应记录；超时或本地保存失败不表示上游没有执行，HTTP 成功也不表示商品细节符合要求。
查看检查与修复步骤
CC Switch 本地代理连接失败：127.0.0.1、WSL 与路由检查
CC Switch 本地代理连接失败先查发请求环境的本地监听，再查看路由日志与上游响应。WSL、SSH 和容器中的 127.0.0.1 不自动等于桌面宿主机；连接拒绝和 HTTP 401、400、502 分开定位。
查看检查与修复步骤
Codex 任务中断怎么办：工具失败、断流与恢复检查
Codex 任务中断怎么办，先保存会话和错误，再检查 git diff 与目标文件。工具可能已经执行、文件可能已修改；确认本地失败或请求状态后，从已完成步骤继续，避免重复外部操作。
查看检查与修复步骤
unsupported_parameter 修复：temperature、max_tokens 与协议
unsupported_parameter 先保存 error.code、type、param 和最终端点，再缩减成该协议的最小请求。一次只恢复一个字段，核对型号与通道；Chat 和 Responses 的参数不能混填。
查看检查与修复步骤
context_length_exceeded：历史、RAG 与输出预算怎么修复
context_length_exceeded 先统计实际发送的历史、RAG 和工具结果，再为生成与推理留预算。减少重复资料并核对真实窗口，降低输出上限不能让已超限输入自动通过；修复后还要检查回答完整性。
查看检查与修复步骤
n8n AI Agent 多行串数据：子节点第一项、配对与 row_id
n8n AI Agent 多行串数据先看动态表达式是否放在只读取第一项的子节点。业务文本在根节点逐项构造，必要时每次循环一行；保留 row_id 与配对信息，按业务身份校验结果。
查看检查与修复步骤
Seedance 视频生成失败：400、超时与 task_id 排查
Seedance 视频生成失败先确认是否已有 task_id：有 ID 就查询原任务，没有 ID 的 POST 超时先核对历史。400 检查参数与素材，succeeded 后的下载和画面问题转入成片验收。
查看检查与修复步骤
invalid_image_url 怎么修复：图片 URL、Base64 与协议字段
invalid_image_url 先检查服务器能否读取图片地址，以及 Base64 是否包含完整 data URL 前缀。file:// 本地路径、HTML 页面和失效地址都要排除，再按实际协议核对图片字段与视觉能力。
查看检查与修复步骤
tool_call_id 错配怎么修复：完整工具历史与并行结果
tool_call_id 错配先保留原 assistant.tool_calls，再将每个实际工具结果用对应 ID 回传。并行提案必须补齐结果；错误也按协议回传，不能编造 ID 或输出来消除报错。
查看检查与修复步骤
API 协议混用怎么修复：Chat、Responses 与 Messages 对照
API 协议混用要同时核对端点、请求体、鉴权、响应解析和历史。Chat 的 messages、Responses 的 input 与 Messages 的多模态及工具字段不同，相同模型名称不表示协议可以互换。
查看检查与修复步骤
高频报错入口
先覆盖最容易带来搜索流量和转化的报错词：API Key、Base URL、provider、模型名、限流。
Claude Code API Error 429：限流、用量上限与退避
Claude Code API Error 429 先看错误正文和响应头，区分请求速率、token 速率、用量上限与网关限制。暂停重复任务，保留请求 ID；临时限流按返回信息退避，用量上限则处理额度或等待明确恢复时间。
查看报错修复
Claude Code API Error 401：令牌、登录与网关地址
Claude Code API Error 401 优先检查当前进程读取的鉴权来源、令牌状态和 ANTHROPIC_BASE_URL。Key 与目标网关必须匹配；检查旧登录和配置覆盖，重启 CLI 后核对一条 Messages 请求。
查看报错修复
Cursor Unable to reach the model provider：请求链路排查
Cursor Unable to reach the model provider 先记录版本、模式、Provider 和错误全文，再比较同 Key、模型与协议的最小请求。Cursor 的请求链路与本地终端不同；分别检查后端可达范围及自定义 Key 的功能限制。
查看报错修复
OpenCode AI_APICallError：状态码、Provider 与协议
OpenCode AI_APICallError 是外层错误名称，先展开状态码、responseBody、请求路径和 provider/model。根据底层原因修复鉴权、协议或参数；短文本成功后再验证读取文件、修改与测试，不把它写成全部 Agent 功能通过。
查看报错修复
Cherry Studio fetch models failed：模型列表与状态码
Cherry Studio fetch models failed 先查看模型列表请求的状态码，分别排查鉴权、根地址、代理和列表接口。手动添加准确模型只能替代列表发现步骤；仍需单独验证真实聊天，不能修复无效 Key。
查看报错修复
Trae model request failed：完整 URL 与协议检查
Trae model request failed 先检查完整 URL 开关、API 格式、Key 和实际请求端点。OpenAI Chat 与 Anthropic Messages 分开配置，保存错误正文再对照平台记录；连接校验与真实聊天分别验证。
查看报错修复
按工具查找
n8n AI 工作流
排查 AI Agent 多条数据、子节点第一项和 pairedItem 配对问题，让每个输入与自己的结果对应。
1 个报错修复
OpenAI 兼容 API
按错误字段排查参数不支持、上下文超限和协议差异，先构造最小请求再恢复业务参数。
5 个报错修复
Seedance 视频
区分创建失败、生成失败和本地未知状态，保存任务 ID 后查询原任务并核对实际费用。
1 个报错修复
CC Switch
CC Switch 本地代理、端口与配置接管问题：先核对本机服务，再检查实际 API 请求路径。
1 个报错修复
Claude Code
Claude Code 常见 API Key、Base URL、限流和模型名报错修复。
6 个报错修复
opencode
opencode 终端调用模型时的 provider、auth.json 和模型配置报错修复。
4 个报错修复
Cursor
Cursor 自定义模型、OpenAI 兼容接口和 provider 连接失败报错修复。
4 个报错修复
Codex
Codex CLI 的 API Key、config.toml、auth.json 和 provider 报错修复。
5 个报错修复
Cherry Studio
Cherry Studio 添加模型、拉取模型列表和 Base URL 配置报错修复。
4 个报错修复
Trae
Trae Builder 自定义模型、API Key 和 Base URL 报错修复。
4 个报错修复
Chatbox
连接失败、模型列表为空与会话模型未切换
1 个报错修复
WorkBuddy
自定义模型保存失败、工具调用失败与模型选择
1 个报错修复
酒馆 SillyTavern
连接失败、无回复与角色卡上下文超限
1 个报错修复
Open WebUI
模型不显示、Docker 连接失败与用户权限
1 个报错修复
Continue
config.yaml 加载失败、密钥读取与 Agent 能力
1 个报错修复
Kilo Code
Provider API 选错、模型发现失败与工具调用
1 个报错修复
Qoder
自定义模型验证失败与 IDE、CLI 配置差异
1 个报错修复
VS Code
扩展连不上、环境变量未继承与远程开发
1 个报错修复
Hermes Agent
Custom endpoint、模型切换与运行环境
1 个报错修复
通用排查顺序
01
先看请求有没有到达后台
apizt 后台没有请求记录时，优先查 Base URL、网络代理、provider 类型和本地配置是否生效。
02
再看返回码和模型名
后台有请求记录但失败时，重点看 401、429、404、model not found、provider error 这类返回信息。
03
最后处理工具缓存
Claude Code、Cursor、opencode、Codex 都可能读取旧配置，保存后建议重启工具或重新打开终端。
六个工具的配置差异
- Claude Code 通常使用 https://api.apizt.com，不要直接套 OpenAI 兼容工具的 /v1 配置。
- WorkBuddy 使用完整请求地址；TRAE 需核对完整 URL 开关；其他工具按所选协议核对地址，不能统一套用 /v1。
- 遇到 model not found，核对平台实际授权的模型 ID 和接口协议，不要随意替换成另一个模型。
- 遇到 429 或 overloaded，先停掉 Agent 自动重试，拆小任务后再跑。
