Skip to content

Grok(终端) ​

接入 xAI 官方的 Grok Build(终端命令 grok)。

  • 协议与地址: OpenAI 兼容接口,base_url 填 https://aicode.cat/v1(要加 /v1)。
  • 配置文件: 密钥和地址都写在 ~/.grok/config.toml(不要写 auth.json,也不要装 bun add -g grok-dev,那是另一套软件)。
  • 前置准备: 先到 创建 API Key 拿一把 Key。下面示例模型用 grok-4.6(以 主站控制台 为准)。

注意

运行 grok 后若弹出登录 grok.com 或让你填 xAI API Key,不要点登录——说明 config.toml 没写对,或当前 grok 命令不是官方客户端。

macOS / Linux ​

1. 安装 Grok Build ​

打开终端执行:

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

关掉终端重开一次,验证版本:

Bash
grok --version

应输出类似 grok 1.0.52。若 which grok 不是 ~/.grok/bin/grok,说明还在跑旧的 grok-dev,先卸载旧版或把 ~/.grok/bin 放到 PATH 最前。

2. 创建配置文件 ​

把 在这里替换成你的_API_KEY 换成你的 Key(若之前用官方账号登录过 Grok,先备份原 ~/.grok/config.toml):

命令行写入
mkdir -p "$HOME/.grok"
cat > "$HOME/.grok/config.toml" << 'EOF'
[cli]
installer = "internal"

[models]
default = "aicode"
default_reasoning_effort = "high"

[model.aicode]
model = "grok-4.6"
base_url = "https://aicode.cat/v1"
name = "Grok 4.6"
api_key = "在这里替换成你的_API_KEY"
context_window = 524288
EOF
手动:~/.grok/config.toml
[cli]
installer = "internal"

[models]
default = "aicode"
default_reasoning_effort = "high"

[model.aicode]
model = "grok-4.6"
base_url = "https://aicode.cat/v1"
name = "Grok 4.6"
api_key = "在这里替换成你的_API_KEY"
context_window = 524288

default = "aicode" 必须与下方的表头 [model.aicode] 一致。

核对配置(不打印完整密钥):

Bash
grep '^default' "$HOME/.grok/config.toml"
grep 'base_url' "$HOME/.grok/config.toml"
grep -q 'api_key' "$HOME/.grok/config.toml" && echo 'api_key=<已设置>'

3. 验证安装 ​

新开终端运行 grok,输入「你好」测试,能正常回复即配置成功。

Bash
grok

Windows ​

1. 安装 Grok Build ​

按 Win + R 输入 powershell 打开 PowerShell,执行:

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

关闭并重开 PowerShell,验证版本:

PowerShell
grok --version

若 Get-Command grok 指向的不是 %USERPROFILE%\.grok\bin\grok.exe,说明还在跑旧的 grok-dev,请先卸载旧版。

2. 创建配置文件 ​

把 在这里替换成你的_API_KEY 换成你的 Key,在 PowerShell 执行:

命令行写入
$KEY = "在这里替换成你的_API_KEY"

New-Item -ItemType Directory -Force -Path "$HOME\.grok" | Out-Null
@"
[cli]
installer = "internal"

[models]
default = "aicode"
default_reasoning_effort = "high"

[model.aicode]
model = "grok-4.6"
base_url = "https://aicode.cat/v1"
name = "Grok 4.6"
api_key = "$KEY"
context_window = 524288
"@ | Set-Content -Path "$HOME\.grok\config.toml" -Encoding UTF8 -Force
手动:config.toml
[cli]
installer = "internal"

[models]
default = "aicode"
default_reasoning_effort = "high"

[model.aicode]
model = "grok-4.6"
base_url = "https://aicode.cat/v1"
name = "Grok 4.6"
api_key = "在这里替换成你的_API_KEY"
context_window = 524288

手动方式的文件路径:C:\Users\<你的用户名>\.grok\config.toml。

核对配置:

PowerShell
Select-String -Path "$HOME\.grok\config.toml" -Pattern 'default |base_url|api_key' | ForEach-Object { if ($_.Line -match 'api_key') { 'api_key=<已设置>' } else { $_.Line } }

3. 验证安装 ​

重开 PowerShell 运行 grok,输入「你好」,能正常回复即配置成功。

PowerShell
grok

常见问题 ​

1. 手动打开 .grok 文件夹与重启提醒 ​

  • Windows(CMD): start "" "%USERPROFILE%\.grok"(用记事本新建时请勾选显示「文件扩展名」,确保文件名是 config.toml 而不是 config.toml.txt)
  • macOS(终端): mkdir -p "$HOME/.grok" && open "$HOME/.grok"(访达按 Command + Shift + . 显示隐藏文件)
  • 改完必重启: 每次修改 config.toml 后,先按 Ctrl + C 退出当前 grok 再重进才会生效。

2. 把 Key 填进 env_key 后用不了 ​

env_key 只能填环境变量名,不能直接填 sk- 开头的密钥本身。想把 Key 直接写进配置文件,请统一用 api_key = "你的Key"。

3. /effort 调整思考强度不生效 ​

要在会话里用 /effort 命令或启动时带 --effort 参数调节思考强度,在 [model.aicode] 下补一行:

TOML
[model.aicode]
supports_reasoning_effort = true

4. 接入非 Grok 模型后无法对话 ​

Grok Build 默认开启的 workflows 是 Grok 模型专属机制。若把 model 改成了非 Grok 模型,需在 config.toml 里关闭它:

TOML
[workflows]
enabled = false