Trae 接入指南
Trae 是字节跳动推出的 AI IDE，内置 AI 编程助手。本指南介绍如何在 Trae 中配置 AMAX Token Router 作为自定义模型提供商。
准备工作
- 已注册 AMAX Token Router 账号并 获取 API Key
- 已安装 Trae IDE（官方下载 ）
- Trae 版本 ≥ v3.5.51（该版本起支持自定义模型 URL）
配置步骤
1. 打开模型设置
在 Trae IDE 中：
- 点击左下角齿轮图标进入 Settings
- 选择左侧 Models 选项卡
- 点击 Add Model 按钮
2. 选择自定义配置
在弹出的对话框中，切换到 Custom Config 标签页。
3. 填写配置信息
| 字段 | 值 | 说明 |
|---|---|---|
| API Format | OpenAI Chat Completions | 兼容 OpenAI /v1/chat/completions 协议 |
| Full URL | OFF（使用 Base URL 模式） | |
| Base URL | https://ai.amaxsmp.com/v1 | AMAX Token Router 的 API 地址 |
| Model ID | gpt-4o | 要使用的模型名称，也支持 claude-sonnet-4-6、deepseek-chat 等 |
| API Key | sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | 在 AMAX 控制台获取的 Key |
| Multimodal | 按需开启 | 如果模型支持图片输入则开启 |
4. 保存并验证
点击 Add Model，Trae 会自动验证配置：
- 验证通过：模型出现在可用模型列表中
- 验证失败：检查错误信息，确认 URL、Key 和模型名是否正确
5. 使用模型
配置完成后，在 Trae 的模型选择器中即可选择你刚添加的自定义模型。
模型推荐
通过 AMAX Token Router，你可以在 Trae 中使用 62 个模型，推荐的编程模型：
| 模型 | 适用场景 |
|---|---|
gpt-4o | 通用编程 |
claude-sonnet-4-6 | 复杂逻辑、大型重构 |
deepseek-chat | 高性价比日常编程 |
amax-router | 智能路由，自动选最优模型 |
常见问题
验证失败
- 确认 Base URL 包含
/v1后缀 - 确认 API Key 格式为
sk-开头 - 确认 Key 未被禁用、余额充足
- 查看 Trae 的日志输出获取详细错误信息
工具调用不生效
确认 API Format 选择了 OpenAI Chat Completions（而非 Anthropic Messages），因为 OpenAI 格式的工具调用兼容性更广。
模型回复异常
不同模型在编码风格上可能有差异，建议固定使用一个熟悉的主流模型作为日常编程模型。