# TRAE

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

本文介绍如何配置方舟 Agent Plan 到 TraeCode 中使用。

<span id="f7095ac5"></span>
# 一、前提条件

* 您已按需订阅 Agent Plan 套餐。如未，请访问 [开通管理-Agent Plan](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan?agentMode=close) 页面订阅套餐。

* 您已正确安装 TraeCode，如未，请访问 [TraeCode 官网](https://www.trae.cn/) 下载并安装对应操作系统的版本。
<span id="3ef00eb4"></span>
# 二、配置 TraeCode

> **说明**
>
> 请先将 TraeCode IDE 升级至 3.3.57 及以上版本，再进行 Agent Plan 配置。

1. 根据个人用户入口登录后，进入设置中心添加模型。

    1. 选择**个人用户**入口登录后，点击界面右上角的 **设置** 图标，进入设置中心。

    2. 在左侧导航栏中，选择 **模型**，在模型管理页面进行配置。

    3. 点击 **+ 添加模型** 按钮，界面上显示 **添加模型** 窗口。

2. 在**添加模型**窗口中，配置模型信息。
    1. 选择服务商：**火山引擎**
    2. 配置方式：**Agent Plan**
    3. 选择模型。
        * 直接从列表中选择提供的模型。
        * 若希望使用 Agent Plan 支持的其他模型，单击**使用其他模型**，**模型 ID** 需使用**文本生成模型**的名称，详细模型名称参见 [支持模型及 Harness](/docs/agent-plan-personal-plan-overview#3d801f5f)。
    4. 填写 API 密钥：[获取专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan)
        ![image-20260908-203322-616.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260908-203322-616.png)
    5. 单击**添加模型**，完成模型的配置。

<span id="72fe9f62"></span>
# 三、使用 TraeCode

在 AI 对话输入框的右下角，单击当前模型名称，在模型列表中，选择配置的模型。
选定模型后，即可使用 TraeCode 进行开发任务了。

<span id="3dee0ce9"></span>
# 其他操作

<span id="115c56e2"></span>
## 添加图片生成/视频生成能力

方舟 Agent Plan Medium 及以上套餐提供图片生成模型配额，Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见：[配置视觉模型](/docs/agent-plan-personal-visual-models)。

> **注意**
>
> * 不同的套餐支持的视觉模型有所不同，具体参见[支持模型及 Harness](/docs/agent-plan-personal-plan-overview#3d801f5f)。
> * 视觉模型不支持通过 Auto 及控制台切换使用。

<span id="f6f52598"></span>
## 切换模型

你可以随时根据需求切换**文本生成模型**。

|配置方式 |通过控制台 |通过TraeCode |
|---|---|---|
|切换模型操作 |1. 参考[二、配置 TraeCode](/docs/agent-plan-personal-trae#3ef00eb4)，配置模型名称为`ark-code-latest`。 |1. 参考[二、配置 TraeCode](/docs/agent-plan-personal-trae#3ef00eb4)，添加模型信息。 | \
| |2. 在 [开通管理页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan) 选择要使用的模型，切换后3-5分钟即可生效。 |2. 在 AI 对话输入框的右下角，单击当前模型名称，在模型列表中，选择配置的模型。 |
