准备客户端和密钥
Windows 与 macOS 用户使用 TRAE 官方网站提供的、适配自己系统的客户端。Linux 是否存在官方 SOLO 发行版需在官方下载页核对；不能保证 Linux 桌面可用，可改用 Codex CLI 或 Claude Code。不要从非官方镜像安装软件。
在密钥管理为 TRAE 创建可外接组密钥。不要使用 Codex Pro（仅限Codex） 或 Claude Max（仅限CC），TRAE 不在这两个组的允许客户端中。费用见价格页。
打开自定义模型入口
打开设置，进入“模型”，选择“添加模型”，再进入“自定义配置”。界面名称可能随版本调整。先记录应用版本；若界面没有自定义接口功能，不要用官方账户登录字段代替。已有模型先保留，便于失败后切回。
按协议填写
| 项目 | OpenAI / Codex 路线 | Claude / Anthropic 路线 |
|---|---|---|
| 自定义名称 | MonkeyAI Codex | MonkeyAI Claude |
| 接口 base | https://monkeytheme.com/v1 | https://monkeytheme.com |
| 模型 ID 示例 | gpt-6.1-sol | claude-opus-4-8 |
| 组示例 | Codex Pro（外接版） | Claude Plus（精品） |
| 密钥 | YOUR_API_KEY | YOUR_API_KEY |
提供商应与接口协议一致。Codex 路线要求该版本支持 Responses；仅有 Chat Completions 的表单不能证明 Codex Responses 兼容。如果只有完整请求 URL 字段，先查该版本说明确认路径拼接方式，不盲目添加后缀。Claude 使用 Anthropic Messages，base 不手动带 /v1/messages。将自己的密钥私下输入密码字段，不写进模型显示名称。
保存并检查
保存后在会话中显式选择新模型，观察界面显示的模型 ID。用户可在确认费用后发送一个短提示词；请求会按实际用量计费。模型出现在下拉框不代表已经接通。
常见问题与恢复
401 检查密钥是否完整；403 检查是否误选仅限官方客户端的组；model_not_found 检查组与模型；404 或协议错误检查 Responses / Messages 支持及 base 拼接。若自定义提供商不支持所需协议，使用对应 CLI，不改写未经确认的配置文件。删除失败的自定义项或切回已有项即可恢复。截图排错前遮盖密钥、账户和私人会话。