Trae 设置

配置 Trae IDE 使用 AIDESK API。

Trae 是字节跳动推出的 AI 原生 IDE，基于 Visual Studio Code 构建。通过配置 AIDESK，即可调用各种强大的模型进行代码补全、对话辅助、重构和生成。

前置条件

  • 一个 AIDESK 账户和 API Key
  • 已安装 Trae IDE（支持 macOS 和 Windows）
前往创建 API Key

配置步骤

按照以下三步配置 Trae 使用 AIDESK API。

1打开模型设置

有两种方式访问模型配置：

方法 A：通过对话输入框

  1. 打开 Trae IDE
  2. 查看对话输入框的右下角
  3. 点击当前模型名称打开模型列表
  4. 点击「添加模型」按钮

方法 B：通过设置菜单

  1. 点击右上角的头像
  2. 选择「AI 功能管理」
  3. 进入「模型」部分
  4. 点击「添加模型」按钮
2配置自定义模型

在「添加模型」对话框中，填写以下字段：

字段值
供应商 (Provider)OpenAI
基础 URL (Base URL)https://api.aideskapp.com/v1
API 密钥 (API Key)sk-aidesk-YOUR_KEY
模型 ID (Model ID)claude-sonnet-4-6

支持的模型 ID（示例）：

claude-opus-4-7

适合复杂任务

claude-sonnet-4-6

均衡性能

gpt-5.4

GPT 旗舰模型

gpt-4.1

经济高效

gemini-2.5-pro

高级推理

gemini-2.5-flash

快速高效

3保存配置
  1. 点击「添加模型」或「保存」按钮确认设置
  2. Trae 将尝试验证与 AIDESK API 的连接
  3. 如果成功，你的自定义模型将出现在模型列表中

验证配置

  1. 打开对话面板：点击左侧边栏的对话图标，或使用命令面板（Ctrl/Cmd + Shift + P）搜索「Chat」
  2. 选择自定义模型：在对话面板中，点击右下角的模型下拉菜单，选择你刚添加的 AIDESK 模型
  3. 测试简单查询：提出一个编程问题，例如 用 Python 写一个递归计算斐波那契数列的函数
  4. 验证响应：如果 Trae 使用你的自定义模型成功生成了代码，说明配置已正确完成

也可以通过 curl 测试 API 连接：

curl https://api.aideskapp.com/v1/models \
  -H "Authorization: Bearer sk-aidesk-YOUR_KEY"

使用方法

配置完成后，在对话面板的下拉菜单中选择 AIDESK 模型即可开始使用。你可以通过对话提问、请求代码生成，也可以选中代码右键使用 AI 操作（解释、重构等）。使用 # 符号引用文件以获得上下文感知的响应。

使用多个模型

为每个需要使用的模型重复配置步骤，使用相同的 Base URL 和 API Key，只需更改模型 ID。配置完成后可在对话面板的下拉菜单中切换。

常见问题

  • 验证基础 URL 是否准确为 https://api.aideskapp.com/v1（不带尾部斜杠）
  • 检查网络连接是否正常
  • 确保 API 密钥有效且有足够的额度
  • 仔细检查复制的完整 API 密钥，确保没有多余空格
  • 验证密钥以 sk- 开头
  • 确保 AIDESK 账户处于活跃状态且有额度
  • 从控制台生成新的 API 密钥
  • 验证模型 ID 格式是否正确（例如：claude-sonnet-4-6）
  • 通过 /v1/models 接口确认支持的模型 ID
  • 确保该模型在你的 AIDESK 账户中可用
  • 稍等片刻后重试
  • 检查 AIDESK 账户的使用限制
  • 如需更高的速率限制，考虑升级你的计划