Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
Grok CLI 是 xAI 推出的命令行 AI 编程助手。本指南将介绍如何安装官方 CLI、将 ApiPass 配置为模型端点，并从终端开始使用 Grok 4.5。
请先确认你已经准备好：
下方的安装和配置命令适用于 macOS、Linux 和 WSL2 shell。如果你使用 Windows，请在 WSL2 中运行这些命令，不要在原生 PowerShell 中运行。
安装官方 Grok CLI：
1curl -fsSL https://x.ai/cli/install.sh | bash安装程序完成后，请打开一个新的终端，使更新后的 PATH 生效。
Grok CLI 从 ~/.grok/config.toml 读取用户配置。
创建配置目录：
1mkdir -p ~/.grok使用以下配置创建或替换 ~/.grok/config.toml：
1[cli]
2installer = "internal"
3
4[models]
5default = "grok-4.5"
6web_search = "grok-4.5"
7
8[endpoints]
9models_base_url = "https://api.apipass.dev/grok-build/v1"
10
11[model."grok-4.5"]
12model = "grok-4.5"
13name = "Grok 4.5"
14description = "Grok 4.5 ApiPass"
15api_key = "api-key"
16api_backend = "responses"
17context_window = 1000000将 api-key 替换为从 ApiPass API Keys 页面复制的 API Key。请保留 API Key 两侧的引号。
你也可以直接在终端中创建该文件：
1cat > ~/.grok/config.toml << 'EOF'
2[cli]
3installer = "internal"
4
5[models]
6default = "grok-4.5"
7web_search = "grok-4.5"
8
9[endpoints]
10models_base_url = "https://api.apipass.dev/grok-build/v1"
11
12[model."grok-4.5"]
13model = "grok-4.5"
14name = "Grok 4.5"
15description = "Grok 4.5 ApiPass"
16api_key = "api-key"
17api_backend = "responses"
18context_window = 1000000
19EOF如果使用终端命令，请随后编辑该文件，并将 api-key 替换为你真实的 ApiPass API Key：
1nano ~/.grok/config.toml由于该文件包含你的 API Key，请限制其访问权限：
1chmod 600 ~/.grok/config.toml[cli] 让 CLI 继续通过内部安装程序通道更新。[models] 为普通提示词和网络搜索请求选择 grok-4.5。[endpoints] 通过 ApiPass 路由模型发现和 Responses API 请求。[model."grok-4.5"] 注册静态 Grok 4.5 模型，并保存用于请求认证的 ApiPass API Key。api_backend = "responses" 让 CLI 使用 ApiPass Grok Build 端点支持的 Responses API 协议。context_window = 1000000 声明该模型具有一百万 token 的上下文窗口。请严格使用如下所示的基础 URL：
1https://api.apipass.dev/grok-build/v1不要在 models_base_url 后追加 /responses。Grok CLI 会自动添加模型和 Responses API 路径。
检查当前生效的 Grok CLI 配置：
1grok inspect确认 grok-4.5 可用，并且配置的端点为 https://api.apipass.dev/grok-build/v1。
发送一次性提示词，验证完整连接：
1grok -p "请严格只回复：ApiPass 已连接" -m grok-4.5在当前项目中启动 Grok 交互式会话：
1grok你也可以从命令行运行一次性提示词：
1grok -p "检查这个代码仓库，并提出最有影响力的改进建议。" -m grok-4.5通过 default 模型设置，交互式会话无需每次传入 -m 即可使用 Grok 4.5。
Grok CLI 通过 Grok Build 端点发送请求时，ApiPass 会扣除积分。具体扣除数量取决于 token 用量和当前生效的 ApiPass 计费规则。
你可以在以下页面查看账户和请求活动：
grok: command not found运行安装程序后，请关闭并重新打开终端。如果命令仍不可用，请按照安装程序给出的 PATH 提示进行操作，然后再次打开新的终端会话。
确认该文件存在于运行 Grok CLI 的同一用户账户和环境中：
1ls -l ~/.grok/config.toml如果使用 WSL2，配置文件应放在 WSL 主目录中。在 Windows 原生用户配置目录中创建的文件，不会被 WSL2 内运行的 CLI 加载。
打开 ~/.grok/config.toml，确认 api_key 中填写的是有效的 ApiPass API Key，而不是占位值：
1api_key = "YOUR_APIPASS_API_KEY"你可以在 ApiPass API Keys 页面创建或管理 API Key。
确认 models_base_url 包含 /grok-build/v1，且不包含 /responses：
1models_base_url = "https://api.apipass.dev/grok-build/v1"Grok Build CLI 端点与通用 Grok API 端点相互独立，因此该配置必须使用上方所示的 URL。
model refresh failed配置自定义 models_base_url 后，某些版本的 Grok CLI 可能会显示不会阻止程序运行的 model refresh failed 警告。静态的 [model."grok-4.5"] 配置项仍可让 Grok 4.5 请求正常工作。
运行一次性验证提示词，确认连接：
1grok -p "请严格只回复：ok" -m grok-4.5请在全部三个配置位置使用准确的模型标识符 grok-4.5：
1default = "grok-4.5"
2web_search = "grok-4.5"
3[model."grok-4.5"]