trae配置自定义模型时base url必须为完整端点,v3.3.51以下版本不支持;openai兼容需填如https://code0.ai/v1/chat/completions,claude兼容则须用/messages路径且不可混用协议。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Trae中配置自定义模型时,输入Base URL后提示“Base URL错误”,不是密钥失效也不是网络不通,而是Trae对URL格式有硬性要求——它不拼接路径,只认完整端点。
确认Trae版本是否支持完整BaseURL
打开Trae → 右上角头像 → 「设置」→ 「关于」,检查版本号。低于 【v3.3.51】 的版本根本不支持手动填写完整接口路径,所有自定义模型配置都会被截断或忽略。旧版即使填了https://xxx.com/v1/chat/completions,内部也会强行删掉/chat/completions部分,导致请求发到根路径返回404。
必须升级到v3.3.51或更高版本,否则后续所有操作都无效。
OpenAI兼容模型:Base URL必须精确到/chat/completions
方法一:直接填写完整端点(推荐)
在「模型管理」→「添加模型」→「自定义」中,API URL栏粘贴:https://code0.ai/v1/chat/completions
注意:不能只写https://code0.ai/v1,也不能写https://code0.ai —— Trae不会自动补/chat/completions,少一个字符就报错。
方法二:验证服务商文档中的真实端点
例如接入阿里云百炼,官方接口是POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation,但它不兼容OpenAI格式;而百炼提供的OpenAI兼容网关地址才是https://coding.dashscope.aliyuncs.com/v1/chat/completions —— 必须用后者,前者填进去必然报错。
方法三:用curl快速验证端点有效性
终端执行:curl -X POST https://your-base-url.com/v1/chat/completions -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"gpt-3.5-turbo","messages":[{"role":"user","content":"hi"}]}'。如果返回JSON含choices字段,说明端点可用;若返回404、401或空响应,则URL本身就不通,别往Trae里填。
Claude兼容模型:Base URL必须带/messages且不可混用
第一步:进入模型配置页,Provider类型必须选「Anthropic Compatible」
第二步:Base URL填入 https://api.anthropic.com/v1/messages 或中转服务对应地址(如https://www.moyu.info/v1/messages)
第三步:Model ID必须明确指定,例如claude-3-5-sonnet-20240620,不能留空或填gpt-4o这类OpenAI模型ID
⚠️ 重要提醒:【绝对不可把Claude的Base URL和OpenAI的混用】。比如用https://code0.ai/v1/messages配claude-opus-4-7,会触发400错误;反过来用https://api.anthropic.com/v1/chat/completions配任何模型,必定404。协议层不匹配,Trae底层直接拒绝发起请求。
本地Ollama或FastAPI服务:Base URL末尾不能加斜杠
如果你跑的是本地Ollama,默认地址是http://localhost:11434/api/chat,那就填这个完整路径,不要多加/,也不要少/api/chat。
常见错误写法:http://localhost:11434/ → 缺少/api/chat,Trae发请求后返回404 Not Found
另一个常见错误:http://localhost:11434/api/chat/ → 末尾多了一个/,某些FastAPI服务会重定向或报405,Trae收到非200响应即判定Base URL错误
这一步操作起来很简单,直接把服务启动后浏览器访问该URL看能否返回JSON schema即可验证。










