解决Codex调用自托管DeepSeek模型时API路径不匹配的完整方案 如果你在尝试将 Codex 连接到自托管的 DeepSeek 模型时,遇到了请求被错误地发送到/v1/responses端点,导致 Token 被不断消耗却无法获得有效回复的问题,那么这篇文章就是为你准备的。这是一个在社区中相当典型的配置问题,根源在于 Codex 客户端与 LiteLLM 代理服务器之间的 API 路径不匹配。简单来说,Codex 期望的 API 路径与 LiteLLM 默认暴露的路径不一致,导致请求“迷路”,从而触发一系列错误和无效的 Token 消耗。本文将直接切入主题,先解释问题现象和根本原因,然后提供一个经过验证的、一劳永逸的解决方案。我们不会停留在概念层面,而是会给出具体的配置步骤、验证命令以及一套完整的排查流程。无论你是想在本地开发环境集成,还是搭建一个稳定的内部服务,都能通过本文找到清晰的路径。1. 核心能力速览与问题定位在深入解决方案之前,我们先快速梳理一下整个技术栈的核心组件和当前面临的核心矛盾。组件角色与功能在本问题中的状态DeepSeek 模型目标AI模型,提供代码生成、对话等能力。可以是官方API或自托管版本。自托管,通过特定端口(如30000)提供类OpenAI API服务。LiteLLM通用AI模型代理层。它将不同厂商的API(如OpenAI、Anthropic、自托管模型)统一成标准的OpenAI API格式。已部署,作为中间代理,接收Codex请求并转发给自托管的DeepSeek。Codex (客户端)一个利用大模型进行代码辅助的工具/CLI。它按照OpenAI API规范发送请求。配置了指向LiteLLM代理的OPENAI_BASE_URL和OPENAI_API_KEY。问题核心Codex 发送请求的终点路径与 LiteLLM 转发的终点路径不匹配。Codex 试图访问/v1/responses,而 DeepSeek 服务或 LiteLLM 配置的终点是/v1/chat/completions。问题现象复现: 当你使用类似codex --provider openai --model deepseek-70b -q “Hello”的命令时,会在客户端看到404 litellm.NotFoundError错误,同时在 LiteLLM 的服务端日志中,会发现它试图访问一个https://your_model_ip:30000/v1/responses的地址并失败。根本原因: 某些 Codex 客户端版本或配置,可能会使用 OpenAI 的非标准或特定端点(如/v1/responses用于某些异步操作)。然而,标准的自托管模型服务(包括通过 LiteLLM 代理的)通常只暴露/v1/chat/completions或/v1/completions这样的标准端点。这个路径不匹配导致请求无法被正确处理,但鉴权可能已通过,从而造成 Token 被扣除或请求被计费。2. 适用场景与使用边界本解决方案主要适用于以下场景:开发者本地环境:希望在个人开发机上,使用 Codex 等工具调用本地或内网部署的 DeepSeek 模型,进行代码补全、解释或调试。团队内部服务:搭建一个内部 AI 辅助平台,让团队成员可以通过统一的 Codex 配置接入公司内网的私有模型。成本与隐私控制:避免直接使用昂贵的商用 API,或出于数据隐私考虑,需要所有请求在内部网络完成。使用边界与注意事项:模型授权:确保你部署的 DeepSeek 模型拥有合法的使用授权。如果是官方 API,请遵守其使用条款;如果是开源版本的自托管,请遵守对应的开源协议。网络安全:自托管服务通常在内网运行。如果需对外暴露,务必配置好防火墙、身份认证(如 API Key)和 HTTPS 加密,防止未授权访问和中间人攻击。性能考量:自托管模型的性能取决于你的硬件(GPU、内存)。对于大型模型(如 70B 参数),需要足够的显存和内存支持。功能完整性:通过 LiteLLM 代理接入,可能无法 100% 复现原始 API 的所有高级功能(如某些流式输出格式、特定参数)。需要以测试为准。3. 环境准备与前置条件在开始修复之前,请确保你的基础环境已经就绪。操作系统:Linux (Ubu

相关新闻

最新新闻

SerenityOS 命令行选项解析指南:getopt 与 getopt_long 用法、返回值与底层实现

SerenityOS 命令行选项解析指南:getopt 与 getopt_long 用法、返回值与底层实现

SerenityOS 命令行选项解析指南:getopt 与 getopt_long 用法、返回值与底层实现 【免费下载链接】serenity The Serenity Operating System 🐞 项目地址: https://gitcode.com/GitHub_Trending/se/serenity 导读 本文以 getopt(3) 手册 为核心&a…

2026/9/25 12:45:43
轻量服务器还是ECS?大促云服务器选购与避坑实战指南

轻量服务器还是ECS?大促云服务器选购与避坑实战指南

每年大促节点,群里永远有人在问同一个问题:“38元的轻量服务器到底怎么抢?为什么我每次点进去都是已售罄?68元直购和99元的ECS我到底选哪个?”作为一个常年帮团队和自己采购云服务器的老用户,我太清楚这种纠…

2026/9/24 14:25:52
为 AI 代理的 Review 动作编写 Cedar 审批门控策略:review-agent-governance 策略编写实战指南

为 AI 代理的 Review 动作编写 Cedar 审批门控策略:review-agent-governance 策略编写实战指南

为 AI 代理的 Review 动作编写 Cedar 审批门控策略:review-agent-governance 策略编写实战指南 【免费下载链接】agents Multi-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity 项目地址:…

2026/9/26 3:42:08
PaddleOCR 手写数学公式识别算法 CAN 实战指南:Counting-Aware Network 训练、评估与推理部署

PaddleOCR 手写数学公式识别算法 CAN 实战指南:Counting-Aware Network 训练、评估与推理部署

PaddleOCR 手写数学公式识别算法 CAN 实战指南:Counting-Aware Network 训练、评估与推理部署 【免费下载链接】PaddleOCR Turn any PDF or image document into structured data for your AI. A powerful, lightweight OCR toolkit that bridges the gap between i…

2026/9/23 8:01:38
Spring源码解析:构造器注入的类型转换与候选匹配机制

Spring源码解析:构造器注入的类型转换与候选匹配机制

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/26 4:08:27
openai-agents-python 多模型接入指南:深入解析 AnyLLMModel 适配层与 any-llm 路由

openai-agents-python 多模型接入指南:深入解析 AnyLLMModel 适配层与 any-llm 路由

openai-agents-python 多模型接入指南:深入解析 AnyLLMModel 适配层与 any-llm 路由 【免费下载链接】openai-agents-python A lightweight, powerful framework for multi-agent workflows 项目地址: https://gitcode.com/GitHub_Trending/op/openai-agents-pyth…

2026/9/25 15:49:36

日新闻

周新闻