主题
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 = 524288default = "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
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 = true4. 接入非 Grok 模型后无法对话
Grok Build 默认开启的 workflows 是 Grok 模型专属机制。若把 model 改成了非 Grok 模型,需在 config.toml 里关闭它:
TOML
[workflows]
enabled = false