报错与踩坑汇总

按编号查找 Claude Code、Codex 和 claude-mem 常见问题，查看原因、修复步骤与预防措施。

点击编号进入详情。

Claude Code 本体

编号	现象	排查重点
CC-001	响应慢或卡住	先检查 Hooks、插件与后台 Worker 是否阻塞。
CC-002	401 / Invalid API Key	核对 Base URL、密钥及当前凭据来源。
CC-003	503 / model_not_found	核对模型名称、权限及当前可用范围。
CC-004	上下文超限或对话被截断	压缩历史、缩小输入或使用新会话。
CC-005	首次启动无法连接 Anthropic	检查启动环境、初始化流程与实际失败地址。
CC-006	400：实验性 Beta 参数不兼容	对照错误字段，临时禁用实验性 Beta 验证。
CC-007	401：IDE 或 MCP 配置冲突	比较启动环境、项目配置和插件安装后的改动。
CC-008	403 / Missing API Key	区分凭据未发送与账号、模型权限不足。
CC-009	API Error (Connection error.)	检查 DNS、TLS、代理及客户端到藕片 API 的链路。
CC-010	API Error (Request timed out.)	用短消息区分网络问题、长上下文和服务处理延迟。
CC-011	400：请求格式或参数错误	保留具体字段，用新会话排除历史消息影响。
CC-012	Overloaded / 500 / 529	查看对应调用状态，降低并发后再试。
CC-013	Command timed out：本机命令超时	检查本机进程、交互输入和命令耗时。
CC-014	413 / Invalid model name	分别检查请求体积与模型配置，不能混为同一原因。
CC-015	回复超过输出 Token 上限	拆分输出任务，核对客户端及模型上限。
CC-016	401：旧服务环境变量残留	检查终端、IDE 和系统中残留的连接变量。
CC-017	WebFetch 报错但网页能打开	区分工具权限、网络路径、预检与目标站限制。
CC-018	官方登录与 API Key 配置混用	核对登录状态，退出旧登录后重新验证 API 接入。
CC-019	429 / Rate Limit / insufficient_quota	按错误正文区分频率限制、余额及账号额度。
CC-020	Permission denied：操作被拒绝	分别检查系统权限、工具规则和管理策略。
CC-021	Invalid API Key format：密钥格式异常	从密钥页面重新复制，排除空格、换行和 OCR 错字。
CC-022	缓存重复写入与费用核对	按请求编号核对缓存用量，区分多轮调用与异常重复。
CC-023	Plan 模式无法执行（权限配置）	移除未经核实的字段，并检查模式和权限规则。
CC-024	400：messages[].role 不接受 system	核对客户端与端点的消息结构及 Beta 支持。

Codex

以下为 Codex 客户端排查，接口协议与模型能力以实际服务商为准。

编号	现象	排查重点
CD-001	此模型不支持图片输入	确认模型与服务支持图片，再核对模型目录能力。
CD-002	401：请求发往官方端点	检查供应商、Base URL 和旧会话配置。

claude-mem

编号	现象	排查重点
CM-001	pending_messages 积压与误删	先备份数据，修复模型和 Worker，再处理队列。
CM-002	Worker 假死导致客户端卡住	确认实际进程和端口，定向重启 Worker。

反馈问题

提供发生时间与时区、客户端版本、模型、完整错误及请求编号；截图中的真实 Key 请遮挡。可在使用日志查找对应调用。

Claude Code 的藕片 API Base URL 为 https://eopt.ai。连接配置见配置参考，费用问题见费用与用量。