排错与工具

报错排查

Claude Code、Codex CLI 常见报错按原文收录：先给一句话结论，再给成因、验证命令和修法。每条结论都在本地实测过，标注了实测版本和日期。

配了 API Key，Claude Code 还是提示 Not logged in · Please run /login

这句提示有两个来源。如果敲完命令 1 秒内就出现，是 Claude Code 根本没读到 Key，一个请求都没发出去；如果等了 3 分钟左右才出现，是 Key 发出去了，但服务端返回 401，Claude Code 重试 10 次后才放弃。两种情况的修法不同。

先看状态码。429 是短时间内请求太多或太密，等几十秒到几分钟就能恢复，Claude Code 会自己重试；400 加「用量已达上限」是额度窗口用完了，要等到提示里写的重置时间，重试没有用。

这次请求的总 token 数超过了模型的上下文上限。总量等于对话、系统提示、工具定义、附件四部分相加，对话很短也可能超。先用 /context 看哪部分最大：对话长就 /compact 或 /clear，工具定义大就关掉用不到的 MCP 服务器，确实需要大上下文就换 1M 上下文的模型。

当前计划的 5 小时或每周用量窗口用完了，等到提示里 try again at 后面的时间就会恢复。提示里「升级 Pro、去 chatgpt.com 买额度」这几句是 Codex CLI 写死的文案，用第三方端点时不适用，应该去你实际订阅的服务那里查额度、升级。