对谈一个 /v1，两个答案对谈中文路径把 npm 拦在门外对谈缓存没开，成本翻倍报错HTTP 401 · 配好了却仍然走官方端点报错HTTP 404 · 接入后立刻返回 404报错HTTP 429 · 并发稍高就被限流整合包v0.1.0 内部构建已就绪对谈一个 /v1，两个答案对谈中文路径把 npm 拦在门外对谈缓存没开，成本翻倍报错HTTP 401 · 配好了却仍然走官方端点报错HTTP 404 · 接入后立刻返回 404报错HTTP 429 · 并发稍高就被限流整合包v0.1.0 内部构建已就绪
今天最常踩的 6 个坑
进入报错字典 →每一条都带原始报错、原因判断与可复制的解法。共 7 条，其中 4 条会直接拦住安装。
HTTP 401claude-code
配好了却仍然走官方端点
系统里残留的 ANTHROPIC_API_KEY 抢先被读取，请求没走你配置的接入点。
解法 在配置里把 ANTHROPIC_API_KEY 显式置空字符串，不要删掉这个键 HTTP 404claude-code接入后立刻返回 404
Base URL 的 /v1 前缀写反了，两个客户端的规则正好相反。
解法 Claude Code：ANTHROPIC_BASE_URL=https://api.example.com（无 /v1） HTTP 429claude-code并发稍高就被限流
没有开提示缓存，或者重试没有退避。
解法 在接入源侧开 Prompt 缓存，并确认中转层原样透传 cache_control 标记，中转层一旦改写请求体，缓存全部失效，成本反而更高 ConnectionErroropenclaw客户端连不上接入点
端点不可达，多半是代理或网络环境问题，不是 Agent 本身坏了。
解法 先用 curl 验证端点本身通不通：curl -I https://api.example.com/v1/models MCP_TOOL_SEARCH_DISABLEDclaude-codeMCP 工具列表是空的
非官方接入点下，MCP 的工具检索默认关闭。
解法 在配置里加 ENABLE_TOOL_SEARCH=true model not foundcodex报模型不存在
客户端发的是官方别名，接入点没有同名模型。
解法 首选：在接入点侧接受官方别名并内部映射，这样客户端零配置主流 Agent
全部档案 →运行时要求、已知问题与接入配置都不一样。先看清你要装什么。
关于接入源
社区维护的模型接入点，优先支持提示缓存与 Responses 协议。
整合包里的默认配置指向社区认证接入源。它提供延迟、重试与缓存透传上的默认策略，也让我们能把踩过的坑攒成一个可共享的解法库。换你自己的 key 随时可用，接入源不是必需品。
本站不销售任何东西，也没有付费墙。