Trae 配置指引

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

一、下载部署安装 Trae

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

全面支持 macOS 12.0+、Windows 10+、Linux 系统。下载后部署安装即可。

二、核心要点：baseURL 必须填写完整端点路径

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

OpenAI 格式（适用于 GPT、DeepSeek、Qwen 等模型）

正确写法：

https://api.timrouter.com/v1/chat/completions

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

Anthropic 格式（适用于 Claude 模型）

正确写法：

https://api.timrouter.com/anthropic/v1/messages

必须写到 /messages 这一层。

三、配置步骤

第 1 步：查询获取 API Key

访问 TimRouter API 管理控制台，在「令牌管理」中创建并产出并复制你的 API Key（以 sk- 开头）。

第 2 步：开启 Trae 模型设定

Trae → Settings → Models → Custom Model

第 3 步：填写参数

OpenAI 模型用例（GPT、DeepSeek、Qwen 等）

Anthropic 模型用例（Claude）

保存即可使用。

四、常用模型 ID 参考

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

五、常见问题

提示 401 / Unauthorized

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

提示 model not found

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

出现 404 提示

建议先行核查 baseURL 是否正确填写了完整路径（包括 /chat/completions 或 /messages），再检查模型 ID 是否正确。

提示 400 发起请求错误

可能是 baseURL 格式不对。请务必保证：
OpenAI 模型：https://api.timrouter.com/v1/chat/completions
Anthropic 模型：https://api.timrouter.com/anthropic/v1/messages

Trae 自定义模型接入要点

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

适合搜索本页的场景

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

相关教程

• Cursor 配置指引
• Codex 配置指引
• Claude Code 国内使用教程
• API 发起调用入门