Grok Build 以一个当前模型 Profile 工作：它的实时配置只指向一个当前连接。默认配置目录是
~/.grok，OcHub 也可以管理它的 MCP 服务器。新增连接时可以从官方 xAI 预设开始，也可以手工填写，
或选择已配置的模型供应商。
-
定义配置名称。 “配置名称”是客户端使用的 profile 名，也是
[models].default指向的名称。 -
填写上游模型。 它是实际发送给供应商的模型 ID；显示名只用于界面识别。
-
填写 Base URL。 使用上游对应协议的基础地址。
-
选择鉴权方式。 “API Key”会把密钥写进配置；“环境变量”只保存变量名，例如
XAI_API_KEY，运行 Grok Build 的环境中必须真的存在该变量。 -
选择 API Backend。 根据上游选择 OpenAI Responses、OpenAI Chat Completions 或 Anthropic Messages。
-
填写上下文窗口。 使用上游模型真实支持的 Token 数，不要用营销页面上的总长度猜测。
-
查看
config.toml预览并切换。 重开 Grok Build 后发起真实请求。
如果环境变量模式在 OcHub 测试成功、Grok Build 却鉴权失败，通常是两个进程继承的环境不同。 从同一个终端启动 Grok Build，或把变量写入它实际读取的启动环境。
一键配置为模型供应商
连接编辑器顶部可以把来源从“直接连接”改成“模型供应商”。选好已配置的模型供应商后，OcHub 会填入本地网关地址、签发密钥，并把 API Backend 固定为 OpenAI Responses；你只需填写配置名称、 上游模型和显示名。接口转换在网关完成，不必把只支持 Chat Completions 的上游硬写成 Grok Build 直连。
也可以在「模型供应商」页面保存后，把该供应商应用到 Grok Build。
保存后，按验收清单确认切换成功。生效配置、 自定义 Backend、权限、沙箱与兼容导入见 Grok Build 进阶与易踩坑。