Trae IDE 配置教程

Trae IDE（字节跳动出品）支持添加自定义模型服务商。获取 API Key 后，按以下步骤完成配置。

步骤 1：下载并安装 Trae IDE

访问 Trae 官网下载对应操作系统的安装包

运行安装程序，按照提示完成安装

💡 建议使用最新版本，旧版本可能不支持自定义请求地址功能。

步骤 2：添加自定义模型

打开 Trae IDE

点击聊天侧栏右上角的 齿轮图标 ⚙️

选择 Models 标签

点击 + Add Model

填写以下信息：

字段	值
Provider	选择 `OpenAI`
Model	输入模型名称，如 `gpt-4o`、`claude-sonnet-4-5`
API Key	粘贴你在平台创建的令牌
Custom Request URL	`https://jiniu.ai/v1/chat/completions`

⚠️ 重要：Custom Request URL 必须填写完整的接口路径，不能只填域名。

点击 Add 保存

步骤 3：验证配置

在 Trae 的 Chat 或 Builder 面板中，点击底部模型选择器

选择刚添加的自定义模型

发送一条测试消息（如"你好"），收到正常回复即配置成功

添加多个模型

你可以重复步骤 2 添加多个模型，常用模型名称：

模型	Model 字段填写
GPT-4o	`gpt-4o`
GPT-4o Mini	`gpt-4o-mini`
Claude Sonnet 4	`claude-sonnet-4-5`
Claude Haiku	`claude-haiku-4-5`
Gemini 2.5 Pro	`gemini-2.5-pro`
DeepSeek V3	`deepseek-chat`
DeepSeek R1	`deepseek-reasoner`

💡 具体可用模型请在平台控制台的「模型广场」中查看。每个模型需要单独添加一次。

旧版本替代方案：Cline 插件

如果你的 Trae 版本没有 Custom Request URL 字段，可以通过安装 Cline 插件来使用自定义 API：

打开 Trae IDE → 左侧「插件」面板

搜索并安装 Cline 插件

打开 Cline 插件设置：

API Provider：选择 OpenAI Compatible

Base URL：填写 https://jiniu.ai/v1

API Key：填写你的令牌

Model ID：填写模型名称，如 claude-sonnet-4-5

保存配置，通过 Cline 插件面板与模型交互

常见问题

Q：找不到 "Custom Request URL" 字段？
A：该功能需要 Trae v3.3.51 或更高版本。请更新到最新版，或使用上述 Cline 插件方案替代。

Q：添加模型后调用报错？
A：请检查 Custom Request URL 是否填写了完整路径 https://jiniu.ai/v1/chat/completions，不能只填 https://jiniu.ai 或 https://jiniu.ai/v1。

Q：Provider 应该选什么？
A：选择 OpenAI。平台兼容 OpenAI 接口格式，无论你实际使用的是 Claude、Gemini 还是其他模型，Provider 都选 OpenAI 即可。

Q：如何切换模型？
A：在聊天面板底部的模型选择器中切换。每个模型需要在 Models 设置中单独添加。

Q：Trae 国内版和国际版有区别吗？
A：配置方式一致。国内版（trae.com.cn）和国际版（trae.ai）都支持添加自定义模型服务商。

Trae IDE 配置教程

步骤 1：下载并安装 Trae IDE#

步骤 2：添加自定义模型#

步骤 3：验证配置#

添加多个模型#