8848AI 工具指南

已核验真实支持边界

故障排查

Codex 401 / 404 / 429 / 502 完整排障

按客户端、协议和 HTTP 状态码定位 Codex 接入故障。

✅ 完整排障流程

Codex CLI 教程 ↗查看 8848API 模型 →

8848API 信息

Base URL

https://api.884819.xyz/v1

API Key

控制台 → 令牌管理 → 添加令牌

协议要求

同时排查 Responses、Chat Completions 与 CC Switch 本地代理

第一步：先确定报错位置

Codex CLI：检查终端完整错误和 ~/.codex/config.toml。
桌面版：检查 CC Switch 请求日志、本地代理状态和 8848API 调用记录。
记录时间、模型名、HTTP 状态码和 request id。

按状态码排查

401

Key 未加载、填错、被禁用或环境变量未重开终端。

404

CLI 常见于 /v1/responses 不存在；桌面代理常见于协议/路径映射错误或 /v1 重复。

429

额度、并发或上游限流，等待后重试或换同类模型。

502 / 503 / 504

上游暂时不可用、代理转换失败或请求超时。先换模型测试，不要反复重装客户端。

Codex CLI 专项

wire_api = "responses"
Base URL 到 /v1 为止。
确认 env_key 对应变量存在。
用 codex exec "只输出 OK" 做最小测试。

桌面版 / CC Switch 专项

本地代理监听 127.0.0.1:15721。
API 协议按教程选择 Chat Completions，并开启路由映射。
应用路由中已开启 Codex。
完全退出桌面版后重启。

联系客服时提供

错误截图（遮住完整 Key）
发生时间和时区
模型完整 ID
request id
使用的是 CLI 还是桌面版