杂皮技术笔记 个人开发日志与通用技术记录
← 返回首页
文章目录 ⌄
MD · 更新于 2026-05-23 · 150 次阅读

Trae 配置自定义 AI 模型

· Trae IDE 接入第三方 API 中转站配置自定义模型方法，涵盖 OpenAI 兼容格式与 Anthropic 格式的区别、常见问题排查及完整操作步骤。

Trae 是字节跳动推出的 AI 编程 IDE，内置模型高峰期经常排队。通过接入第三方 API 中转站，可以免排队、自由切换模型、降低成本。本文介绍两种接入方式的完整操作步骤。

一、准备工作

你需要从 API 中转站获取以下三个信息：

信息说明示例
API Key中转站的令牌，通常以 sk- 开头sk-xxxxxxxxxxxx
Base URL中转站的 API 地址https://api.xxxx.com
模型 ID你要使用的模型名称glm-5.1

这三个信息通常在中转站的「令牌管理」和「模型广场」页面可以找到。

二、方式一：Trae 原生添加模型（推荐）

新版 Trae 已内置「添加模型」功能，不需要安装任何插件，配置最简单。

步骤 1：打开模型管理

有两种入口：

  • 聊天输入框右下角 → 点击当前模型名 → 点击「添加模型」
  • 头像 → 设置 → AI 功能管理 → 模型 → 添加模型

步骤 2：选择服务商

这一步很关键，根据你要接入的模型选择不同的服务商：

  • GPT / DeepSeek / Gemini / Qwen 系列 → 选择 OpenAI
  • Claude 系列 → 选择 Anthropic

选错服务商会导致连接失败。

步骤 3：填写配置

选择「自定义模型」，然后填写三个字段：

接入 GPT / DeepSeek / Gemini 等模型时：

  • 服务商：OpenAI
  • 模型 ID：glm-5.1 等
  • API 密钥：你的中转站令牌
  • Base URL：https://api.xxxx.com/v1（OpenAI 服务商一般不会自动加 /v1，所以你要自己加）

接入 Claude 系列模型时：

  • 服务商：Anthropic
  • 模型 ID：claude-opus-4-8 等
  • API 密钥：你的中转站令牌
  • Base URL：https://api.xxxx.com（Anthropic 服务商有些工具会自动加 /v1，你再填就重复了，所以不要加）

步骤 4：验证并使用

  1. 点击「添加模型」，Trae 会自动验证密钥是否有效
  2. 验证通过后，关闭 Auto Mode（自动模式会使用内置模型排队）
  3. 在模型列表滑到最底部，选择你刚添加的自定义模型
  4. 发送一条简单消息测试，比如 请回复：配置成功

三、方式二：通过 Cline 插件接入

如果 Trae 原生方式不支持你要的模型，或者你想在 SOLO 模式下使用自定义模型，可以通过 Cline 插件接入。

步骤 1：安装 Cline

在 Trae 扩展商店搜索 Cline → 安装

步骤 2：配置 Cline

  1. 打开侧边栏的 Cline 面板
  2. 勾选「Bring my own API Key」
  3. 进入 API 配置界面

步骤 3：填写 API 信息

  • API Provider：

    • - GPT / DeepSeek / Gemini 等选 OpenAI Compatible
    - Claude 系列选 Anthropic

  • Base URL：填写中转站地址
  • API Key：填写中转站令牌
  • Model ID：填写模型名称

步骤 4：保存并测试

保存配置后，在 Cline 面板中选择对应模型，发送测试消息确认正常。

四、常见问题排查

添加模型时验证失败

按以下顺序检查：

  1. Base URL 是否正确：OpenAI 服务商一般要加 /v1，Anthropic 服务商一般不加（因为工具可能自动拼了）
  2. API Key 是否有效：在中转站确认令牌状态正常、有余额
  3. 模型 ID 是否正确：中转站显示的名称和实际 API 调用 ID 可能不同，以中转站「模型广场」或文档为准
  4. 服务商是否选对：Claude 模型必须选 Anthropic，不能选 OpenAI

模型列表中找不到自定义模型

需要关闭 Auto Mode（自动模式），然后滑到模型列表最底部，自定义模型显示在那里。

Claude 模型连不上

最常见的两个原因：

  1. 服务商选成了 OpenAI → 改成 Anthropic
  2. Base URL 的 /v1 加没加对 → Anthropic 服务商一般不加，调不通就反过来试

响应很慢或超时

  • 中转站线路问题，尝试切换分组或线路
  • 部分中转站高峰期也会拥堵，选择倍率更高的线路通常更稳定
  • Trae 本身网络设置检查：头像 → 设置 → 代理设置

Cline 中 Claude 模型报错

如果通过 Cline 使用 Claude 模型仍有问题，可以尝试安装 Claude Code 插件：

  1. 确保已安装 Node.js（v18+）
  2. 终端运行：npm install -g @anthropic-ai/claude-code
  3. 配置环境变量：

    4. - ANTHROPIC_AUTH_TOKEN：你的 API Key
    - ANTHROPIC_BASE_URL：中转站地址
    - ANTHROPIC_MODEL：默认使用的 Claude 模型 ID

  4. 在 Trae 扩展商店搜索安装「Claude Code for VS Code」

五、总结

原生添加模型Cline 插件
配置难度简单中等
是否需要插件不需要需要安装 Cline
支持的模型范围取决于 Trae 版本更灵活
推荐场景大多数情况首选原生方式不支持时使用

最关键的三个要点：

  1. Claude 系列选 Anthropic 服务商，Base URL 一般不加 /v1
  2. 其他模型选 OpenAI 服务商，Base URL 一般要加 /v1
  3. 模型 ID 一定要用中转站实际支持的 ID，不是官方显示名