注册

Trae 配置教程

Trae 是一款 AI 编程工具,支持自定义模型接入。通过 QuickRouter API 中转服务,可以在 Trae 中直接使用 GPT、Claude、Gemini 等主流模型,无需单独管理多个 API 平台。

一、下载安装 Trae

访问 Trae 官方网站下载最新版本:

资源下载地址
Trae 国内版(推荐)https://www.trae.cn/ide/download
Trae 国际版https://www.trae.ai/

支持 macOS 12.0+Windows 10+Linux 系统。下载后安装即可。

二、核心要点:baseURL 必须填写完整接口路径

这是配置 Trae 自定义模型最关键的一点:

⚠️ baseURL 必须填写完整接口路径,而不是只填域名。很多人习惯只写成 https://api.quickrouter.ai,这在 Trae 里会导致报错。

OpenAI 格式(适用于 GPT、DeepSeek、Qwen 等模型)

正确写法:

OpenAI baseURL
https://api.quickrouter.ai/v1/chat/completions

必须写到 /chat/completions 这一层。

Anthropic 格式(适用于 Claude 模型)

正确写法:

Anthropic baseURL
https://api.quickrouter.ai/anthropic/v1/messages

必须写到 /messages 这一层。

三、配置步骤

第 1 步:获取 API Key

访问 QuickRouter API 控制台,在「令牌管理」中创建并复制你的 API Key(以 sk- 开头)。

第 2 步:打开 Trae 模型设置

Trae → Settings → Models → Custom Model

第 3 步:填写参数

OpenAI 模型示例(GPT、DeepSeek、Qwen 等)

参数填写内容
Model Namegpt-5.5
API Key你的 QuickRouter API Key
baseURLhttps://api.quickrouter.ai/v1/chat/completions

Anthropic 模型示例(Claude)

参数填写内容
Model Nameclaude-sonnet-4-6
API Key你的 QuickRouter API Key
baseURLhttps://api.quickrouter.ai/anthropic/v1/messages

保存即可使用。

四、常用模型 ID 参考

模型Model NamebaseURL 格式
GPT-5.5gpt-5.5OpenAI
GPT-5.4gpt-5.4OpenAI
Claude Sonnet 4.6claude-sonnet-4-6Anthropic
Claude Opus 4.6claude-opus-4-6Anthropic
DeepSeek V3.2deepseek-chatOpenAI
Gemini 2.5 Progemini-2.5-proOpenAI
Qwen 3.6 Plusqwen3.6-plusOpenAI

完整模型列表请参考 QuickRouter 大模型定价页面

五、常见问题

提示 401 / Unauthorized

检查 API Key 是否复制完整、是否多复制了空格、Key 是否仍然有效、账户是否有可用额度。

提示 model not found

模型 ID 填写错误。请到 QuickRouter 定价页面查看正确的模型 ID,不要手动改写模型名称。

提示 404

优先检查 baseURL 是否正确填写了完整路径(包括 /chat/completions/messages),再检查模型 ID 是否正确。

提示 400 请求错误

可能是 baseURL 格式不对。请确保:
OpenAI 模型:https://api.quickrouter.ai/v1/chat/completions
Anthropic 模型:https://api.quickrouter.ai/anthropic/v1/messages

Trae 自定义模型接入要点

Trae 的配置重点是接口路径要按模型类型填写完整。不要只看域名,要确认当前接入的是 OpenAI 兼容模型还是 Claude/Anthropic 兼容模型。

模型类型接口路径说明
GPT / OpenAI 兼容模型https://api.quickrouter.ai/v1/chat/completions适合 GPT、部分兼容 OpenAI 的模型
Claude / Anthropic 兼容模型https://api.quickrouter.ai/anthropic/v1/messages适合 Claude 消息接口
API KeyQuickRouter 控制台密钥填入 Trae 自定义模型配置

适合搜索本页的场景

  • Trae 自定义模型怎么配置。
  • Trae 接入 Claude 或 GPT。
  • Trae Base URL 应该填什么。
  • Trae 通过 API 中转站调用大模型。

相关教程