集成 · 智能体

为 Grok Build 配置自定义模型

Grok Build 是 xAI 的编程智能体,从 ~/.grok/config.toml 读取模型定义。AutoJev 会为你勾选的每个模型或路由写入一条指向本地网关的模型条目,并设置默认项。

  • 每个勾选项一条 [model."<id>"]
  • 设置 [models] default
  • 入口 Chat Completions,出口任意协议
  • 恢复时保留你自己的模型

智能体

+ 智能体

CodexResponses

~/.codex/config.toml

已接入

Claude CodeMessages

~/.claude/settings.json

已接入

Gemini CLIGemini

~/.gemini/settings.json

已接入

OpenCodeChat

~/.config/opencode/opencode.json

接入

AutoJev 如何连接 Grok Build

Grok Build 把每个模型定义成一个 [model.<name>] 表,各自带有 base URL、Key 和 API 后端。连接时,AutoJev 为每个勾选的模型或路由写一个这样的表——base_url 为 http://127.0.0.1:9527/v1,Key 为占位值 autojev-local-grok,api_backend 为 chat_completions——并把 [models] default 指向你选的默认项。

之后请求以 Chat Completions 协议到达 AutoJev。AutoJev 解析模型或路由,用你的 Key 调用上游供应商,按需转换成 Responses 或 Anthropic Messages,并在路由允许时切换到其他候选模型。

AutoJev 会配置哪些内容

项目取值
配置文件~/.grok/config.toml(支持 GROK_HOME)
默认项[models] default = 你的默认模型或路由
模型条目[model."<id>"],含 name、model、base_url、api_key、api_backend
Base URLhttp://127.0.0.1:9527/v1
后端api_backend = "chat_completions"
Keyautojev-local-grok(占位值,把请求标记为 grok)

Grok Build 接入网关后多了什么

Key 集中管理

供应商 Key 只保存在你电脑上的 AutoJev 中,Grok Build 里只有占位 Key;请求直连你的供应商,不加价。

输出前自动故障转移

开始输出前遇到连接错误或 HTTP 401/402/403/408/429/5xx 时,路由会改用其他候选模型重试(默认最多 4 次),并遵守 Retry-After。

按智能体统计日志与成本

每个请求都标记为 grok,记录模型、路由、输入 / 输出 / 缓存 token、延迟和估算成本。提示词和响应内容不会被保存。

改路由,不改配置

一次性连接路由,之后在 AutoJev 里切换负载均衡或智能选择策略,无需再动 Grok Build 的配置。

配置步骤

  1. 1

    安装 AutoJev

    下载并打开桌面应用,网关在 9527 端口启动。

  2. 2

    添加供应商和模型

    用你自己的 Key 添加 OpenAI、DeepSeek、OpenRouter、Ollama 或任意 OpenAI 兼容 / Anthropic 兼容端点,再添加模型。

  3. 3

    可选:创建路由

    创建 autojev/quality、autojev/cheap 这样的路由,让 AutoJev 按请求挑选模型。

  4. 4

    连接 Grok Build

    在“智能体”页,AutoJev 会检测到 grok 可执行文件。勾选模型和路由,指定默认项,点击“连接”。

  5. 5

    启动 Grok Build

    新开一个会话,请求会以 grok 的名义出现在 AutoJev 的“请求日志”中。

    bash
    grok

AutoJev 写入的配置

示例:默认项为路由 autojev/fast。每多勾选一项,就多一个使用相同地址和 Key 的 [model."<id>"] 表。

~/.grok/config.toml
# ~/.grok/config.toml — keys AutoJev writes on connect [models] default = "autojev/fast" [model."autojev/fast"] name = "Fast" model = "autojev/fast" base_url = "http://127.0.0.1:9527/v1" api_key = "autojev-local-grok" api_backend = "chat_completions"

切换模型与路由

每个勾选项都是一条模型条目,可以在 Grok Build 中直接切换。想调整列表或默认项,在“智能体”页修改后重新连接,或使用“批量更新配置”。每次更新时,AutoJev 只删除自己写入的条目(占位 Key 和网关地址相同的那些),再写入新的一组。如果你已有的模型使用了相同 ID,AutoJev 会停止操作,而不是覆盖它。

恢复 config.toml

AutoJev 写入前会校验 TOML 并保留备份。“断开”“停止并恢复配置”或从托盘退出时,会恢复你原来的默认项并删除 AutoJev 的条目,同时保留你之后做的不冲突修改。

Chat Completions 通往任意上游

AutoJev 在 Chat Completions、Responses 和 Anthropic Messages 之间互相转换,覆盖流式输出和函数工具。

一个地址,三种协议

127.0.0.1:9527/v1

Chat Completions
Responses
Messages

Chat Completions

/v1/chat/completions

—

Responses

/v1/responses

—

Messages

/v1/messages

—
ResponsesDeepSeek · Chat
MessagesOpenAI · Responses
ChatAnthropic · Messages

常见问题

Grok Build 能用非 xAI 的模型吗?

通过 AutoJev 可以。你在 AutoJev 中添加的每个模型都能为 Grok Build 勾选,并作为独立的模型条目出现。

AutoJev 设置的是哪个 API 后端?

chat_completions。如果上游模型使用 Responses 或 Anthropic Messages,AutoJev 会转换请求。

AutoJev 会改动我已有的 Grok 模型吗?

不会。它只删除并重写使用其占位 Key 和网关地址的条目;遇到 ID 冲突的模型会拒绝覆盖。

AutoJev 支持 GROK_HOME 吗?

支持。设置了 GROK_HOME 时,AutoJev 会修改该目录下的 config.toml。

也能通过 AutoJev 使用 Grok 模型吗?

如果 xAI 的 API 可以作为 OpenAI 兼容端点访问,用你的 Key 把它添加为 OpenAI 兼容供应商即可。AutoJev 没有专门的 xAI 预设。

继续了解

更新于 2026-10-14

给每个智能体,配上合适的模型。

安装 AutoJev,添加你已有的模型服务商,一键接入智能体。所有数据都留在你的电脑上。

免费开源 · macOS · Windows · Linux