Grok Build 接入

Grok Build 是 xAI 提供的终端编码工具。它支持通过 OpenAI 兼容端点调用模型，可以使用 LikeAI 的 API 端点和密钥接入 Grok 模型。

1. 安装 Grok Build

Windows

在 PowerShell 中执行：

irm https://x.ai/cli/install.ps1 | iex

macOS、Linux 和 WSL

在终端中执行：

curl -fsSL https://x.ai/cli/install.sh | bash

安装完成后确认命令可用：

grok --version

2. 准备平台信息

在 LikeAI 的“API 密钥”页面准备以下信息：

API 端点: 页面显示的默认或自定义端点
API Key:  sk-...
模型名:   平台开放的 Grok 模型，例如 grok-4.5

Grok Build 的 models_base_url 需要填写 OpenAI 兼容 API 根地址。若页面显示的端点没有 /v1，请在末尾补上 /v1；如果端点已经包含 /v1，不要重复添加。

例如：

页面端点:        https://api.likeai520.cc
models_base_url: https://api.likeai520.cc/v1

WARNING

不要把真实 API Key 发到聊天、工单、截图或公开仓库中。下面示例中的值都需要替换为你自己的配置。

3. 创建配置文件

Grok Build 的主配置文件是 ~/.grok/config.toml。

Windows

在 %USERPROFILE%\.grok 目录中创建 config.toml 文件。

macOS、Linux 和 WSL

mkdir -p ~/.grok
nano ~/.grok/config.toml

4. 配置 Grok 模型

把以下内容写入 config.toml，并替换端点和模型名：

[models]
default = "grok-4.5"
web_search = "grok-4.5"

[endpoints]
models_base_url = "https://api.likeai520.cc/v1"

[model."grok-4.5"]
model = "grok-4.5"
name = "Grok 4.5"
description = "Grok 4.5 via LikeAI"
env_key = "LIKEAI_API_KEY"
api_backend = "responses"
context_window = 1000000

配置项说明：

配置项	说明
default	新会话默认使用的模型
web_search	Grok Build 内置网页搜索使用的模型
models_base_url	LikeAI 的 OpenAI 兼容 API 根地址，需要包含 /v1
model	实际发送给平台的模型名，必须与平台开放的名称一致
env_key	保存 API Key 的环境变量名称，不是 API Key 本身
api_backend	Grok 模型使用 responses 接口
context_window	模型上下文窗口；如平台限制不同，请按实际情况调整

如果平台开放的是 grok-build-latest 或其他 Grok 模型，请同时修改 [models] 和 [model."..."] 中对应的模型名。

5. 设置 API Key

推荐通过环境变量保存密钥，与配置中的 env_key = "LIKEAI_API_KEY" 对应。

Windows PowerShell

当前终端临时生效：

$env:LIKEAI_API_KEY = "sk-your-key"

写入当前用户环境变量：

[Environment]::SetEnvironmentVariable("LIKEAI_API_KEY", "sk-your-key", "User")

设置永久环境变量后，请重新打开终端。

macOS、Linux 和 WSL

当前终端临时生效：

export LIKEAI_API_KEY="sk-your-key"

需要长期使用时，把同一条 export 命令加入 ~/.zshrc 或 ~/.bashrc，然后重新打开终端。

直接在配置文件中填写 Key

也可以把模型配置中的 env_key 替换为：

api_key = "sk-your-key"

这种方式更容易因共享配置文件而泄露密钥，不推荐在多人电脑或会同步到云盘的目录中使用。

6. 检查和测试

先检查 Grok Build 读取到的配置：

grok inspect

再发起一个最小请求：

grok -p "只回复 ok" -m grok-4.5

正常情况下会返回：

ok

同时可以在 LikeAI“使用记录”中确认请求是否进入平台。

常见问题

提示 API Key 无效

确认 env_key 填的是环境变量名称 LIKEAI_API_KEY，并在同一个终端中检查该变量是否已经设置。不要把 env_key 直接写成 sk-...。

提示模型不存在或不可用

确认 API Key 所在分组支持该 Grok 模型，并检查 [models]、[model."..."] 和 model 三处名称是否一致。

请求地址错误或返回 404

检查 models_base_url 是否使用了“API 密钥”页面显示的端点，并确保地址末尾只有一个 /v1。

请求进入平台但调用失败

这通常说明 Grok Build 配置已经生效。请到 LikeAI 查看账号状态、渠道监控和错误日志，并确认模型对应的渠道支持 Responses API。

参考链接

• Grok Build 官方网站
• 接入概览
• API 调用