本文介绍如何配置方舟 Agent Plan 到 TraeCode 中使用。 # 一、前提条件 * 您已按需订阅 Agent Plan 套餐。如未，请访问 [开通管理-Agent Plan](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan?agentMode=close) 页面订阅套餐。 * 您已正确安装 TraeCode，如未，请访问 [TraeCode 官网](https://www.trae.cn/) 下载并安装对应操作系统的版本。 # 二、配置 TraeCode

说明

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

1. 根据个人用户入口登录后，进入设置中心添加模型。 1. 选择**个人用户**入口登录后，点击界面右上角的 **设置** 图标，进入设置中心。 2. 在左侧导航栏中，选择 **模型**，在模型管理页面进行配置。 3. 点击 **+ 添加模型** 按钮，界面上显示 **添加模型** 窗口。 2. 在**添加模型**窗口中，配置模型信息。 1. 选择服务商：**火山引擎** 2. 配置方式：**Agent Plan** 3. 选择模型。 * 直接从列表中选择提供的模型。 * 若希望使用 Agent Plan 支持的其他模型，单击**使用其他模型**，**模型 ID** 需使用**文本生成模型**的名称，详细模型名称参见 [支持模型及 Harness](https://ark.volcengine.com/region:cn-beijing/docs/82379/2366394?lang=zh#3d801f5f)。 4. 填写 API 密钥：[获取专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan) ![图片](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260908-203322-616.png) 5. 单击**添加模型**，完成模型的配置。 # 三、使用 TraeCode 在 AI 对话输入框的右下角，单击当前模型名称，在模型列表中，选择配置的模型。选定模型后，即可使用 TraeCode 进行开发任务了。 # 其他操作 ## 添加图片生成/视频生成能力方舟 Agent Plan Medium 及以上套餐提供图片生成模型配额，Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见：[配置视觉模型](https://ark.volcengine.com/region:cn-beijing/docs/82379/2375486?lang=zh)。

注意

不同的套餐支持的视觉模型有所不同，具体参见支持模型及 Harness。

视觉模型不支持通过 Auto 及控制台切换使用。

## 切换模型你可以随时根据需求切换**文本生成模型**。 |配置方式 |通过控制台 |通过TraeCode | |---|---|---| |切换模型操作 |1. 参考[二、配置 TraeCode](https://ark.volcengine.com/region:cn-beijing/docs/82379/2389869?lang=zh#3ef00eb4)，配置模型名称为`ark-code-latest`。

2. 在 [开通管理页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan) 选择要使用的模型，切换后3\-5分钟即可生效。 |1. 参考[二、配置 TraeCode](https://ark.volcengine.com/region:cn-beijing/docs/82379/2389869?lang=zh#3ef00eb4)，添加模型信息。

2. 在 AI 对话输入框的右下角，单击当前模型名称，在模型列表中，选择配置的模型。 |

火山方舟