运维与排错入门读者更新于
连接慢或请求失败时如何排查与恢复？
先看状态码和报错原文，再改地址。换备用域名解决不了 Key、模型和接入点的问题。
按现象处理
| 现象 | 先检查 |
|---|---|
| 401 | Key 是否完整、是否已轮换或禁用；环境变量是否在新终端里生效 |
| 403 / 模型不可用 | 接入点选择是否已为这个模型族保存；模型 ID 是否在能力目录里 |
| 429 | 请求太密。稍后重试，客户端加上退避，不要立刻连环重发 |
| 超时、连接重置、一直转圈 | 地址是否写成 https://api.icodeeasy.cc。仍慢再换成下面的备用域名 |
| Gemini 路径报 404 | GOOGLE_GEMINI_BASE_URL 只填域名，不要加 /v1beta |
备用域名，路径和 Key 保持原样：
https://jp.icodeeasy.cc
https://sg.icodeeasy.cc
要改的字段：Claude Code、GLM、MiniMax 是 ANTHROPIC_BASE_URL；Codex 是 base_url；Kimi Code CLI 是 base_url 且保留 /v1；Gemini CLI 是 GOOGLE_GEMINI_BASE_URL。
改完如何确认
用原客户端再发一句短对话。成功后打开请求日志，确认模型、状态和费用是这次请求。仍然失败时，把状态码和报错原文提交到工单，不要附带完整 API Key。
各客户端的完整配置见 Claude Code、Codex、Gemini CLI 和常见问题。
相关指南
常见问题
排查 API Key、401、429、Windows 环境变量、客户端连接与问题反馈等常见情况，快速定位配置或额度异常。
Claude Code 安装、API 配置与 Windows 排错
安装 Claude Code，配置自定义 API 地址与密钥，验证 Windows、macOS、Linux 环境变量，排查 401、403、429 和连接问题，并了解 Claude Desktop、Kimi 与 GLM 的配置入口。
Codex 安装与配置
安装 Codex CLI，使用 auth.json 保存 API Key，设置 I Code Easy provider 与 Base URL，并运行第一次 Codex 会话。