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-5-5

支持的模型 ID（示例）：

  • claude-opus-5-5

    适合复杂任务

  • claude-sonnet-5-5

    均衡性能

  • gpt-6.1-sol

    GPT 日常主力

  • gpt-6-luna

    经济高效

  • gemini-4-argon

    高级推理

  • gemini-3.8-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 密钥无效
  • 仔细检查复制的完整 API 密钥，确保没有多余空格
  • 验证密钥以 sk- 开头
  • 确保 AIDesk 账户处于活跃状态且有额度
  • 从控制台生成新的 API 密钥
模型未找到
  • 验证模型 ID 格式是否正确（例如：claude-sonnet-5-5）
  • 通过 /v1/models 接口确认支持的模型 ID
  • 确保该模型在你的 AIDesk 账户中可用
速率限制超限
  • 稍等片刻后重试
  • 检查 AIDesk 账户的使用限制
  • 如需更高的速率限制，考虑升级你的计划