Trae (TraeCode / TraeWork) 配置指南

Trae（字节跳动推出的自适应 AI IDE / 工作区）具备强大的全项目代码感知与自主工程 Agent 协作能力。通过接入 BBToken（https://bbtoken.boywe.cn），可以直连调用平台提供的 deepSeek-V4-flash、bbqwen3.8-flash-next 等满血高并发大模型。

📸 配置界面参考

Trae 模型管理与编辑弹窗

⚡ 核心参数速查

配置项	填写内容	说明
API 格式	`OpenAI Chat Completions 格式`	必填，下拉菜单中选择此项
自定义请求地址	`https://bbtoken.boywe.cn/v1`	必填，末尾必须带 `/v1`，且不要以斜杠结尾
完整 URL 开关	保持默认（关闭）	系统会自动在地址末尾拼接 `/chat/completions`
模型 ID	`deepSeek-V4-flash` 或 `bbtoken-DeepSeek-V4-Flash`	必填，平台支持的模型标识（不可手打拼错）
模型展示名称	`bbtoken-DeepSeek-V4-Flash` (可选自定义)	在 Trae 对话下拉菜单中呈现的名称
API 密钥	`sk-xxxxxxxxxxxxxxxxxxxxxxxx`	必填，粘贴 BBToken 生成的有效令牌

📖 详细图文操作步骤

第一步：进入模型管理设置

打开 Trae 编辑器客户端。
点击左下角头像或进入系统设置面板，在左侧导航栏中找到 「模型」（位于「权限审批」和「MCP」下方）。
点击进入后，主界面将展示 「模型管理」 面板。

第二步：添加/编辑模型

在模型管理列表右上角，点击 「+ 添加模型」 按钮，弹出 「编辑模型」 对话框。
依次填入各项连接参数：
- API 格式：点击下拉框，选中 OpenAI Chat Completions 格式；
- 自定义请求地址：填入 https://bbtoken.boywe.cn/v1；
  
  [!IMPORTANT] 请注意输入框下方的系统提示：「请填写兼容 OpenAI API 的服务端点地址，不要以斜杠结尾。/chat/completions 将会被补充到你填写的地址末尾。」
  请确保末尾无多余斜杠（即不要填写为 .../v1/）。
- 模型 ID：输入平台提供的可用模型标识，例如：
  - deepSeek-V4-flash（或别名 bbtoken-DeepSeek-V4-Flash、cctoken-deepseek-v4-flash）
  - bbqwen3.8-flash-next
  - glm-4.7-flash
  - nanbeige4.2
- 模型展示名称：可输入易于识别的备注，如 bbtoken-DeepSeek-V4-Flash 或 BBToken - Qwen3.8；
- API 密钥：粘贴你的 sk-xxxxxxxxxxxxxxxxxxxxxxxx 密钥。

第三步：测试与保存

点击弹窗右下角的 「保存模型」 按钮。
保存时，Trae 会自动发起一次真实的连通性测试。测试通过后，弹窗关闭，新模型随即出现在模型管理列表中。
检查列表中该模型右侧的操作开关，确保绿色启用开关处于打开状态。

第四步：在会话中选用模型

返回 Trae 工作区，打开右侧的 AI 聊天窗口（快捷键 Ctrl + U 或 Ctrl + L）。
在输入框底部的模型切换菜单中，展开自定义模型列表，选中刚刚添加的模型（如 bbtoken-DeepSeek-V4-Flash）。
发送一句测试提示词（如「你好，帮我写一个 TypeScript 防抖函数」），若能以打字机流式快速输出，即代表接入成功！

🛑 常见避坑排错

WARNING

1. 保存时连通性测试报错（如 404 或超时）：

检查「自定义请求地址」是否有多余末尾斜杠（正确为 https://bbtoken.boywe.cn/v1，错误为 https://bbtoken.boywe.cn/v1/）。
检查是否误开了右侧的「完整 URL」开关。若开启该开关，必须写全完整路径 https://bbtoken.boywe.cn/v1/chat/completions。

TIP

2. 推荐多模型组合配置：
建议在 Trae 中配置两个模型并存：

主力编码推理：配置 deepSeek-V4-flash（别名 bbtoken-DeepSeek-V4-Flash），适合复杂代码重构与全库分析；
快速辅助补全：配置 bbqwen3.8-flash-next，适合行间秒级补全与轻量日常问答。