在TRAE中使用自定义模型

最新版TRAE（Cline）自定义服务商配置教程

一、配置前提说明

2026年最新版TRAE原生IDE，已彻底移除自定义服务商、自定义Base URL的官方入口，仅支持内置合作模型，无法直接配置私人中转、自建API等第三方服务商。

当前唯一可行方案：通过 VS Code 中的 Cline 插件（原TRAE官方衍生插件）完成自定义服务商配置，该插件支持OpenAI兼容协议的中转/自建接口，可正常使用AI编程能力。

前置准备

1. 安装 VS Code 编辑器

2. 备好第三方中转/自建服务的 Base URL、API Key、可用模型ID

3. 确保服务商接口遵循OpenAI兼容规范，支持标准对话接口调用

二、Cline插件安装

1. 打开VS Code，点击左侧扩展图标（快捷键 Ctrl+Shift+X / Cmd+Shift+X）

2. 在搜索框输入 Cline，找到对应插件点击安装

3. 安装完成后，左侧栏会出现Cline专属机器人图标

三、打开API配置入口

1. 点击VS Code左侧栏的Cline图标，打开插件主界面

2. 在Cline聊天窗口的右上角，找到齿轮形状的设置图标，点击进入API配置页面

四、核心参数配置（关键步骤）

进入配置页面后，按以下要求填写各项参数，适配自定义中转服务商：

1. API Provider（API提供商）：务必选择 OpenAI Compatible（OpenAI兼容），切勿选原生OpenAI

2. Base URL（接口地址）：填写中转/自建服务地址，必须以/v1结尾，结尾不加多余斜杠

   • ✅ 正确示例：https://xxx.com/v1

   • ❌ 错误示例：https://xxx.com/、https://xxx.com、https://xxx.com/v1/

3. OpenAI Compatible API Key：填写第三方服务商提供的密钥

4. Model ID（模型ID）：填写服务商支持的对应模型名称，需严格匹配，大小写敏感

五、保存配置并测试

1. 核对所有参数无误后，点击页面底部的保存/应用按钮

2. 返回Cline聊天窗口，发送简单指令（如“帮我写一段Hello World代码”），测试接口是否连通

3. 若正常回复，说明配置成功；若报错，参照下方排查方案处理

六、Base URL填写规范（必看）

1. 必须遵循OpenAI兼容接口规范，末尾固定拼接/v1，这是接口调用的标准路径

2. 结尾禁止加斜杠，避免接口拼接出现双斜杠，导致请求失败

3. 不要省略https协议头，确保地址格式完整

4. 切勿填写纯域名、后台主页地址，必须指向API接口路径

七、常见避坑指南

1. TRAE原生IDE无任何自定义服务商入口，不要在原生客户端反复查找，避免浪费时间

2. API提供商选错会导致配置失效，必须选OpenAI Compatible，不可选原生OpenAI、Anthropic等内置选项

3. 模型ID必须和服务商完全一致，写错名称会触发模型不存在报错

4. 部分中转服务商需额外配置请求头，按服务商要求补充即可

八、常见问题排查

1. 接口请求失败/超时

检查Base URL是否正确、网络是否连通、服务商接口是否正常运行

2. 密钥无效

核对API Key是否复制完整，有无多余空格、字符遗漏

3. 模型不存在

确认Model ID和服务商支持的模型名称完全一致，区分大小写

4. 路径错误

检查URL是否以/v1结尾，有无多余斜杠、路径缺失

九、补充说明

该配置方式为当前最新版TRAE唯一可用的自定义服务商方案，依托Cline插件实现，无法和TRAE原生IDE的右侧主聊天区打通，仅能在VS Code的Cline插件内使用，属于官方商业策略下的兼容方案，适合需要使用私人中转的场景。