---
title: "配置 Grok Build"
description: "定义模型 Profile、选择凭据与 API Backend，然后把 Grok Build 切换到新连接。"
version: "zh"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ochub.org/zh/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置 Grok Build

Grok Build 以一个当前模型 Profile 工作：它的实时配置只指向一个当前连接。默认配置目录是
`~/.grok`，OcHub 也可以管理它的 MCP 服务器。新增连接时可以从官方 xAI 预设开始，也可以手工填写，
或选择已配置的模型供应商。

1. **定义配置名称。** “配置名称”是客户端使用的 profile 名，也是 `[models].default` 指向的名称。

2. **填写上游模型。** 它是实际发送给供应商的模型 ID；显示名只用于界面识别。

3. **填写 Base URL。** 使用上游对应协议的基础地址。

4. **选择鉴权方式。** “API Key”会把密钥写进配置；“环境变量”只保存变量名，例如 `XAI_API_KEY`，运行 Grok Build 的环境中必须真的存在该变量。

5. **选择 API Backend。** 根据上游选择 OpenAI Responses、OpenAI Chat Completions 或 Anthropic Messages。

6. **填写上下文窗口。** 使用上游模型真实支持的 Token 数，不要用营销页面上的总长度猜测。

7. **查看 `config.toml` 预览并切换。** 重开 Grok Build 后发起真实请求。

如果环境变量模式在 OcHub 测试成功、Grok Build 却鉴权失败，通常是两个进程继承的环境不同。
从同一个终端启动 Grok Build，或把变量写入它实际读取的启动环境。

## 一键配置为模型供应商

连接编辑器顶部可以把来源从“直接连接”改成“模型供应商”。选好已配置的模型供应商后，OcHub
会填入本地网关地址、签发密钥，并把 API Backend 固定为 OpenAI Responses；你只需填写配置名称、
上游模型和显示名。接口转换在网关完成，不必把只支持 Chat Completions 的上游硬写成 Grok Build
直连。

也可以在「模型供应商」页面保存后，把该供应商应用到 Grok Build。

保存后，按[验收清单](/zh/guides/providers#验证新连接)确认切换成功。生效配置、
自定义 Backend、权限、沙箱与兼容导入见
[Grok Build 进阶与易踩坑](/zh/grok-build/advanced)。

Source: https://docs.ochub.org/zh/grok-build/configure/index.mdx