Agent 排障指南

LangChain Agent 循环调用和 Token 暴涨怎么办？

LangChain Agent Token 暴涨常见于工具循环、检索结果过大、停止条件缺失和重试失控，需要从日志和预算阈值定位。

Codex 调用模型失败怎么排查？从 API Key、模型名和网关日志定位

Codex 调用模型失败时，应先做最小复现，再检查 API Key、base URL、模型名、权限、预算、网络和 MoxAI 网关日志。

n8n OpenAI 或 Claude 节点失败怎么查？从凭据、限流和重试策略定位

n8n OpenAI 或 Claude 节点失败时，要先拆出单节点复现，再检查凭据、base URL、模型名、429、超时和重试策略。

Claude Code 认证失败怎么排查？从 Key、环境变量和组织权限开始

Claude Code 认证失败时，先用最小请求确认 Key 和组织权限，再排查终端环境变量、代理、模型名和网关日志。

Dify 工作流调用超时怎么办？从节点耗时、模型限流和重试策略排查

Dify 工作流超时通常来自节点链路过长、检索结果过大、模型响应慢、限流或重试策略不当，需要拆节点排查。

Cursor 自定义 API Base URL 不生效怎么办？从请求路径和模型路由排查

Cursor 自定义 API Base URL 不生效时，要先确认请求路径、模型名、BYOK 设置、内置模型路由和网关日志。

Claude Code 提示认证失败怎么办？从 API Key、权限和环境变量排查

Claude Code 认证失败通常来自 Key 来源、环境变量加载、组织权限、模型权限或终端会话未刷新。

n8n 调用 OpenAI 或 Claude 节点失败怎么办？凭据、模型名和网关日志排查

n8n AI 节点失败常见原因是凭据未生效、模型名不匹配、base URL 配置错误、限流或工作流重试策略不当。

Dify 工作流调用超时怎么定位？节点耗时、模型响应和网关日志排查

Dify 超时通常来自节点执行时间、长上下文、外部工具、模型响应慢、反向代理或预算限流。

Cursor 自定义 API Base URL 不生效怎么办？从配置、模型名到日志排查

Cursor 自定义 Base URL 问题通常来自开关、模型兼容性、Key、模型名、缓存或供应商响应格式差异。