Trae IDE 配置指南
什么是 Trae IDE
Trae IDE 是一个由字节跳动开发的 AI 编程助手，支持通过内置的 Cline 插件连接第三方 API。
注意
Trae IDE 本身已移除自定义服务商、自定义 Base URL 的官方入口，仅支持内置合作模型。通过 Cline 插件是唯一可行方案。
安装 Cline 插件
- 打开 Trae IDE
- 点击左侧活动栏的 Extensions（扩展）图标
- 搜索 Cline（认准狐狸头官方 logo）
- 点击 Install 安装
配置 API
1. 获取 API 密钥
- 登录 ai.TokenHub 后台
- 进入"令牌"页面
- 点击"添加令牌"获取 API Key（以
sk-开头）
2. 配置 Cline
- 点击 Trae 左侧活动栏的 Cline 图标
- 进入 Settings（设置）页面
- 找到 API Configuration（API 配置）部分
- 选择 Custom API Endpoint（自定义 API 端点）
3. 填写配置信息
| 参数 | 值 | 说明 |
|---|---|---|
| Base URL | https://ai-tokenhub.com/v1 | API 服务地址 |
| API Key | sk-xxxxxxxxxxxxxxxx | 您的 API 密钥 |
| Model ID | claude-sonnet-4-20250514 | 要使用的模型名称 |
提示
Model ID 需要与 ai.TokenHub 平台上支持的模型名称完全匹配，大小写敏感。可在平台的"模型广场"页面查看可用模型列表。
4. 保存配置
配置填写完成后，点击保存。配置实时生效，无需重启 Trae IDE。
常用配置示例
Claude 模型
| 参数 | 值 |
|---|---|
| Base URL | https://ai-tokenhub.com/v1 |
| Model ID | claude-sonnet-4-20250514 |
GPT 模型
| 参数 | 值 |
|---|---|
| Base URL | https://ai-tokenhub.com/v1 |
| Model ID | gpt-4o |
DeepSeek 模型
| 参数 | 值 |
|---|---|
| Base URL | https://ai-tokenhub.com/v1 |
| Model ID | deepseek-v3 |
插件自动化设置
在 Cline Settings 中可以配置插件的自动化行为：
- Auto-approve（自动批准）：设置是否自动同意插件执行文件读写和安全命令
- 建议根据需要谨慎配置，避免安全风险
常见问题
请求失败 404
检查 Base URL 是否正确，末尾不要有多余的 /。
认证失败 401
检查 API Key 是否正确，确保没有多余的空格或字符。
模型未找到
确保 Model ID 与平台上支持的模型名称完全匹配，大小写敏感。
网络连接超时
检查网络连接，确保可以访问 https://ai-tokenhub.com。