MTGA(Trae IDE自定义模型代理工具)

MTGA是什么

MTGA全称Make Trae Great Again，是一款开源免费的本地代理转发工具，专门用于突破Trae IDE官方服务商限制，让Trae IDE能够接入任意遵循OpenAI接口协议的大模型API。软件基于Tauri开发，提供可视化GUI客户端，自动完成证书签发、Hosts修改、端口转发等复杂代理操作，无需手动编写脚本，Windows、macOS系统均可直接使用。

作为面向Trae IDE的专用桥接工具，它屏蔽不同大模型厂商接口差异，实现模型统一调度，降低普通用户给Trae IDE接入第三方大模型的技术门槛。

软件功能

1. OpenAI格式接口统一适配：自研MLiteLLM模块，完成不同厂商API协议转换，无需手动修改接口请求体，兼容OpenAI标准接口格式的各类大模型服务。

2. 多上游配置分组管理：支持创建多套独立上游配置组，自定义API网关域名、接口路由地址、真实上游模型ID，实现多套服务商快速切换。

3. 模型ID映射能力：设置Trae IDE识别的虚拟模型标识，与上游真实模型ID做映射，在IDE内直接调用自定义模型。

4. 请求体自定义补丁：支持JSON Patch对API请求报文做修改，适配部分非标准接口服务商特殊参数要求。

5. 全自动证书与Hosts处理：自动生成本地CA根证书，支持一键安装系统受信任证书；自动修改系统Hosts文件劫持api.openai.com域名。

6. GUI图形化运维面板：可视化界面完成配置编辑、代理启停、实时日志查看，提供SSL严格模式开关，方便排查接口转发故障。

7. 链路调试支持：配合Reqable等抓包工具完成接口调试，输出完整请求响应日志，快速定位模型调用失败问题。

8. 跨平台支持：同时支持Windows、macOS（Intel与Apple Silicon架构），提供预编译安装包。

软件特色

• 完全本地运行：代理服务部署在本机，API密钥只在本地流转，数据不经过外部中转服务器。

• 无第三方转发依赖：自研MLiteLLM替代LiteLLM，减少额外依赖包，降低环境冲突风险。

• 开箱即用自动化部署：自动处理证书签发、信任安装、Hosts修改，不需要掌握代理、SSL相关专业知识。

• 完整故障排错体系：内置日志输出、SSL模式开关，官方文档覆盖端口占用、证书不信任、Hosts失效等绝大多数常见问题。

• 开源可审计：全部代码开源托管GitHub，可以阅读源码，可自行编译，无闭源黑盒逻辑。

• 模型分组隔离：多组上游配置互相独立，切换服务商只需要切换配置组，不需要反复删除重填API密钥。

使用方法

1. 下载安装：前往项目GitHub Releases页面，根据操作系统下载对应安装包，Windows运行exe安装程序，macOS打开dmg，将MTGA_GUI.app移入应用程序目录；macOS遇到包损坏提示，使用终端命令解除隔离属性。

2. 配置上游模型：打开MTGA软件，新建代理配置组，填写上游服务商API地址、接口路由、上游真实模型ID以及服务商API Key。

3. 设置映射模型：填写Trae IDE识别的虚拟模型ID，设置本地代理鉴权密钥，该密钥仅用于本机代理校验，和上游服务商密钥无关。

4. 启动代理服务：点击一键启动全部服务，Windows、macOS需要授予管理员权限，软件自动完成Hosts修改、证书安装，启动443端口代理监听。

5. Trae IDE对接：打开Trae IDE，添加模型，服务商选择OpenAI类型，模型ID填写MTGA配置的虚拟模型名称，API密钥填入MTGA本地鉴权密钥，保存配置。

6. 测试调用：保存完成后，即可在Trae IDE编辑器内调用配置的第三方大模型；遇到报错查看MTGA软件内部日志排查链路问题。

适合人群

1. Trae IDE用户，不想受官方内置模型限制，想要接入智谱、Gemini、Anthropic等外部大模型API的开发者。

2. 需要同时切换多家大模型服务商，希望在同一个IDE环境统一调用不同模型的技术人员。

3. 手上拥有第三方API密钥，但没有网络代理配置经验，不想手动搭建反向代理的编程学习者。

4. 重视密钥安全，希望全部请求本地转发，避免经过第三方中转服务的研发人员。

5. 开源爱好者，希望可以自行阅读源码、自定义修改代理逻辑的技术用户。

收费价格

MTGA为GitHub开源项目，软件本体完全免费，遵循AGPL‑3.0开源协议，任何人都可以下载、使用，也可以查看源码、自行编译。

注意：软件本身不提供任何大模型API服务，调用上游大模型会产生对应服务商API调用费用，费用由对应模型服务商收取，与MTGA工具无关。

竞品对比

常见问题解答

Q：启动MTGA代理为什么需要管理员权限？

A：代理需要监听本机443端口，同时修改系统Hosts文件、安装根CA证书，这几项操作都需要系统管理员权限，没有权限代理服务将无法正常运行。

Q：Trae IDE提示添加模型失败，该怎么排查？

A：优先查看MTGA运行日志，依次检查三点：第一确认Hosts文件内存在127.0.0.1 api.openai.com并且没有被注释；第二确认443端口没有被VPN、其他代理软件占用；第三确认本地CA证书已经安装到系统受信任根证书存储区，同时关闭其他全局系统代理后重试。

Q：MTGA会不会上传我的API密钥？

A：不会，MTGA属于本地代理工具，全部转发逻辑运行在本机电脑，API密钥仅在本机内存处理，不会上传到任何外部服务器，源码全部开源可以自行审计。

Q：macOS打开APP提示软件包已损坏怎么办？

A：这是macOS隔离属性导致，打开终端执行命令xattr -d com.apple.quarantine，后面带上MTGA_GUI.app完整路径，执行后就可以正常打开程序。

Q：是不是所有OpenAI兼容接口都可以用MTGA？

A：绝大多数标准OpenAI Chat Completions接口都支持；部分接口请求参数特殊，可以使用软件内置JSON Patch功能修改请求报文适配非标准服务商。

Q：开启MTGA代理后，浏览器访问openai.com无法打开网页？

A：如果网页异常，可以停止MTGA代理服务，Hosts会自动恢复，停止代理后即可恢复正常访问。

Q：MTGA可以在Linux系统使用吗？

A：项目预编译包仅提供Windows与macOS版本，Linux系统用户可以下载源码自行编译构建，需要手动处理证书、Hosts与端口权限。

总结

MTGA是一款专门面向Trae IDE打造的开源本地代理转发工具，依靠本机域名劫持与自研接口适配层，解决Trae IDE官方模型服务商限制问题，自动化完成证书、Hosts等复杂代理配置，让普通用户无需深厚网络知识，就能够在Trae IDE内自由接入各类兼容OpenAI协议的第三方大模型，工具本体完全免费开源，数据全部本地流转，非常适合有自定义模型接入需求的Trae IDE使用者。