MTGA 配置
MTGA 配置
MTGA 是一个本地代理工具,适合把 Trae 等固定模型服务商的 IDE 接入 Smallice AI。它会在本机启动代理服务,将 IDE 里发往 OpenAI 的请求转发到你配置的上游接口。
下载 MTGA
打开 MTGA 项目发布页,下载适合当前系统的安装包:
https://github.com/BiFangKNT/mtga/releasesWindows 下载 MTGA_v{version}_windows_x64-setup.exe。
macOS 下载 MTGA_v{version}_apple_{arch}.dmg,其中 aarch64 适合 Apple Silicon,x64 适合 Intel。
添加 Smallice AI 配置组
启动 MTGA 后,添加一个代理配置组。
名称: Smallice AI
提供商: openai_chat_completion
API URL: https://api.smallice.chat
API Key: 你的 Smallice AI API Key
模型: gpt-5.2API Key 在 https://smallice.chat/keys 创建。
注意 API URL 只填写域名,不要写成 https://api.smallice.chat/v1。MTGA 会根据提供商类型处理后续接口路径。
Responses 模式
如果你希望让 MTGA 在代理层把 Chat Completions 请求转换到 Responses 接口,可以把提供商改为:
提供商: openai_response
API URL: https://api.smallice.chat一般优先使用 openai_chat_completion。只有在你明确需要 Responses 能力,或当前模型在 MTGA 中更适合走 Responses 转换时,再使用 openai_response。
启动本地代理
配置完成后,点击 MTGA 的一键启动全部服务。
MTGA 会自动执行:
- 生成并安装本地证书
- 修改 hosts,将 OpenAI 域名指向本机
- 启动本地代理服务
Windows 和 macOS 都可能需要管理员权限。macOS 如果提示应用已损坏,可以参考 MTGA 项目 README 中的处理方式。
配置 Trae IDE
打开 Trae IDE,进入添加模型页面。
服务商: OpenAI
模型: 选择或填写你在 MTGA 中配置的模型
API 密钥: 填写 MTGA 全局配置中的 Key添加完成后,在 Trae 右下角选择刚刚添加的模型,发送一句简单问题测试。
排查
如果 Trae 添加模型失败,先看 MTGA 日志区是否收到请求。
没有请求日志时,优先检查:
- hosts 中是否存在
127.0.0.1 api.openai.com - 本机 443 端口是否被其他程序占用
- 本地代理、VPN 或系统代理是否干扰 MTGA
- 本地证书是否已经被系统信任
有请求日志但上游报错时,优先检查:
API URL是否为https://api.smallice.chat- 提供商是否选择
openai_chat_completion - API Key 是否来自 Smallice AI 主站
- 模型名称是否与 Smallice AI 后台展示一致
