TRAE 配置¶

TRAE 是字节跳动推出的 AI 原生 IDE，内置 AI 对话、代码补全与智能体（Builder / Agent）能力。 通过添加「自定义模型」，即可在 TRAE 中直接调用 Rutaceae API 提供的 Claude、GPT、Gemini 等模型。

TRAE 是图形界面工具，所有配置都在软件内完成，无需手动创建配置文件。

准备工作¶

• 下载并安装 TRAE：
  • 国际版：https://www.trae.ai
  • 国内版：https://www.trae.com.cn
• 支持 Windows 与 macOS，按系统选择对应安装包，双击安装后启动即可。

第一步：获取 API 令牌¶

1. 访问 https://api.rutaceae.com/keys

2. 点击「添加令牌」

3. 选择包含目标模型的分组（可前往模型广场查看：https://api.rutaceae.com/pricing）

4. 令牌名称：随意填写（如 "TRAE"）

5. 额度建议：设置为无限额度

6. 其他选项保持默认

7. 点击确认，复制生成的令牌（形如 sk-xxxxxxxxxxxxxxxx）

第二步：打开模型设置¶

1. 启动 TRAE，点击右侧的 AI 对话（Chat / Builder）面板将其展开。

2. 在对话输入框底部找到模型选择器（显示当前模型名称的下拉按钮），点击展开。

3. 在弹出的菜单中点击「管理模型 / 添加模型」入口（部分版本为齿轮 ⚙ 设置图标）。

第三步：添加自定义模型¶

不同厂商的模型需要使用不同的接入端点：GPT 走 OpenAI 格式端点，Claude 走 Anthropic 原生端点，两者不可混用。请按模型类型分别添加。

在模型配置窗口点击「+ 添加模型」，然后按下表填写对应字段，完成后点击保存 / 确认。

GPT 等 OpenAI 格式模型¶

Claude 模型（Anthropic 原生格式）¶

提示：

• 两类端点的关键区别：OpenAI 格式的 Base URL 带 /v1，Anthropic 原生格式的 Base URL 为根地址（不带 /v1）。
• 模型 ID 必须与模型广场（https://api.rutaceae.com/pricing）中的名称完全一致；若某个模型不可用，请确认所选分组是否包含该模型。
• Gemini 等其他模型若以 OpenAI 兼容方式调用，同样使用 https://api.rutaceae.com/v1 端点。

第四步：选择并使用模型¶

1. 回到 AI 对话框，点击模型选择器，选择刚刚添加的自定义模型。

2. 在对话框中输入问题或指令，即可开始使用。🚀

常见问题¶