行业现状背景
当前主流AI编码客户端普遍存在绑定特定大模型服务商的限制，不同厂商的API协议定义互不兼容，用户切换底层模型时需要对客户端进行二进制补丁、修改配置文件甚至替换核心运行文件的操作。这类操作不仅会破坏客户端的原生更新机制，还可能引入不可预期的运行错误，同时不同客户端的协议适配逻辑分散，无法在统一层面处理流式响应、工具调用、多模态输入输出等复杂交互场景。
大量开发者在日常编码辅助工作中，往往需要同时调用多个不同厂商的大模型能力，部分场景下还需要接入本地部署的开源模型来满足数据合规要求。跨客户端的重复适配工作占用大量开发调试时间，也很难保证不同场景下的交互体验一致性，代理层的统一协议转换能力可以从架构层面解决这一痛点。
项目概述
该项目由韩国首尔的独立开发者主导开发，正式发布于2026年8月，采用MIT协议完全开源，所有功能均无需付费解锁，由社区共同维护迭代。项目核心定位为轻量本地代理服务，无需修改任何客户端的原生代码，即可实现多个主流AI编码客户端与40余家大模型服务商之间的协议互通。
项目覆盖全平台运行支持，可在CLI命令行模式、Web可视化面板模式下运行，原生兼容Windows、macOS操作系统，同时对外暴露标准化API接口供上层系统集成。项目配套提供完整的官方文档与llms.txt资源文件，方便大模型自动抓取项目相关说明生成适配配置。
技术架构深度分析
项目整体采用TypeScript语言开发，代码体积轻量，运行时资源占用极低，默认启动后仅占用不到100MB内存，不会对本地开发环境的其他进程造成资源挤占。整个架构采用分层解耦设计，核心分为流量拦截层、协议转换层、路由调度层、适配器层、监控展示层五个独立模块，模块之间通过标准化接口交互，新增大模型服务商支持时仅需要开发对应适配器即可完成接入，不需要修改核心代理逻辑。
核心模块设计细节
- 流量拦截层：默认监听本地10100端口，所有发往该端口的客户端请求都会被完整捕获，不会修改系统全局代理配置，不会影响其他应用的网络访问。该层内置请求合法性校验逻辑，自动过滤格式错误的异常请求，避免无效流量流入后续处理流程。
- 协议转换层：实现OpenAI Responses API格式与其他所有目标协议之间的双向映射，请求侧自动将客户端发来的原生格式转换为目标服务商要求的参数结构，响应侧将服务商返回的结果重新打包为客户端可识别的原生格式，整个转换过程不会丢失任何原始字段信息。
- 路由调度层：内置轻量路由规则引擎，支持基于模型名称、请求来源、内容特征配置转发策略，可实现同一客户端不同模型请求自动分发到不同服务商的能力，不需要用户手动切换不同的API密钥配置。
- 适配器层：目前内置五个核心标准适配器，覆盖当前主流大模型服务商的所有协议格式，每个适配器独立维护，互不干扰，单个适配器的更新不会影响其他适配器的正常运行。
- 监控展示层：内置Web可视化面板，所有请求的完整生命周期数据都会被实时采集，包括请求时间、传输流量、调用状态、返回耗时等信息，方便用户排查接口调用过程中出现的异常问题。
该架构设计的优势在于完全解耦了客户端与底层服务商的依赖关系，所有协议适配逻辑都收敛到代理层统一处理，后续新增客户端支持或者新增服务商支持都可以通过扩展对应模块快速完成，整体可维护性远高于分散的补丁修改方案。同时所有转换逻辑都运行在本地环境，不会将用户的代码数据转发到第三方中间服务器，完全满足本地开发场景下的数据安全要求。
核心功能详解
原生客户端无修改适配
该功能支持直接对接OpenAI Codex全系列客户端、Claude Code、Claude Desktop、Grok Build等主流AI编码客户端，不需要对客户端二进制文件进行补丁操作，也不需要替换客户端内部的证书或者配置文件。用户仅需要将客户端的API端点地址修改为本地代理运行地址即可完成接入，操作过程不会破坏客户端的原生自动更新机制，后续客户端发布新版本时可以直接正常升级，不需要重新执行适配操作。
双向全协议格式转换
项目内置的协议转换引擎支持请求与响应的双向完整格式映射，覆盖流式响应、工具调用、推理令牌、图片输入输出等所有主流交互能力。所有在原生客户端上可以正常使用的功能，通过代理转发到其他大模型服务商之后都可以保持完全一致的交互体验，不会出现工具调用失效、流式输出中断、图片无法识别等常见适配问题。转换过程中不会对用户输入的代码内容、上下文信息做任何额外修改，完全保留原始请求的语义完整性。
多服务商原生适配器支持
目前内置的五个标准适配器分别对应Anthropic Messages协议、Google Gemini协议、Azure OpenAI协议、原生OpenAI Responses透传协议以及OpenAI兼容Chat Completions协议，覆盖超过40家主流大模型服务商的接口规范。用户不需要针对不同服务商分别做格式适配，只需要在配置页面填入对应服务商的API密钥即可完成接入，所有协议差异都由适配器自动处理。后续新增的第三方服务商只要兼容OpenAI接口规范，不需要额外更新代理版本即可直接接入使用。
内置Web可视化管理面板
代理服务启动后会自动在本地开放Web面板入口，用户可以通过浏览器直接访问完成所有配置操作，不需要手动编辑复杂的配置文件。面板提供实时请求监控视图，所有正在运行的请求的完整报文、传输状态、返回进度都可以实时查看，同时支持历史请求记录回溯，可直接导出任意请求的完整请求响应报文用于调试排查问题。面板还内置了服务商连通性测试工具，一键即可验证当前配置的API密钥是否可用，接口连通状态是否正常。
轻量无依赖运行环境
项目基于TypeScript开发，编译后生成单可执行文件，运行过程中不需要额外安装数据库、消息队列等第三方依赖服务，单进程即可完成所有功能运行。启动耗时小于2秒，后台静默运行时几乎不会占用CPU资源，长时间运行不会出现内存泄漏问题。同时提供跨平台的预编译二进制包，用户不需要配置Node.js运行环境，下载后直接执行即可启动服务，降低非专业用户的部署门槛。
标准化API扩展能力
代理服务对外暴露完全兼容OpenAI规范的API接口，所有支持OpenAI接口格式的第三方应用、SDK、脚本都可以直接对接该代理服务，自动获得对接所有其他大模型服务商的能力。用户可以基于该API接口快速搭建自定义的AI编码工作流，实现代码仓库自动巡检、批量代码重构、自动化单元测试生成等扩展功能，不需要单独开发多服务商的适配逻辑。
项目地址：https://github.com/lidge-jun/opencodex
⭐ Stars：17987
🔍 来源：GitHub
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code
微信扫一扫，打赏作者吧～
网友评论