API网关LLM 网关后端【免费下载链接】ccxClaude / Codex / Gemini API Proxy - CCX项目地址https://gitcode.com/gh_mirrors/cc/ccx点击查看免费下载DeepSeek 是当前 CCXClaude / Codex / Gemini API Proxy网关最常用的纯文本模型供应商之一。本指南基于仓库文档 docs/providers/deepseek.md 与源码实现系统讲解如何在 CCX 中通过OpenAI Chat/v1/chat/completions、Claude Messages/v1/messages与Codex Responses/v1/responses三种协议入口接入 DeepSeek包括渠道配置字段、模型映射规则、非标准 Chat role 规范化开关、视觉能力关闭与自动 failover以及配置验证与故障排查。读完本文你将能在单个 CCX 实例上同时服务 Claude Code CLI、Codex CLI/App 和任意 OpenAI 兼容工具并让图片请求自动绕过 DeepSeek 路由到视觉渠道。前置准备获取 DeepSeek API Key访问 DeepSeek 开放平台platform.deepseek.com注册并登录账号进入 API Keys 页面点击「创建 API Key」复制生成的密钥。该密钥将作为渠道的API Keys字段填入 CCX 管理界面。注意DeepSeek API Key 仅用于 CCX 与上游之间的认证客户端工具Claude Code / Codex / OpenAI 兼容工具使用的则是 CCX 自己的代理密钥PROXY_ACCESS_KEY两者不要混淆。提示PROXY_ACCESS_KEY通过环境变量注入默认值可在 backend-go/.env.example 中查看实际解析逻辑位于 backend-go/internal/config/env.go。若配置了EXTRA_PROXY_ACCESS_KEYS管理界面与代理 API 会采用独立的ADMIN_ACCESS_KEY认证。工作原理一个 CCX 实例承载三种协议CCX 通过协议入口隔离 上游端点映射的方式支持 DeepSeekClaude Code CLI ──→ /v1/messages ──→ CCX ──→ DeepSeek Anthropic 端点 Codex CLI/App ──→ /v1/responses ──→ CCX ──→ DeepSeek Chat 端点 OpenAI 兼容工具 ──→ /v1/chat/completions ──→ CCX ──→ DeepSeek Chat 端点从源码看这条双端点映射并非手写约定而是由内置模型清单固化下来的仓库 shared/builtin-models-manifest/builtin-models-manifest.json 为 DeepSeek 注册了两个 manifest 条目条目baseUrlPatternserviceTypeplanHintAnthropic 兼容api.deepseek.com/anthropicmessagesdeepseek_anthropicOpenAI 兼容api.deepseek.comopenaideepseek_openai也就是说Messages 入口的渠道应指向https://api.deepseek.com/anthropic而 Chat / Responses 入口的渠道应指向https://api.deepseek.com。一个 CCX 实例可以同时服务所有路径按需配置对应协议的渠道即可互不干扰。场景一OpenAI Chat 协议通用适用于所有兼容 OpenAI Chat 协议的工具例如各类 ChatBox、OpenCat、自研脚本、curl直连等。配置步骤进入 CCX 管理界面选择Chat入口点击「添加渠道」切换到详细配置模式填写以下信息字段值服务类型OpenAI Chat名称DeepSeek ChatBase URLhttps://api.deepseek.comAPI Keys你的 DeepSeek API Key模型白名单deepseek-v4-pro,deepseek-v4-flash保存。客户端配置任意 OpenAI 兼容客户端只需把 Base URL 指向 CCX 的/v1路径密钥换成 CCX 代理密钥export OPENAI_API_KEYyour-ccx-proxy-key export OPENAI_BASE_URLhttp://localhost:3000/v1场景二Claude Code CLIClaude Code CLI 使用 Anthropic Messages API。需要在Messages入口配置服务类型为Claude的渠道上游指向 DeepSeek 的 Anthropic 兼容端点。配置步骤进入 CCX 管理界面选择Messages入口点击「添加渠道」填写以下信息字段值服务类型Claude名称DeepSeek ClaudeBase URLhttps://api.deepseek.com/anthropicAPI Keys你的 DeepSeek API Key模型白名单deepseek-v4-pro,deepseek-v4-flash保存。模型映射推荐Claude Code CLI 默认使用 Claude 模型名如claude-opus-4-7发起请求而 DeepSeek 上游不认识这些名字。在渠道上配置模型映射让 CCX 自动把 Claude 模型名重定向到 DeepSeek 模型请求模型重定向到opusdeepseek-v4-prosonnetdeepseek-v4-prohaikudeepseek-v4-flash客户端配置export ANTHROPIC_API_KEYyour-ccx-proxy-key export ANTHROPIC_BASE_URLhttp://localhost:3000验证claude 你好⚠️注意ANTHROPIC_BASE_URL指向 CCX 网关根地址不要加/v1或/v1/messages。Claude Code 会在该地址基础上自行拼接 Messages API 路径若多写了/v1会导致请求路径变成/v1/v1/messages而 404 或Connection refused参见下文故障排查表。场景三Codex CLI / AppCodex CLI 使用 OpenAI Responses API。需要在Responses入口配置服务类型为OpenAI Chat的渠道CCX 会在内部把 Responses 请求转换为 Chat Completions 后转发给 DeepSeek。配置步骤进入 CCX 管理界面选择Responses入口点击「添加渠道」填写以下信息字段值服务类型OpenAI Chat名称DeepSeek ChatBase URLhttps://api.deepseek.comAPI Keys你的 DeepSeek API Key模型白名单deepseek-v4-pro,deepseek-v4-flash保存后编辑该渠道启用规范化非标准 Chat role开关为什么需要启用Codex 的 Responses 请求被 CCX 转换为 Chat Completions 后消息数组中可能包含developer等 DeepSeek 不支持的 role。启用此选项后CCX 会在发往上游前将这类非标准 role 规范化为user。从源码看该能力在配置层面对应兼容 traitnormalize_nonstandard_chat_roles定义于 backend-go/internal/config/channel_compat_cache.go注释明确指出其语义是上游只接受标准 Chat role需把非标准 role 降为 user生效判断函数IsNormalizeNonstandardChatRolesEnabled()位于 backend-go/internal/config/config.go默认返回false不降级因此对 DeepSeek 这类只认标准 role 的上游必须显式打开该开关或依赖 CCX 的运行时自动学习trait 学习机制见 backend-go/internal/config/config_loader.go。模型映射推荐Codex CLI/App 默认使用 GPT 模型名配置映射让 CCX 自动重定向请求模型重定向到gptdeepseek-v4-prominideepseek-v4-flash映射规则CCX 优先使用更长的匹配键。gpt匹配gpt-5等常规模型mini匹配gpt-5-mini等轻量模型。不要把 pro 路由键写成gpt-5否则gpt-5-mini会先命中gpt-5轻量请求被错误路由到旗舰模型。客户端配置Codex CLIexport OPENAI_API_KEYyour-ccx-proxy-key export OPENAI_BASE_URLhttp://localhost:3000/v1 codex 你好Codex AppVS Code / JetBrains 插件设置项值API Keyyour-ccx-proxy-keyBase URLhttp://localhost:3000/v1Modelgpt-5CCX 自动重定向到deepseek-v4-pro可用模型一览模型说明deepseek-v4-proDeepSeek-V4 Pro 旗舰模型deepseek-v4-flashDeepSeek-V4 Flash 快速模型deepseek-chatDeepSeek-V3 通用对话模型旧版别名deepseek-reasonerDeepSeek-R1 推理模型在仓库的内置模型清单中DeepSeek 官方端点还暴露了更多型号deepseek-flash、deepseek-v4.1-flash、deepseek-v4-flash-vision-exp等见 shared/builtin-models-manifest/builtin-models-manifest.json。模型能力画像注册在 shared/model-registry/ccx_model_registry.json例如 DeepSeek V4.1 Flash 在注册表中声明了 1M 上下文窗口contextWindowTokens: 1000000、thinkingMode: thinking、reasoningEfforts: [low/high/max]以及vision: true、jsonOutput: true、toolCalls: true、contextCaching: true等能力位。⚠️版本差异提醒文档与本文的示例模型名以当前配置指南为准实际可用型号以渠道modelsUrlhttps://api.deepseek.com/models返回为准模型注册表与内置清单会随上游迭代更新配置时建议以管理界面中渠道测试返回的真实模型名为依据。图片 / 视觉支持关闭后自动 failoverDeepSeek 上游不支持图片输入。在 CCX 中配置 DeepSeek 渠道时建议关闭视觉支持编辑渠道时点击右上角的眼睛图标使其变为关闭状态。编辑渠道界面 — 关闭视觉支持后眼睛图标变为灰色悬停提示「此渠道不支持图片输入」关闭后的行为纯文本请求正常路由到 DeepSeek 渠道包含图片的请求会自动跳过该渠道failover 到调度队列中下一个支持视觉的渠道无需手动干预CCX 会自动完成路由切换。如果你同时配置了 DeepSeek纯文本和另一个支持视觉的渠道CCX 会智能区分请求类型图片请求走视觉渠道文本请求仍走 DeepSeek两类流量互不挤占。从源码看这一行为由两个机制共同保障渠道能力位NoVision字段整个渠道不支持图片输入定义于 backend-go/internal/config/config.go关闭视觉开关即写入该能力位路由否决原因智能路由器在候选筛选中遇到不支持图片的渠道时会追加vision_unsupported否决原因见 backend-go/internal/autopilot/smart_router.go该原因同样登记在 backend-go/internal/autopilot/trace_contract.go 的路由追踪契约中同时 backend-go/internal/handlers/common/failover.go 负责对上游图片输入不被支持类错误进行分类并触发下一渠道重试。验证配置渠道保存后可通过 CCX 的模型列表接口验证curl http://localhost:3000/v1/models \ -H Authorization: Bearer your-ccx-proxy-key返回的模型列表中应包含你配置的 DeepSeek 模型。更进一步的验证方式是直接发起一次最小请求Chat 入口curl http://localhost:3000/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer your-ccx-proxy-key \ -d {model:deepseek-v4-flash,messages:[{role:user,content:你好}]}故障排查问题解决方案401 Unauthorized确认工具中的 Key 与 CCX 的PROXY_ACCESS_KEY一致Model not found确认渠道中的模型名称正确且模型确实存在于上游/models列表Connection refused确认 CCX 正在运行Base URL 指向正确地址渠道 unhealthy检查 DeepSeek API Key 是否正确网络是否能访问api.deepseek.comClaude Code 响应格式异常确认ANTHROPIC_BASE_URL指向根地址不含/v1补充两个高频细节角色报错若在 Responses/Codex 场景收到developerrole 不被上游接受类错误说明「规范化非标准 Chat role」开关未生效——检查渠道是否在保存后二次编辑并开启了该开关对应 traitnormalize_nonstandard_chat_roles的默认关闭语义见 backend-go/internal/config/config_baseurl_test.go 的测试用例。视觉请求走错渠道若图片请求仍被路由到 DeepSeek 渠道并报图片输入不被支持请确认视觉开关已关闭NoVision能力位并确认存在其他支持视觉的可用渠道供 failover。进阶阅读模型解析与自动映射机制除管理界面的模型映射表外CCX 的智能路由层还内置了**模型画像自动解析AutoResolve**能力配置项modelMapping.autoResolve定义于 backend-go/internal/config/autopilot_config.go默认开启模型解析器会依据模型注册表shared/model-registry/ccx_model_registry.json把请求模型解析为渠道可用的实际模型名并校验能力下限CapabilityFloorEnabled见 backend-go/internal/autopilot/model_resolver.go。这意味着除了 UI 上的显式映射DeepSeek 渠道还可以享受客户端写deepseek-v4-pro、网关自动匹配画像与价格的一站式解析体验——两者可以配合使用显式映射负责把 Claude/GPT 模型名翻译成 DeepSeek 模型名AutoResolve 负责后续的画像校验与候选收敛。总结在 CCX 中接入 DeepSeek 的核心要点可归纳为三条协议分入口、端点分清单Chat/Responses 渠道用https://api.deepseek.comMessages 渠道用https://api.deepseek.com/anthropic内置清单 shared/builtin-models-manifest/builtin-models-manifest.json 已固化该映射模型映射解决名字不对Claude Code 用opus/sonnet/haiku三段映射Codex 用gpt/mini两段映射注意匹配键的最长优先规则视觉开关解决能力不对DeepSeek 渠道关闭视觉支持后图片请求自动vision_unsupported否决并 failover 到视觉渠道NoVision能力位 backend-go/internal/autopilot/smart_router.go 路由原因。按本文三个场景完成配置后你就可以用同一个 CCX 网关让 Claude Code、Codex 与任意 OpenAI 兼容工具无缝共享 DeepSeek 的模型能力了。赞分享API网关LLM 网关后端【免费下载链接】ccxClaude / Codex / Gemini API Proxy - CCX项目地址https://gitcode.com/gh_mirrors/cc/ccx点击查看免费下载相关推荐使用 ai-loop Skill 构建有边界的 Spec-Build-Review 开发循环Agent 化功能的规划、实现与验证实践使用 ai loop Skill 构建有边界的 Spec Build Review 开发循环Agent 化功能的规划、实现与验证实践 导读 ai loop 是API网关LLM 网关后端CCX 接入 MiniMax 配置指南OpenAI 与 Anthropic 双协议渠道搭建、模型映射与源码级解析CCX 接入 MiniMax 配置指南OpenAI 与 Anthropic 双协议渠道搭建、模型映射与源码级解析 导读 MiniMax稀宇科技是同时提供API网关LLM 网关后端CCX 接入 MiniMax 完整指南OpenAI Chat 与 Anthropic Messages 双协议配置CCX 接入 MiniMax 完整指南OpenAI Chat 与 Anthropic Messages 双协议配置 MiniMax 是同时提供 OpenAIAPI网关LLM 网关后端上一篇华硕笔记本性能管家G-Helper告别臃肿拥抱高效下一篇深入解析ASP.NET Boilerplate初始化从模块加载到依赖注入的完整指南 创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考