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 Name | gpt-5.5 |
| API Key | 你的 QuickRouter API Key |
| baseURL | https://api.quickrouter.ai/v1/chat/completions |
Anthropic 模型示例（Claude）
| 参数 | 填写内容 |
|---|---|
| Model Name | claude-sonnet-4-6 |
| API Key | 你的 QuickRouter API Key |
| baseURL | https://api.quickrouter.ai/anthropic/v1/messages |
保存即可使用。
四、常用模型 ID 参考
| 模型 | Model Name | baseURL 格式 |
|---|---|---|
| GPT-5.5 | gpt-5.5 | OpenAI |
| GPT-5.4 | gpt-5.4 | OpenAI |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | Anthropic |
| Claude Opus 4.6 | claude-opus-4-6 | Anthropic |
| DeepSeek V3.2 | deepseek-chat | OpenAI |
| Gemini 2.5 Pro | gemini-2.5-pro | OpenAI |
| Qwen 3.6 Plus | qwen3.6-plus | OpenAI |
完整模型列表请参考 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