把配置这件事，交给你的 AI 去做

我要把 xAI 的 Grok Build CLI（终端命令 `grok`）接入下面这个 API 端点，请你帮我完成全部配置并验证。

我的网关信息：
- API 端点：https://api.x.ai/v1
- API Key：<在这里粘贴你的-API-KEY>

> 注意：上面的 API Key 是一个占位符。请先提醒我把它替换成真实的 Key，如果我已经替换了就直接继续。不要凭空编造一个 Key。

请严格按下面的步骤执行。这些步骤里的每一条都是踩过坑总结出来的，请不要跳过，尤其不要跳过第 3 步和第 7 步的验证。

## 第 1 步 确认 CLI 已安装

运行 `grok --version`。如果没有安装，先告诉我，不要自行安装。

## 第 2 步 先登出官方账号（非常关键）

Grok Build 的登录 session 优先级高于 API Key。只要本地还存在有效 session，后面的 API Key 配置就不会生效，而且报错信息会很有误导性。

先运行 `grok logout`，再确认 `~/.grok/auth.json` 已经不存在（只剩 `auth.json.lock` 是正常的）。

## 第 3 步 用我的 Key 请求模型列表，拿到真实模型名

这一步是整个配置的地基。**不要凭你的训练记忆假设模型叫 grok-4、grok-4.5 或别的名字**，这个端点实际提供什么模型、叫什么 ID，一切以接口返回为准。

运行：

```bash
curl -s https://api.x.ai/v1/models -H "Authorization: Bearer <在这里粘贴你的-API-KEY>"
```

从返回 JSON 的 `data[].id` 里读出模型 ID，这些才是我可以写进配置的合法名字。

排查提示：
- 返回 401 → Key 无效或写错
- 返回 404 → 端点路径不对，试试加上或去掉结尾的 `/v1`
- 返回 503 → 上游暂时不可用，等一会重试，不要急着改配置

## 第 4 步 挑一个模型，实测能不能真的出词

模型列表能返回，不代表推理能用。请把第 3 步拿到的某个模型 ID 代入下面的命令实测：

```bash
curl -s https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer <在这里粘贴你的-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"<第3步拿到的模型ID>","messages":[{"role":"user","content":"hi"}],"max_tokens":20}'
```

确认返回 200 且 `choices[0].message.content` 有内容，再进入下一步。

## 第 5 步 写入 ~/.grok/config.toml

先备份：`cp ~/.grok/config.toml ~/.grok/config.toml.bak`（文件不存在就跳过）。

然后写入以下内容，把 `<MODEL_ID>` 全部替换成第 3 步拿到的真实模型 ID：

```toml
[endpoints]
models_base_url = "https://api.x.ai/v1"

[model."<MODEL_ID>"]
api_key = "<在这里粘贴你的-API-KEY>"

[models]
default = "<MODEL_ID>"
```

### ⚠️ 一个必须避开的 TOML 陷阱

如果模型 ID 里含有小数点（例如 `grok-4.5`），表名**必须**用引号包起来：

```toml
[model."grok-4.5"]        # ✅ 正确
[model.grok-4.5]          # ❌ 错误
```

不加引号的话，TOML 会把点当成层级分隔符，把它解析成「`grok-4` 表下的 `5` 键」，配置等于完全没写。症状是 `grok models` 报 `You are not authenticated`，并且退回去列出 `grok-4` 之类的内置默认模型。这个坑非常隐蔽，请务必检查。

### 配置项说明

- 设置 `[endpoints] models_base_url` 之后，Grok 会自动从 session 鉴权切换成 `Authorization: Bearer` API Key 鉴权，因此不再需要 `grok login`
- 所有 `[model.*]` 会自动继承这个 base_url，不需要在每个模型里重复写 `base_url`
- 凭据解析顺序是 `api_key` → `env_key` → 全局环境变量 `XAI_API_KEY`
- 模型列表由 Grok 自动从 `{models_base_url}/models` 拉取

## 第 6 步 收紧文件权限

配置文件里是明文 Key：

```bash
chmod 600 ~/.grok/config.toml
```

## 第 7 步 验证（不要省略）

先看模型列表：

```bash
grok models
```

预期输出里应当出现 `Model '<MODEL_ID>' is using its own API key.`，并且列出第 3 步拿到的模型。

如果看到 `You are not authenticated`，或者列出来的是你没配过的内置模型，说明配置没生效。按这个顺序排查：模型名的引号（第 5 步）→ 是否真的登出了（第 2 步）→ base_url 是否要带 `/v1`。

再跑一次真实推理：

```bash
grok -p "用一句话介绍你自己"
```

## 第 8 步 清理指向旧模型的残留字段

检查 `~/.grok/config.toml` 里是否还有别的字段引用了这个端点上并不存在的模型名，例如 `[ui] fork_secondary_model` 或 `[models] web_search`。如果有，一并换成第 3 步拿到的真实模型 ID，否则相关功能会在使用时报错。

## 完成后请告诉我

1. 第 3 步实际拿到的模型 ID 列表
2. 最终的 `config.toml` 内容（把 Key 用 `sk-***` 遮掉）
3. `grok models` 和 `grok -p` 的验证结果

如果任何一步失败，请把原始报错贴给我，不要自行猜测或跳过。