Grok Build 是 xAI 推出的终端编码助手。按照官方文档,它的主要配置文件是 ~/.grok/config.toml,我们可以把模型请求接入 PackyAPI 的 OpenAI 兼容端点。
不要把真实 Key 发给别人
下面示例里的 xxx 只是占位符。请用你在 PackyAPI 控制台创建的令牌替换它,不要在截图、聊天记录、公开仓库或工单里展示真实 API Key。
irm https://x.ai/cli/install.ps1 | iex
grok --version
curl -fsSL https://x.ai/cli/install.sh | bash
grok --version
%userprofile%\.grok
如果目录中没有 config.toml,请手动创建一个同名文件。
将以下内容写入 config.toml:
[models]
default = "grok-4.6"
web_search = "grok-4.6"
[endpoints]
models_base_url = "https://cf.api.fan/v1"
[model."grok-4.6"]
model = "grok-4.6"
name = "Grok 4.6"
description = "Grok 4.6 via PackyAPI"
api_key = "xxx"
api_backend = "responses"
context_window = 500000
supports_reasoning_effort = true # 开启后可用 /effort 调整思考等级
supports_backend_search = false # 关闭后端搜索,避免网关不支持时报错
xxx 替换为你的令牌。mkdir -p ~/.grok
nano ~/.grok/config.toml
config.toml:[models]
default = "grok-4.6"
web_search = "grok-4.6"
[endpoints]
models_base_url = "https://cf.api.fan/v1"
[model."grok-4.6"]
model = "grok-4.6"
name = "Grok 4.6"
description = "Grok 4.6 via PackyAPI"
api_key = "xxx"
api_backend = "responses"
context_window = 500000
supports_reasoning_effort = true # 开启后可用 /effort 调整思考等级
supports_backend_search = false # 关闭后端搜索,避免网关不支持时报错
xxx 替换为你的令牌。[models] default:新会话默认使用的模型。[models] web_search:Grok Build 内置 web_search 工具使用的模型。[endpoints] models_base_url:统一模型网关入口。这里填写 PackyAPI 的 OpenAI 兼容端点 https://cf.api.fan/v1。[model."grok-4.6"] api_key:当前模型使用的 PackyAPI 令牌。直接写在配置文件时使用 api_key。api_backend = "responses":Grok 4.6 按 xAI 示例使用 Responses API。supports_reasoning_effort = true:声明当前模型支持调整思考等级(reasoning effort)。不写这一行时,/effort 命令与 --effort 参数对该模型不可用。supports_backend_search = false:声明当前模型不支持 Grok 后端搜索(backend search)。PackyAPI 网关不提供该能力,设为 false 可避免请求被自动附加后端搜索参数而报错。[workflows] enabled = false:关闭 Grok Build 的 workflows 功能。接入 Kimi-K3 等非 Grok 模型时需要关闭,否则无法正常对话。也可以使用环境变量保存 Key
如果你不想把令牌直接写进 config.toml,可以把 api_key = "xxx" 改成:
env_key = "PACKY_API_KEY"
然后在系统环境变量中配置 PACKY_API_KEY。注意:env_key 填的是环境变量名,不是 API Key 本身。
如果要在 Grok Build 中使用 Kimi-K3 等非 Grok 模型,除了按同样的方式添加 [model."kimi-k3"] 配置块外,还必须 关闭 workflows 功能,否则无法正常对话:
[workflows]
enabled = false
[model."kimi-k3"]
model = "kimi-k3"
name = "Kimi K3"
description = "Kimi K3 via PackyAPI"
api_key = "xxx"
api_backend = "chat_completions"
context_window = 262144
supports_backend_search = false
要点说明:
[workflows] enabled = false:workflows 是 Grok 模型专属的工作流能力,Kimi-K3 等第三方模型不支持,必须关闭才能正常对话。api_backend 按模型实际接口填写,Kimi 系列模型一般使用 chat_completions。model = "kimi-k3" 需与 PackyAPI 控制台中的模型名称一致。模型配置里加上 supports_reasoning_effort = true 后,就可以随时调整思考等级(reasoning effort),让模型在“快速回答”和“深入思考”之间切换。
/effort 命令调整当前模型的思考等级:/effort low # 低思考,响应更快
/effort medium
/effort high
/effort xhigh # 极高思考,推理更深入
/model grok-4.6 high。-p)下,使用 --effort 参数:grok -p "只回复 ok" -m grok-4.6 --effort high
思考等级需要模型本身支持
/effort 只在当前模型声明了 supports_reasoning_effort = true 时才生效;不同模型支持的等级范围可能不同,具体以模型菜单里展示的为准。
grok inspect
grok -p "只回复 ok" -m grok-4.6
如果输出类似下面内容,说明配置已经生效:
ok
更多排查问题请参考 Grok Build 常见问题。