Grok - 火山方舟文档

本文介绍如何在 Grok CLI 中配置并使用方舟 Agent Plan 企业版。

前提条件#

需由管理员账号完成以下操作后，子账号方可配置并使用 Grok CLI：
1. 购买方舟 Agent Plan 企业版套餐：一、购买 Agent Plan 企业版。
2. 为子账号分配席位：二、分配席位。
安装 Node.js 18 或更新版本。

安装 Grok CLI#

在命令行界面，执行以下命令安装 Grok CLI。

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

安装结束后，执行以下命令查看安装结果，若显示帮助信息则安装成功。

1grok --help

安装 Git for Windows，打开 Git Bash 执行以下命令。也可在 MSYS2 Bash 中运行。

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

官方脚本安装原生 Windows 可执行文件 grok.exe。如需从 PowerShell 或 CMD 启动，将 %USERPROFILE%\.grok\bin 加入用户 PATH，重新打开终端后运行 grok。在 WSL 中执行安装脚本时，使用 Linux 版本。

安装结束后，执行以下命令查看安装结果，若显示帮助信息则安装成功。

1grok --help

配置 Grok CLI#

方式 1：一键配置（推荐）#

Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。

安装 Ark CLI

环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。

1
2npm install -g @volcengine/ark-cli@latest
arkcli --version

1arkcli auth login

一键配置 Grok CLI

1arkcli helper

运行 ArkCLI Helper，根据界面提示完成配置。

选择 Profile：agent-plan-team_cn-beijing_team。
选择默认 model：按需选择。
选择 AI Agent：Grok。

配置完成后，Grok CLI 会自动识别配置的模型。启动 Grok CLI 即可使用。

方式 2：手动配置#

创建并编辑 ~/.grok/config.toml 文件，Windows 系统为 %USERPROFILE%\.grok\config.toml。关注的配置信息如下：

<ARK_API_KEY>：替换为您自己的专属 API Key。
model：配置文本生成模型。可配置 ark-code-latest 或 Model Name，模型信息参见支持模型及 Harness。

1
2
3
4
5
6
7
8
9[model.ark-code-latest]
model = "ark-code-latest"
base_url = "https://ark.cn-beijing.volces.com/api/plan/v3"
api_backend = "chat_completions"
api_key = "<ARK_API_KEY>"
name = "ark-code-latest"

[models]
default = "ark-code-latest"

使用 Grok CLI#

在终端进入需要使用的项目目录，启动 Grok CLI。
Bash
```
1grok
```
输入以下需求，验证模型能够回复并读取工作区。如果返回当前项目的文件结构，说明 Grok CLI 已完成方舟接入。
text
```
1简单介绍一下当前目录的文件结构。
```