Trae
在 Trae IDE 中使用 TokenByte
Trae 是字节跳动推出的 AI 原生 IDE,内建 Chat、Builder 与 Agent 模式。Trae 没有独立的「OpenAI 兼容」通用供应商,但它的 OpenAI 与 Anthropic 供应商均支持通过 Custom Request URL 重定向到第三方端点,因此可以用这两条路径之一接入 TokenByte。
前置条件
- 已安装 Trae IDE 桌面端(IDE 模式或 SOLO 模式均可)
- 已在 TokenByte 控制台 创建 API Key
配置
打开模型设置
点击 Trae 窗口右上角的 Settings 图标(SOLO 模式下在聊天面板右上角),左侧导航选择 Models,然后点击右上角 + Add Model,弹出 Add Model 窗口。
选择 Provider 并填写自定义 URL
TokenByte 支持两条接入路径,二选一即可:
- Provider:OpenAI
- Model:点击 Other Models,手动输入模型 ID,例如
gpt-5.4、claude-sonnet-4-5、gpt-5-codex - API Key:粘贴 TokenByte Key(以
sk-tb-开头) - Custom Request URL:
https://api.tokenbyte.ai/v1/chat/completions
Trae 在此处要求填入完整的请求路径,而不是 Base URL。这条路径可以路由 TokenByte 背后的任何模型家族(含 Claude、Gemini 等),模型 ID 使用 TokenByte 侧的命名即可。
- Provider:Anthropic
- Model:点击 Other Models,手动输入 Claude 模型 ID,例如
claude-sonnet-4-5、claude-opus-4-6 - API Key:粘贴 TokenByte Key
- Custom Request URL:
https://api.tokenbyte.ai/v1/messages
此路径仅能使用 Claude 家族模型。要混用其他家族,请选 OpenAI 路径。
填写完成后点击 Add Model。Trae 会立即向供应商发起一次校验请求,Key / URL / Model ID 任一有误都会在弹窗中显示错误日志。
在对话中选用
回到 Chat / Builder / Agent 面板,点击顶部的模型下拉,即可看到刚刚添加的 TokenByte 模型。创建自定义 Agent 时,也可以在 Agent 配置中的 Use custom models 区段指定该模型。
验证
在 Chat 面板中发起一条简单请求,例如「用三句话介绍当前项目」。若能正常返回,接入成功。
在 Settings → Models 中可以随时 Enable / Disable 或删除自定义模型。被 Disable 的模型保留在列表中,但不会出现在模型选择器里,便于按需开关而无需重新填写 Key。
Trae 的行内补全(Tab 键触发)由内置的 Tab-Cue 引擎驱动,不接受自定义供应商——TokenByte 的配置只对 Chat / Builder / Agent 生效。如果希望补全也走 TokenByte,需使用第三方补全扩展或其他 IDE。
遇到问题?参考 常见问题。