• 简体中文
  • 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 格式,并填写:

    字段填写值
    请求地址https://geekit.yryq.top/v1/chat/completions
    完整 URL开启
    API KeyGeekit 用户令牌
    模型 IDGeekit 中真实可用的模型 ID

    推荐开启“完整 URL”,这样客户端不会再次拼接路径。若当前版本只接受基础地址,则关闭该开关并填写 https://geekit.yryq.top/v1,保存后确认实际请求仍为 /v1/chat/completions

    使用 Anthropic Messages

    Claude 模型可选择 Anthropic Messages 格式:

    字段填写值
    请求地址https://geekit.yryq.top/v1/messages
    完整 URL开启
    API KeyGeekit 用户令牌
    模型 IDGeekit 中真实可用的 Claude 模型 ID

    只有模型确实兼容 Anthropic Messages 时才使用此选项。把普通 OpenAI Chat 模型改成 Anthropic 格式不会自动获得 Claude 工具调用能力。

    模型能力

    高级设置中的模型系列、上下文窗口、输出上限、多模态和工具调用轮次,应按模型真实能力填写:

    • 纯文本模型不要开启图片输入。
    • 上下文窗口不要超过模型或 Geekit 实际限制。
    • 工具调用异常时,先用简单文本请求确认连接,再检查模型协议能力。

    验证

    保存后在 TRAE Work 中执行一个只读最小任务,并同时检查 Geekit 调用日志:

    1. 请求端点为 /v1/chat/completions/v1/messages
    2. 模型 ID 与设置一致。
    3. 流式输出能够正常结束。
    4. 工具调用可执行,而不是输出未处理的 JSON。

    TRAE Work 的自定义模型仅在本地桌面环境使用。网页端或移动端看不到该配置时,不代表 Geekit 接口异常。

    常见问题

    返回 404

    开启完整 URL 时必须填写完整端点;关闭时只填写客户端要求的基础地址。检查是否出现 /v1/v1 或重复的 /chat/completions

    模型能对话但不能执行任务

    确认模型支持当前协议下的工具调用,并核对高级设置中的模型能力。不要仅凭模型名称启用所有能力。

    切换后仍使用旧模型

    新建会话或重新启动 TRAE Work,确认当前任务使用的是刚添加的自定义模型。

    官方资料