Agent 排障指南

Codex 调用模型失败或返回空响应，如何从 Key、模型和日志排查？

Codex 调用模型失败或返回空响应时，不要只重启工具；先检查 Key、模型名、base URL、状态码、上下文长度、预算和网关日志。

n8n OpenAI 节点 429 后不重试，应该如何定位和修复？

n8n OpenAI 节点遇到 429 后不重试时，要同时检查节点重试设置、上游限流、并发、队列、模型额度和网关日志。

Cursor 自定义 API Base URL 不生效或 Agent 模式报错怎么修？

Cursor 自定义 API Base URL 不生效时，要区分 Ask 模式、Agent 模式、Responses API 格式、HTTP 兼容性和网关支持范围。

Dify 工作流调用超时或重试不生效，应该如何排查？

Dify 工作流超时或重试不生效时，要同时检查节点超时、环境变量、模型并发、网关日志和预算熔断，避免盲目提高重试次数。

n8n 导入 AI 生成工作流报错，如何修复 JSON 和节点字段？

n8n 导入 AI 生成工作流失败时，先验证 JSON、节点类型、字段结构、凭据占位和版本兼容，再逐段导入定位问题。

Claude Code 认证失败或模型不可用，应该怎么排查？

Claude Code 认证失败或模型不可用时，要先拆开 Key、组织权限、模型名、网络、网关路由和调用日志逐项检查。

n8n 导入 AI 生成工作流报错，如何修复 JSON 和节点字段？

n8n 导入 AI 生成工作流失败时，先验证 JSON、节点类型、字段结构、凭据占位和版本兼容，再逐段导入定位问题。

Claude Code 认证失败或模型不可用，应该怎么排查？

Claude Code 认证失败或模型不可用时，要先拆开 Key、组织权限、模型名、网络、网关路由和调用日志逐项检查。

n8n OpenAI 或 Claude 节点 401、429、timeout 失败怎么修？

n8n AI 节点失败时，要把鉴权、base URL、模型名、限流、超时、重试和节点日志拆开排查，避免一次失败拖垮整条工作流。

Cursor 或 Claude Code 提示 429 限流时怎么排查？

Cursor 或 Claude Code 出现 429 时，不要盲目重试；先看并发、模型额度、网关日志、重试策略和项目预算是否触发限制。