TRAE Work
TRAE Work 桌面版支持添加自定义模型,可通过 OpenAI Chat Completions 或 Anthropic Messages 接入 Geekit。当前官方配置没有公开 Responses 选项,因此不要把 Codex CLI 的 Responses 配置直接套用到 TRAE Work。
核验日期:2026-07-27
前置条件
- 已从 TRAE Work 官方页面安装或更新支持自定义模型的桌面版。
- 已取得 Geekit 根地址、用户令牌和模型 ID。
- 已确认模型支持 TRAE Work 需要的工具调用和上下文。
使用 OpenAI Chat
在 TRAE Work 的模型设置中添加自定义模型,选择 OpenAI Chat Completions 格式,并填写:
推荐开启“完整 URL”,这样客户端不会再次拼接路径。若当前版本只接受基础地址,则关闭该开关并填写 https://geekit.yryq.top/v1,保存后确认实际请求仍为 /v1/chat/completions。
使用 Anthropic Messages
Claude 模型可选择 Anthropic Messages 格式:
只有模型确实兼容 Anthropic Messages 时才使用此选项。把普通 OpenAI Chat 模型改成 Anthropic 格式不会自动获得 Claude 工具调用能力。
模型能力
高级设置中的模型系列、上下文窗口、输出上限、多模态和工具调用轮次,应按模型真实能力填写:
- 纯文本模型不要开启图片输入。
- 上下文窗口不要超过模型或 Geekit 实际限制。
- 工具调用异常时,先用简单文本请求确认连接,再检查模型协议能力。
验证
保存后在 TRAE Work 中执行一个只读最小任务,并同时检查 Geekit 调用日志:
- 请求端点为
/v1/chat/completions或/v1/messages。 - 模型 ID 与设置一致。
- 流式输出能够正常结束。
- 工具调用可执行,而不是输出未处理的 JSON。
TRAE Work 的自定义模型仅在本地桌面环境使用。网页端或移动端看不到该配置时,不代表 Geekit 接口异常。
常见问题
返回 404
开启完整 URL 时必须填写完整端点;关闭时只填写客户端要求的基础地址。检查是否出现 /v1/v1 或重复的 /chat/completions。
模型能对话但不能执行任务
确认模型支持当前协议下的工具调用,并核对高级设置中的模型能力。不要仅凭模型名称启用所有能力。
切换后仍使用旧模型
新建会话或重新启动 TRAE Work,确认当前任务使用的是刚添加的自定义模型。