Trae Switch 是一个专为 Trae IDE 设计的工具,通过 DNS 劫持 + 本地反向代理,让 Trae IDE 支持第三方大模型服务商 API(如阿里百炼 Coding Plan、kimi coding plan等)。详细使用教程:https://mp.weixin.qq.com/s/W_Z_nbrO7ioU8upcq4KkOw
- 多服务商支持:可添加、编辑、删除多个服务商配置
- 本地模型管理:
/v1/models请求返回本地配置的模型(因为第三方通常不支持此接口) - 自动 Hosts 配置:将
api.openai.com重定向到127.0.0.1 - CA 证书管理:生成并安装本地 CA 证书,用于 HTTPS 拦截
- 实时状态监控:显示代理运行状态和当前激活的服务商
- 不需要输入key:通过在trae中配置key,在本工具不需要输入任何apikey
- ✅ 阿里百炼、Kimi等 Coding Plan
- ✅ 其他支持 OpenAI 协议的第三方api服务商
- 后端:Go (Wails 框架)
- 前端:Svelte + Tailwind CSS
- 网络:HTTPS 代理服务器
- 系统:Windows 系统集成(Hosts 管理、证书安装)
- 代理服务器:监听 443 端口,处理 OpenAI API 请求
- 配置管理:读写
config.json配置文件 - Hosts 管理:自动设置和恢复 Hosts 配置
- 证书管理:生成和安装自签名 CA 证书
- 前端界面:现代化的用户交互界面
- 从 Releases 页面下载最新版本的
trae-switch.exe - 以管理员身份运行程序
- 克隆仓库:
git clone https://github.com/yourusername/trae-switch.git cd trae-switch - 安装依赖并编译
- 点击「+ 添加」按钮
- 填写服务商信息:
- 名称:服务商显示名称(如 "阿里百炼")
- API 地址:OpenAI 协议的 API 地址(如
https://coding.dashscope.aliyuncs.com/v1) - 模型列表:添加可用的模型 ID(如
qwen3.5-plus、kimi-k2.5等)
- 点击「保存」
- 确保系统配置中的「Hosts 配置」和「CA 证书」都已启用
- 点击右上角的「启动」按钮
- 代理启动成功后,状态栏会显示「运行中」
- 打开 Trae IDE
- 进入模型设置
- 选择 OpenAI 服务商
- 输入对应第三方服务商的真实 API Key(如
sk-xxx) - 手动输入你想要使用的模型名称
- 关闭 auto mode 并选择刚添加的模型
- 开始使用!
配置文件位于程序同目录下的 config.json,格式如下:
{
"providers": [
{
"name": "服务商名称",
"openai_base": "https://api.example.com/v1",
"models": ["model-1", "model-2"]
}
],
"active_provider": 0
}name:服务商显示名称openai_base:OpenAI 协议的 API 地址models:模型 ID 列表active_provider:当前激活的服务商索引
- 添加服务商配置(API 地址和模型列表)并点击「启动」
- 在 Trae IDE 添加自定义模型,服务商选择 OpenAI 服务商
- 模型手动输入你想要使用的模型并且输入对应 API Key(如 sk-xxx)
- 关闭 auto mode 并且选择刚添加的模型
A: 请检查:
- 是否以管理员身份运行
- 443 端口是否被占用
- Hosts 配置是否成功
- CA 证书是否安装
A: 请确保:
- 已在服务商配置中添加了模型
- 已选择了正确的服务商
- 代理已成功启动
A: API Key 需要从对应服务商的官方网站获取
A: 支持所有支持openai接口协议服务商提供的模型,只要在配置中添加对应的模型 ID 即可。
- 本地运行:所有数据处理都在本地进行,不会上传任何数据
- 自签名证书:仅用于本地 HTTPS 拦截,不会影响其他应用
- Hosts 修改:仅修改
api.openai.com的解析,不影响其他域名 - 不存储key:通过在trae中配置key,在本工具不需要输入任何key
本项目采用 MIT 许可证。