trae提示401 unauthorized通常因base url与api key不匹配所致：需确保url完整到接口层级（如/v1/chat/completions），协议类型与服务严格一致，并通过curl或控制台验证密钥所属区域及权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Trae填写Base URL后提示401 Unauthorized或“鉴权失败”，说明API Key虽已输入，但服务端拒绝承认其有效性——这通常不是密钥本身错误，而是Base URL路径、协议或域名与密钥所属平台不匹配导致签名验证直接被拦截。
先确认 Base URL 是否完整到接口层级
TRAE v3.3.51 起强制要求填写完整 endpoint，不能只填域名或网关根地址。例如阿里云百炼必须写成 【https://coding.dashscope.aliyuncs.com/v1/chat/completions】，少一个 /v1/chat/completions 就会返回 401。
OpenAI 兼容接口必须以 /v1/chat/completions 结尾；Anthropic 接口必须以 /messages 结尾；火山 CodingPlan 的 OpenAI 协议地址必须是 https://ark.cn-beijing.volces.com/api/coding/v3，而非 /api/v3。
这一步操作起来很简单，直接复制服务商文档里明确标注的「请求地址」整段粘贴进去就行。
检查 API Key 是否与 Base URL 所属平台一致
方法一：用 curl 直连验证
打开终端，执行以下命令（把 sk-xxx 换成你的实际密钥，URL 换成你填进 TRAE 的完整 Base URL）：
curl -I -H "Authorization: Bearer sk-xxx" https://coding.dashscope.aliyuncs.com/v1/models
如果返回 HTTP/2 200，说明密钥和地址匹配；若返回 401，大概率是密钥来自百炼国际站，却配在国内站地址，或反过来。
方法二：登录对应平台控制台核对
阿里云百炼 → DashScope 控制台 → API-KEY 管理页 → 确认该 Key 的「区域」和「服务权限」是否覆盖你填写的 Base URL 所属服务。比如 coding.dashscope.aliyuncs.com 属于国内站，Key 必须在「中国内地」区域创建且已开通 qwen-max 调用权限。
排查环境变量或配置文件干扰
第一步：打开 TRAE 设置 → Models → 找到你刚添加的模型 → 点击编辑 → 查看 API Key 字段是否显示为 from environment。
第二步：如果显示这个，说明 TRAE 正在读取系统环境变量，而不是你手动填的 Key。此时需运行 env | grep -i "api_key" 查看是否有拼写错误的变量（如 TRAEE_APIKEY 少个 s），或多个 Key 变量冲突。
第三步：临时绕过环境变量，在 TRAE 模型配置中显式填入 Key，保存后重试。这能快速判断问题是否出在变量注入环节。
核对协议类型与 Base URL 是否配套
① 在 TRAE 添加模型时，“协议类型”下拉菜单必须与 Base URL 对应的服务协议严格一致。
② 填了 OpenAI 协议类型的地址，就不能指向 Anthropic 的 /messages 接口；反之亦然。
③ 火山 CodingPlan 明确要求使用 OpenAI 协议，所以协议类型选 OpenAI，Base URL 必须是 https://ark.cn-beijing.volces.com/api/coding/v3 ——填错协议类型会导致 TRAE 自动拼接错误路径，比如在 Anthropic 地址后硬加 /chat/completions，结果 404 或 401。
④ 如果你用的是 Code0 中转服务，确认它当前支持的是 OpenAI 还是 Anthropic 协议，再决定协议类型选哪一项。
