Grok 安装与接入教程

通过 Passion8 使用 Grok，只需本站 API Key、可用模型 ID 和 https://passion8.cc/v1 地址。VS Code 推荐 Cline；官方 Grok Build 和已有 Codex 用户可继续使用本页的配置文件教程。本站接入不需要 xAI 账号或官方 OAuth 登录。

#选择你的使用方式

Cline 是第三方编辑器客户端；当前核对的 xAI 官方编程入口为 Grok Build 的 TUI、headless 与 ACP。不要把市场中的同名社区扩展直接当作 xAI 官方插件。

Grok 模型可以用两种方式接入 Passion8:

两种方式都使用 OpenAI 兼容地址 https://passion8.cc/v1,模型示例为 grok-4.7。模型 ID 以 控制台模型广场 实际可用为准。

#方式一:官方 Grok Build CLI

官方 Grok Build 是 xAI 的原生 CLI。本文保留 Grok Build v0.2.93 接入记录的步骤，并于 2026-10-11 对照官方安装、自定义模型和 Grok 4.7 文档更新。运行版本请以 grok --version 为准；若配置字段调整，先用 grok inspect 查看当前识别到的配置来源、模型和认证方式。

#安装 Grok CLI

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

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

安装完成后,新开一个终端窗口,确认命令可用:

which grok
grok --version

macOS / Linux / WSL 正常情况下,which grok 会指向 ~/.local/bin/grok,并进一步链接到 ~/.grok/bin/grok。

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

需要更新 Grok CLI 时运行:

grok update

#接入前准备

先确认你用的是官方 Grok Build:

which grok
grok --version

如果 which grok 指向 ~/.local/bin/grok 或 ~/.grok/bin/grok,通常就是官方 Grok Build。

#推荐配置

直接把 Key 写进 api_key 字段:

[model.passion8-grok]
model = "grok-4.7"
base_url = "https://passion8.cc/v1"
name = "grok-4.7"
context_window = 500000
api_key = "sk-你的 Passion8 API Key"

[models]
default = "passion8-grok"

#更安全的环境变量写法

不想把 Key 明文写进 config.toml 时,可以用 env_key 指向环境变量名:

[model.passion8-grok]
model = "grok-4.7"
base_url = "https://passion8.cc/v1"
name = "grok-4.7"
context_window = 500000
env_key = "PASSION8_API_KEY"

[models]
default = "passion8-grok"

再把 Key 放进 shell 配置:

echo 'export PASSION8_API_KEY="sk-你的 Passion8 API Key"' >> ~/.zshrc
source ~/.zshrc

#测试中转站

先用 curl 验证 Key、Base URL 和模型是否可用:

curl -s https://passion8.cc/v1/models \
  -H "Authorization: Bearer $PASSION8_API_KEY"

再试跑一句:

curl -s https://passion8.cc/v1/chat/completions \
  -H "Authorization: Bearer $PASSION8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "messages": [{"role": "user", "content": "reply with OK"}],
    "max_tokens": 10
  }'

如果 curl 正常返回,但 grok 仍然跳浏览器 OAuth,问题通常在 ~/.grok/config.toml。

#验证 Grok CLI

grok -p "Reply with exactly: RELAY_OK"

能返回 RELAY_OK 后，再到 Passion8 控制台核对对应时间、模型和用量记录；不要仅凭回答内容判断路由。

#常见错误

#认证优先级

Grok Build 会优先读取模型配置里的 Key。实测排查顺序可以按下面理解:

model.api_key > model.env_key > 当前登录 session > XAI_API_KEY

如果 api_key 缺失、env_key 又写错,它可能回退到登录 session;没有 session 时就会触发浏览器 OAuth。

#常用命令

grok                         # 进入交互式 TUI
grok "帮我看看这个项目"        # 带初始指令进入 TUI
grok -p "解释 auth 模块"      # 单次运行,打印结果后退出
grok logout                  # 登出,排除旧 session 干扰
grok inspect                 # 查看配置来源、模型和认证方式
grok --version               # 查看版本

#方式二:Codex CLI / App 接入 Grok

如果你更习惯 Codex CLI 或 Codex App,也可以让 Codex 走 Passion8 的 grok-4.7。这种方式本质上是“Codex 客户端 + Grok 模型”:客户端还是 Codex,底层请求模型换成 Grok。

#用 CC-Switch 配置

在 CC-Switch 顶部切到 GPT / Codex 供应商区域,新增一个供应商,填写:

保存后,确认 CC-Switch 维护的是 Codex 的两份配置:

无论用 CC-Switch 还是手写,最终 config.toml 都应包含下面这组相同字段与数值(文档故意不写本机 model_catalog_json 路径)。

#auth.json

{
  "OPENAI_API_KEY": "sk-你的 Passion8 API Key"
}

#config.toml

model_provider = "custom"
model = "grok-4.7"
model_reasoning_effort = "high"
model_context_window = 500000
model_auto_compact_token_limit = 475000

[model_providers]
[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://passion8.cc/v1"

#手动配置

不想用 CC-Switch 时,直接写上面同一份 auth.json 和 config.toml,不要另写一套不同的窗口数值。

~/.codex/auth.json
~/.codex/config.toml

codex "用一句话回复: GROK_RELAY_OK"

$env:USERPROFILE\.codex\auth.json
$env:USERPROFILE\.codex\config.toml

codex "用一句话回复: GROK_RELAY_OK"

Codex App 使用同一套 Codex 配置。保存 CC-Switch 供应商后,重新打开 Codex App 或新建会话再测试。

#账户、费用与排错

还没有 API Key 时，从 快速开始 创建账户和令牌。余额与费用口径见 充值与账单，不要把客户端的官方订阅与 Passion8 API 余额混用。鉴权、Base URL、模型不可用等问题见 常见问题；当前可用模型及价格以控制台为准。

#核对来源

核对日期：2026-10-11。官方目录包含 grok-4.7，支持 low、medium、high、xhigh 推理档位；本站是否开放以控制台为准。

• Grok Build 安装与自定义模型
• Grok 4.7 模型字段与窗口

官方概览确认 model、base_url、name、env_key 和 [models].default；api_key、认证优先级及默认 200k 显示来自原有版本接入记录，升级后用 grok inspect 验证，不作为所有未来版本的保证。