面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/ai-tools-grok.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

Grok

本文介绍如何在 Grok CLI 中配置并使用方舟 按量计费模型服务。

前提条件#

安装 Grok CLI#

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

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

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

Bash
grok --help

安装 Git for Windows,打开 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 版本。

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

Bash
grok --help

配置 Grok CLI#

方式 1:一键配置(推荐)#

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

  1. 安装 Ark CLI

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

Bash
npm install -g @volcengine/ark-cli@latest
arkcli --version
  1. 登录 Ark CLI

    根据界面提示选择登录方式,推荐选择 火山 SSO (浏览器登录),在浏览器中完成授权即可。

Bash
arkcli auth login
  1. 一键配置 Grok CLI
Bash
arkcli helper

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

  • 选择 Profile:platform_cn-beijing_accountwide。
  • 选择 Endpoint:按需选择要使用的推理接入点。
  • 选择 AI Agent:Grok。

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

方式 2:手动配置#

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

  • <ARK_API_KEY>:替换为您自己的 API Key。
  • model:更新为需要使用的 Model ID,模型列表参见 模型列表。
toml
[model."doubao-seed-evolving"]
model = "doubao-seed-evolving"
base_url = "https://ark.cn-beijing.volces.com/api/v3"
api_backend = "chat_completions"
api_key = "<ARK_API_KEY>"
name = "doubao-seed-evolving"

[models]
default = "doubao-seed-evolving"

使用 Grok CLI#

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

    Bash
    grok
    
  2. 输入以下需求,验证模型能够回复并读取工作区。如果返回当前项目的文件结构,说明 Grok CLI 已完成方舟接入。

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