快速开始

本文介绍如何在 AI 工具中快速配置和使用 Agent Plan。

一、购买 Agent Plan#

进入 Agent Plan 控制台，按需购买套餐。套餐介绍参见套餐概览。

二、选择 AI 工具#

Agent Plan 支持主流的 AI 工具，可按需选择。

三、配置 AI 工具#

下面以 Claude Code 为例介绍如何使用 Agent Plan。

1.安装 Claude Code#

请参考 官方文档的安装章节 完成 Claude Code 安装 。

2. 配置 Claude Code#

需配置的信息#

如您对 Claude Code 熟悉 / 使用 cc-switch 等配置工具 / 本地已有配置 / 已有本地 Agent等，可获取下列信息直接配置/让本地 Agent 帮您配置。

• ANTHROPIC_BASE_URL：https://ark.cn-beijing.volces.com/api/plan，为专属 Base URL，其他 Base URL 无法在 Agent Plan 中使用。

• ANTHROPIC_AUTH_TOKEN：获取 Agent Plan API Key，为专属 API Key，其他方舟 API Key 如Coding Plan API Key 无法在 Agent Plan 中使用。

  

• ANTHROPIC_MODEL：见 支持模型及 Harness，不同 Agent Plan 套餐支持的模型不同。请先配置文本生成模型，后续图片生成模型、视频生成模型等可在 Claude Code 中使用自然语言/Skill 等方式完成配置。

方式 1：自动化助手（推荐）#

ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Agent Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。

1. 安装 Ark CLI。

   Bash

   1
   2
   3
   4
   5# 1. 通过 NPM 安装
   npm install -g @volcengine/ark-cli@latest
   
   # 2. 验证安装
   arkcli --version
   

2. 登录 Ark CLI。

   Bash

   1arkcli auth login
   

   

   根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：

   1. 选择项目（Project）：可按需选择，或默认选择账号全部资源。

   2. 选择消费模式（Type）：选择 agent-plan。

      

3. 运行 ArkCLI Helper，根据界面提示完成 Claude Code 的配置。

   1. 在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。

   2. 选择要配置的 Plan profile：agent-plan_cn-beijing_personal (Agent Plan)。

      

   3. 选择默认 model：按需选择。

   4. 选择要配置的 AI Agent：Claude Code。

      当前支持的 Harness 包括：豆包搜索、专业数据集、Agent 记忆（OpenViking）、AI Native 应用开发底座，根据界面提示按需选择配置或者跳过。

      

完成上述操作后，将自动完成 Claude Code 的基础配置，并按选择结果自动安装对应的 Harness 工具，无需手动安装。

方式 2：手动配置#

下面详细介绍如何手动完成上述信息配置。

1. 创建并打开 settings.json 配置文件。文件路径因系统而异，具体操作如下：

2. 编辑settings.json，需修改的配置信息如下：

   • <ARK_API_KEY>：替换为您的 ARK Agent Plan API Key

   • <MODEL_NAME>：结合套餐及您的需求，更新文本生成模型的名称，如 ark-code-latest，详细模型名称参见 支持模型及 Harness。

   JSON

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12{
       "env": {
           "ANTHROPIC_AUTH_TOKEN": "<ARK_API_KEY>",
           "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/plan",
           "ANTHROPIC_MODEL": "<MODEL_NAME>",
           "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<MODEL_NAME>",
           "ANTHROPIC_DEFAULT_SONNET_MODEL": "<MODEL_NAME>",
           "ANTHROPIC_DEFAULT_OPUS_MODEL": "<MODEL_NAME>",
           "CLAUDE_CODE_SUBAGENT_MODEL": "<MODEL_NAME>",
           "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
       }
   }
   

3. 编辑或新增 .claude.json 文件，修改或新增 hasCompletedOnboarding 字段值为 true，设置状态为完成入门引导。

3.启动并使用 Claude Code#

1. 启动Claude Code：进入项目目录，执行claude命令，即可开始使用 Claude Code。

   Bash

   1
   2cd <your-project-dir>
   claude
   

   启动后，选择信任此文件夹，允许 Claude Code 访问该文件夹中的文件。

2. 模型状态验证：输入/model确认使用的模型指定正确。
3. 在 Claude Code 中对话。

更多使用教程请参见 Claude Code 官网。

其他操作#

添加图片生成/视频生成能力#

方舟 Agent Plan Medium 及以上套餐提供图片生成模型配额，Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见：

• 方式 2：手动配置
• 配置图片生成模型

切换模型#

你可以随时根据需求切换文本生成模型。方舟支持多种方式切换模型。

#