# Grok

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

本文介绍如何通过 ArkCLI Helper 为 Grok CLI 配置方舟 Coding Plan，并在项目目录中启动工具完成首次对话。

<span id="prerequisites"></span>
## 前提条件

- 本文通过 npm 安装 ArkCLI，需提前安装 [Node.js LTS](https://nodejs.org/en/download/)。
- 已订阅 Coding Plan，并获取 [API Key](https://ark.volcengine.com/region:cn-beijing/apikey)。订阅步骤参见 [Coding Plan 快速开始](/docs/coding-plan-personal-get-started)。

<span id="install-grok"></span>
## 第 1 步 · 安装工具

1. 按操作系统执行 [Grok 官方安装脚本](https://x.ai/cli/install.sh)。

**选项：macOS / Linux**

在终端执行以下命令。

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

**选项：Windows**

安装 [Git for Windows](https://gitforwindows.org/)，打开 Git Bash 执行以下命令。也可在 MSYS2 Bash 中运行。

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

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

2. 安装最新版 ArkCLI。

    ```Bash
    npm install -g @volcengine/ark-cli@latest
    ```

3. 打开新的终端会话，检查安装结果。以下命令应分别显示 Grok CLI 帮助和 ArkCLI 版本。

    ```Bash
    grok --help
    arkcli --version
    ```

<span id="configure-grok"></span>
## 第 2 步 · 配置接入

1. 登录 ArkCLI，并查看可用 profile。

    ```Bash
    arkcli auth login
    arkcli profile list
    ```

2. 选择 `coding-plan` 类型的 profile。将 `<CODING_PLAN_PROFILE>` 替换为列表中对应的 profile 名称。

    ```Bash
    arkcli helper configure grok --profile <CODING_PLAN_PROFILE> --model ark-code-latest
    ```

    Helper 使用 OpenAI Chat Completions 协议，Base URL 为 `https://ark.cn-beijing.volces.com/api/coding/v3`。`ark-code-latest` 使用控制台配置的路由策略；如需指定模型，将其替换为套餐支持的 Model Name。可用模型参见 [套餐支持的模型](/docs/coding-plan-personal-plan-overview#supported-models)。

> **注意**
>
> 使用 Coding Plan 时，保持套餐专属 Base URL `https://ark.cn-beijing.volces.com/api/coding/v3`。改为按量计费地址 `https://ark.cn-beijing.volces.com/api/v3` 后，请求按模型服务计费，不抵扣 Coding Plan 额度。

3. 确认 Helper 输出的模型和 Base URL 与所选资源一致。

    Helper 默认写入 `~/.grok/config.toml`：`model_providers` 保存 provider，`model` 保存模型清单，`models.default` 指向选定模型。`api_backend` 为 `chat_completions`。设置 `GROK_HOME` 后，配置写入该环境变量指定的目录。

<span id="use-grok"></span>
## 第 3 步 · 启动并验证

1. 在终端进入需要使用的项目目录，启动 Grok CLI。

    ```Bash
    grok
    ```

2. 输入以下需求，验证模型能够回复并读取工作区。

    ```text
    简单介绍一下当前目录的文件结构。
    ```

    如果返回当前项目的文件结构，说明 Grok CLI 已完成方舟接入。

3. 如果配置后仍使用旧模型，退出 Grok CLI，确认启动终端中的 `GROK_HOME` 与配置时一致，再重新启动。

    如果 ArkCLI 提示不支持 `grok`，升级 ArkCLI 后重新配置；如果返回鉴权错误，核对 profile、API Key 和 Base URL 是否属于同一接入方式。更多检查命令参见 [ArkCLI Helper 命令参考](/docs/tools-and-platform#helper-command)。

<span id="related-docs"></span>
## 相关文档

[ArkCLI 认证与配置](/docs/auth-and-configuration)。

[ArkCLI Helper 命令参考](/docs/tools-and-platform#helper-command)。