问题库
Claude Code 配置第三方 API 后出现 404 或协议错误
优先核对服务地址和 Anthropic Messages 兼容性。地址路径与请求协议都应以供应商文档和实际返回为依据。
快速回答
优先核对服务地址和 Anthropic Messages 兼容性。地址路径与请求协议都应以供应商文档和实际返回为依据。
配置排查参考；以当前工具版本和供应商文档为准。
适用系统：macOS / Windows / Linux
配置 / 兼容问题
按文档核对服务地址
检查供应商给出的基础地址是否包含指定路径，不要凭经验重复添加 /v1 或请求端点。比较实际配置与文档时，同时检查协议、域名和路径。
确认 Messages 协议兼容
Claude Code 与普通 Chat Completions 调用的请求格式不同。上游原生支持 Anthropic Messages 时可以直接连接；其他协议需要适配的转换配置。
确认预设与当前供应商匹配，然后用新的请求测试。若仍失败，根据实际错误区分路径不存在、模型不存在和请求格式不兼容。