Grok Build 配置

Grok Build 是 xAI 的终端编程代理（命令 grok）。可以走官方 xAI Key，也可以把自定义模型指到本站。

官方概览：https://docs.x.ai/build/overview
官方设置：https://docs.x.ai/build/settings
安装：curl -fsSL https://x.ai/cli/install.sh | bash（Windows：irm https://x.ai/cli/install.ps1 | iex）

图形界面 = TUI 里的 /settings。命令行 = ~/.grok/config.toml + 环境变量。

快速字段

项	值
配置文件	~/.grok/config.toml（或 $GROK_HOME/config.toml；Windows：%USERPROFILE%\.grok\config.toml）
base_url（Chat / Responses）	https://api.ashpetals.com/v1
base_url（Anthropic Messages）	https://api.ashpetals.com（不要 /v1）
env_key	任意环境变量名，例如 ASHPETALS_API_KEY
api_backend	responses / chat_completions / messages
模型示例	grok-4.5（Grok-Main）或 gpt-5.6-sol（ChatGPT 分组）
检查发现了哪些配置	grok inspect

令牌分组：要用 Grok 系模型选 Grok-Main；要用 GPT 选 ChatGPT-Main / DR。模型必须出现在该 Key 的 /v1/models。

---

图形界面（TUI /settings）

1. 安装后进入项目目录运行 grok。
2. 在 TUI 输入 /settings（日用 UI、通知、主题优先走这里）。
3. 找到 Models / Custom model / 自定义端点（名称随版本略有差异）。
4. 新增一条模型：
   • Display name：例如 AshPetals Grok
   • Model id（发给 API 的 id）：grok-4.5
   • Base URL：https://api.ashpetals.com/v1
   • API backend：responses（本站 GPT/Grok 文本推荐）或 chat_completions
   • API Key：填本站 sk-…，或指向已 export 的环境变量
5. 把 default model 设成刚加的那条。
6. /model AshPetals Grok（或你起的名字）后发一条「ping」。

没有完整表单时，用下面的 config.toml（官方也把自定义模型写在用户级 TOML）。改完再 grok inspect 确认读到了。

---

命令行 / 配置文件

安装与首次启动

curl -fsSL https://x.ai/cli/install.sh | bash
cd your-project
export ASHPETALS_API_KEY="sk-你的APIKey"
grok

无浏览器环境不要走官方 OAuth；用 API Key / 自定义模型。

config.toml（推荐，持久）

复制到 $GROK_HOME/config.toml，未设 GROK_HOME 时用 ~/.grok/config.toml。

[models]
default = "ashpetals-grok"

[model."ashpetals-grok"]
model = "grok-4.5"
base_url = "https://api.ashpetals.com/v1"
name = "AshPetals Grok"
description = "Grok via AshPetals"
env_key = "ASHPETALS_API_KEY"
api_backend = "responses"
max_completion_tokens = 8192
context_window = 256000

GPT 走本站（ChatGPT 分组）：

[models]
default = "ashpetals-gpt"

[model."ashpetals-gpt"]
model = "gpt-5.6-sol"
base_url = "https://api.ashpetals.com/v1"
name = "AshPetals GPT"
env_key = "ASHPETALS_API_KEY"
api_backend = "responses"

Claude 走本站（Claude 分组，Messages 协议）：

[model."ashpetals-claude"]
model = "claude-sonnet-5"
base_url = "https://api.ashpetals.com"
name = "AshPetals Claude"
env_key = "ASHPETALS_API_KEY"
api_backend = "messages"

api_backend：

值	本站路径	Base 是否带 /v1
responses	POST /v1/responses	要
chat_completions	POST /v1/chat/completions	要
messages	POST /v1/messages	不要

项目内 .grok/config.toml 不能写模型供应商（只允许 MCP / 插件 / 权限）。自定义模型必须写用户级文件。

环境变量

export ASHPETALS_API_KEY="sk-你的APIKey"
# 与 config.toml 里 env_key 同名
grok inspect
grok -p "ping" -m ashpetals-grok

官方默认读 XAI_API_KEY 打 api.x.ai。接本站时 不要把本站 Key 当成 xAI Key 塞进 XAI_API_KEY 还不改 base_url，否则请求会打到 xAI 官方。

无头 / CI

grok -p "Explain this codebase" -m ashpetals-grok
grok -p "ping" -m ashpetals-grok --output-format streaming-json

TUI 内切换：/model ashpetals-grok。

CC Switch

桌面顶部选 Grok Build，按 OpenAI 兼容填 https://api.ashpetals.com/v1 + Key。CLI fork 是否覆盖 Grok 以当前 cc-switch --help 为准；没有 --app grok 时用手写 config.toml。

---

验证

grok inspect
grok -p "Reply only: PONG" -m ashpetals-grok

curl -sS https://api.ashpetals.com/v1/responses \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-4.5","input":"ping"}'

---

注意事项

• 配置作用域：环境变量 → 用户 ~/.grok/config.toml → 项目 .grok/config.toml（项目级不含模型供应商）。用 grok inspect 看实际加载源。
• Grok 图 / 视频不要走 Build 的 chat 模型；用本站 图像 / 视频 端点。
• supports_backend_search 仅当上游真支持 Grok 服务端搜索时再开；本站一般保持默认 / false。
• 不要把 Key 写进 extra_headers 再提交仓库；用 env_key。
• 改 TOML 后新开 grok 进程。