vibecli 快捷操作 · 2026-09-13

用 vibecli 一条命令， 让 Grok Build 走 VibeAPI

Grok Build 是 xAI 官方的终端编码代理（命令 grok）。vibecli 0.0.44 起 直接支持它：一条命令把 Key 写进 ~/.grok/config.toml，默认模型 grok-4.6，走 Responses 协议，不用手改 TOML。

Grok Build grok-4.6 --grokkey config.toml
查看操作
01

平台令牌管理 · 生成一把能访问 Grok 的 Key

先去 vibeapi.cn 建一把令牌。 Grok 系列在 auto / default 分组下可用；已经有这类令牌的用户直接复用即可。

01
进 vibeapi 控制台 · 令牌管理 · 添加令牌

登录 vibeapi.cn，导航到 控制台 → 令牌管理，点右上角「添加令牌」。 令牌分组选 auto 或 default，其余参数默认即可。

vibeapi 控制台 · 令牌管理
vibeapi 控制台 · 令牌管理 · 点右上角「添加令牌」

分组怎么判断对不对：vibecli 配置前会用这把 Key 拉一次 /v1/models，列表里有 grok-* 才会往下写；分组不含 Grok 会直接报「无法访问 Grok 模型」并停下，不会写坏配置。

02
令牌创建成功 · 复制 sk-xxx

回到令牌列表，把这条令牌的 sk-xxx 复制下来——下面所有命令里的「你的Key」都填它。

令牌创建成功 · 复制 key
令牌创建成功 · 复制这条令牌
02

装 Grok Build，升级 vibecli

1
Grok Build 用官方脚本安装它不在 npm 上。没装也没关系，vibecli 配置完会提示安装命令；先装的话按下面两条。
2
vibecli 升到 0.0.44 或更高之前的版本不认识 Grok Build，也没有 --grokkey。
安装 Grok Build · macOS / Linux 官方脚本
curl -fsSL https://x.ai/cli/install.sh | bash
安装 Grok Build · Windows PowerShell 官方脚本
irm https://x.ai/cli/install.ps1 | iex
升级 vibecli 到最新版 新老用户都执行
npm i -g @vibeapi/cli@latest
03

一条命令配置

只配 Grok Build，直接运行这一条：

Grok Build 专用 Key 推荐
vibecli setup --grokkey 你的Key
同一个 Key 配置多个工具vibecli 会探测这把 Key 能访问哪些模型分组：有 Claude 配 Claude Code、有 GPT 配 Codex、有 Grok 配 Grok Build，缺哪个跳哪个。
vibecli setup --key 你的Key
三个工具各用各的 Key三把 Key 写在同一条命令里，各自校验、各自写入。
vibecli setup --claudekey ClaudeKey --codexkey CodexKey --grokkey GrokKey
交互式向导想在菜单里挑模型再写入，进 vibecli 的工具菜单。
vibecli config grok

已经用 --key 配过 Claude Code / Codex 的老用户，升级 vibecli 后把同一条 vibecli setup --key 你的Key 再跑一次就会把 Grok Build 一并补上（前提是那把 Key 能访问 Grok）。重复执行结果相同。

04

它往 ~/.grok/config.toml 写了什么

只动三个表：[endpoints]、[models]、[model.vibeapi]。 你自己的 [ui]、[marketplace]、[mcp_servers] 和其它 [model.*] 原样保留。 

[endpoints]
models_base_url = "https://www.vibeapi.cn/v1"   # 所有模型走 VibeAPI

[models]
default = "vibeapi"                          # 新会话默认用下面这个表

[model.vibeapi]
name = "VibeAPI"                             # 模型选择器里显示的名字
model = "grok-4.6"                            # 实际发给网关的模型 id
api_key = "sk-你的Key"
context_window = 500_000
api_backend = "responses"                    # Responses 协议
reasoning_summary = "concise"
✓
写之前先备份原文件快照成 config.toml.bak-<时间戳>，每文件留 10 份；vibecli config grok restore 一键还原。
✓
原子写入先写临时文件再改名，进程被打断也不会留下写一半的 TOML。
✓
移除也只摘自己的工具菜单里「移除配置」只删上面三处，其它段落不碰。
05

启动、检查、换模型

启动 Grok Build进项目目录运行，新会话默认就是 VibeAPI 的 grok-4.6。
grok
检查配置状态看各工具是否已配置、Key 指纹是什么。
vibecli status
看 Grok Build 自己读到了什么官方自带的排查命令，列出它发现的配置来源。
grok inspect
换成别的模型两步：先记下模型，再重新应用才会写进 config.toml。
vibecli config tool-model set grok grok-4-fast && vibecli config grok --non-interactive

Grok Build 不限制模型必须是 grok-*：网关暴露的 Claude、GPT 型号也能通过 tool-model set grok <型号> 指给它。默认 grok-4.6 只是因为这是它自家的主力模型。

06 · 配置边界

Key 明文写在 config.toml，和 Grok Build 自己的做法一致

Grok Build 官方支持 api_key 内联和 env_key 引用环境变量两种方式；vibecli 用前者， 因为它要配的是"多个工具共用同一把 Key"，不想让用户再去维护 shell 环境变量。

✓ --grokkey 存为工具专属 Key，不影响默认 Key ✓ 分组里没有 Grok 模型会拒绝写入，不留半成品 ✓ 重复执行结果相同，可以放心重跑 ✓ vibecli config grok restore 随时回到写入前
Grok Build 官方配置参考

Grok 系列模型的能力、计价与实测见 开发者文档 · Grok 对话。

命令已复制