TRAE | MaiToken

适合希望在 TRAE 的 Chat 或 Agent 中使用 MaiToken 模型的用户。

打开模型管理： 打开 TRAE，进入账户或设置页面，在左侧找到“模型”，然后单击“添加模型”。不同版本也可能需要从聊天框的模型下拉菜单进入。
展开自定义配置： 选择“自定义配置”或“添加自定义模型”。
选择 API 格式： 选择 OpenAI Chat Completions 格式，不要选择 Anthropic Messages。
打开完整 URL： 如果界面提供“完整 URL”开关，请将其打开。打开后，TRAE 会直接使用填写的地址，不再自动拼接请求路径。
填写请求地址： 输入 https://api.maitoken.com/v1/chat/completions 。这是完整请求 URL。
填写模型 ID： 将 <模型ID> 替换为 API Key 模型限制列表中显示的准确 ID。建议将显示名称设置为 MaiToken - 模型ID。
填写 API 密钥： 粘贴您自己的 MaiToken Key。只粘贴 Key 本身，不要手动添加 Bearer。
保存配置： 单击“提交”或“保存”。回到聊天面板，关闭 Auto，然后选择刚刚创建的 MaiToken 模型。

字段	填写内容
API 格式	`OpenAI Chat Completions`
完整 URL	https://api.maitoken.com/v1/chat/completions
模型 ID	`<模型ID>`
API 密钥	`<你的 MaiToken Key>`

如果界面没有“完整 URL”开关，请先升级 TRAE。如果当前版本只允许填写 Base URL，请填写 https://api.maitoken.com/v1 ；如果既没有 Base URL，也没有自定义请求地址，则该版本暂不适合使用本教程。

测试普通对话： 在聊天框中输入“只回复 OK”。如果收到正常回复，说明 API Key、请求地址和模型 ID 基本正确。
测试项目读取： 打开一个测试项目，输入“请读取当前项目目录，只列出一级文件名，不要修改任何文件。”
测试 Agent： 让 Agent 新建一个名为 test-maitoken.txt 的文件并写入 hello，然后确认文件已经生成。请勿使用真实生产项目进行测试。

问题	处理建议
404 Not Found	检查是否重复拼接了 `/chat/completions`。完整 URL 中应当只有一段 `/v1/chat/completions`。
保存后找不到模型	关闭 Auto 模式，然后在聊天框的模型选择器中查找自定义模型。
可以聊天但不能修改文件	换用支持 `tool_calls` 的模型，并确认当前使用的是 Agent 模式，而不是普通 Chat 模式。