在 Trae 中配置 DeepSeek API:从申请 Key 到跑通对话
说明:Trae 版本更新较快,不同版本的设置入口可能叫“模型服务”“自定义模型”或“OpenAI Compatible”。下面按通用流程写,实际菜单以你的客户端为准。
一、先准备三样东西
在 Trae 里接 DeepSeek,本质上不是“登录 DeepSeek 网页版”,而是把 DeepSeek 的 API 当成一个模型服务接进去。你需要准备:
- API Key:在 DeepSeek 开放平台创建,通常以
sk-开头。 - Base URL:最新版本可以直接选择服务商
DeepSeek。 - 模型名:常用
deepseek-v4-flash;需要推理任务时可用deepseek-v4-pro。
二、创建 DeepSeek API Key
登录 DeepSeek 开放平台,进入 API Key 管理页面,创建一个新的 Key。创建后先复制保存,因为很多平台不会再次完整展示。
几个注意点:
- 不要把 Key 截图发到群里,也不要写进代码仓库。
- Key 和 DeepSeek 网页版账号密码不是一回事。
- 如果调用失败,先检查账户余额、Key 是否复制完整、是否被删除或禁用。
三、在 Trae 中添加模型
打开 Trae 的设置,寻找添加模型相关的入口。常见操作顺序是:
- 点击
添加模型。 - 服务类型选择
DeepSeek或自定义。 - 填入 Base URL 和 API Key。
- 添加模型名
deepseek-v4-flash。 - 保存,并把该模型设为当前对话使用的模型。
参数可以按下面这样填:
| 项目 | 建议值 |
|---|---|
| 服务商 | DeepSeek |
| API密钥 | 你的 DeepSeek Key |
| 模型 | deepseek-v4-flash |
四、跑通验证
新建一个对话,确认当前模型是刚添加的 DeepSeek Chat,然后问一个简单问题,例如“用一句话解释什么是闭包”。能正常返回,说明 Key、地址和模型名基本正确。
再做一个稍微严格的测试:让它输出一段 JSON,或让它解释一段报错信息。这样能看出模型是否真的在工作,而不是界面显示成功但请求没发出去。
常见报错可以这样排查:
- 401:认证失败、Key 不对、复制不完整,或请求发到了不匹配的服务。
- 402:余额不足。
- 422 参数错误。
- 429:触发限流或额度不足,检查账户状态。
- 超时:检查网络、代理或防火墙设置。
五、deepseek-v4-flash 和 deepseek-v4-pro 怎么选
日常写代码、改注释、解释报错,用 deepseek-v4-flash 就够。需要更复杂的推理、方案对比或多步分析时,可以再建一个 deepseek-v4-pro 的模型条目。两者可以同时存在于 Trae 的模型列表里,按任务切换。
六、安全习惯
API Key 只保存在客户端的凭据管理里,不要硬编码到项目文件。团队使用时,建议每人使用独立 Key,方便追踪用量和轮换。公开仓库提交前检查是否误传了 .env 或配置文件。
配置完成后,先在聊天和代码问答里验证;如果 Trae 的某些补全功能不支持自定义模型,以客户端实际能力为准,不要强行套用。