Grok

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

前提条件#

• 本文通过 npm 安装 ArkCLI，需提前安装 Node.js LTS。
• 已订阅 Agent Plan，并获取 专属 API Key。订阅步骤参见 Agent Plan 快速开始。

第 1 步 · 安装工具#

1. 按操作系统执行 Grok 官方安装脚本。

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

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

2. 安装最新版 ArkCLI。

   Bash

   1npm install -g @volcengine/ark-cli@latest
   

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

   Bash

   1
   2grok --help
   arkcli --version
   

第 2 步 · 配置接入#

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

   Bash

   1
   2arkcli auth login
   arkcli profile list
   

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

   Bash

   1arkcli helper configure grok --profile <AGENT_PLAN_PROFILE> --model ark-code-latest
   

   Helper 使用 OpenAI Chat Completions 协议，Base URL 为 https://ark.cn-beijing.volces.com/api/plan/v3。ark-code-latest 使用控制台配置的路由策略；如需指定模型，将其替换为套餐支持的文本生成 Model Name。可用模型参见 套餐支持的模型。

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

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

4. （可选）只配置豆包搜索能力时，执行以下命令。

   Bash

   1arkcli helper mcp grok --profile <AGENT_PLAN_PROFILE> --capability web-search
   

   Helper 将 MCP 配置写入 ~/.grok/mcp.json；设置 GROK_HOME 后使用对应目录。个人版和企业版均支持豆包搜索与 DataPro，OpenViking 仅适用于个人版。其他 Harness 工具配置参见 helper mcp 命令参考。

第 3 步 · 启动并验证#

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

   Bash

   1grok
   

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

   text

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

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

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

   如果 ArkCLI 提示不支持 grok，升级 ArkCLI 后重新配置；如果返回鉴权错误，核对 profile、API Key 和 Base URL 是否属于同一接入方式。更多检查命令参见 ArkCLI Helper 命令参考。

相关文档#

ArkCLI 认证与配置。

ArkCLI Helper 命令参考。