本文介绍如何在 AI 工具中快速配置和使用 Agent Plan。 # 核心配置需要获取 Agent Plan 支持的专属 Base URL、专属 API Key及模型配置，才能正常使用并抵扣套餐额度。 ## 专属 Base URL 不同的工具配置的 Base URL 根据兼容的协议会有不同： * 兼容 Anthropic 接口协议工具：`https://ark.cn-beijing.volces.com/api/plan` * 兼容 OpenAI 接口协议工具：`https://ark.cn-beijing.volces.com/api/plan/v3`（目前还不支持 Responses API，建议使用 Chat API。） :::warning 请勿使用 `https://ark.cn-beijing.volces.com/api/v3` ，接入会产生额外费用。 ::: ## 专属 API Key [获取专属 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentPlan) ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d11b0376e5f24d2f86e634aebcc91cb1~tplv-goo7wpa0wc-image.image =689x) :::warning Agent Plan 专属 API Key 与火山方舟平台的 API Key 不同，请勿混用。 ::: ## 模型配置 ### 语言模型 Agent Plan 支持的语言模型及配置方式如下： ```mixin-react return ( ); ``` ### 向量化模型支持的向量化模型：`doubao-embedding-vision`（对应模型 [doubao-embedding-vision-251215](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-embedding-vision)） :::warning * 向量化模型的 Base URL 请参见[配置向量化模型](/docs/82379/2375464)。 * 建议固定使用同一版本的向量化模型，请勿混用不同版本。 * 向量化模型只支持在配置文件中指定 Model Name，不支持通过 Auto 及控制台切换使用。 ::: ### 视觉模型在工具配置文件中指定 Model Name： * `doubao-seedream-5.0-lite` * `doubao-seedance-1.5-pro` * `doubao-seedance-2.0` * `doubao-seedance-2.0-fast` :::warning * 视觉模型的 Base URL 请参见[配置视觉模型](/docs/82379/2375486)。 * 不同的套餐支持的视觉模型有所不同，具体参见[支持模型及Harness](/docs/82379/2366394#197e422c)。 * 视觉模型不支持通过 Auto 及控制台切换使用。 ::: # 步骤一：购买 Agent Plan 进入 [Agent Plan 控制台](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan)，按需购买套餐。套餐介绍参见[套餐概览](/docs/82379/2366394)。 # 步骤二：选择 AI 工具 Agent Plan 支持主流的 AI 工具，可按需选择。 **Claude Code** AI 终端编程助手，自然语言编程 **Roo Code** 轻量级编程助手 **OpenCode** 开源 AI 编程代理工具 **Cline** VSCode 扩展，代码补全和调试 **Kilo Code** 轻量高性能编程工具 **OpenClaw** 开源、自托管个人 AI 助手 **Cursor** AI 原生代码编辑器 **Hermes Agent** 开源自主 AI 智能体 # 步骤三：配置 AI 工具下面以 Claude Code 为例介绍如何使用 Agent Plan。 ## 安装 Claude Code 前提条件： * 安装 [Node.js 18 或更新版本环境](https://nodejs.org/en/download/)。 * Windows 用户需安装 [Git for Windows](https://git-scm.com/download/win)。在命令行界面，执行以下命令安装 Claude Code。 ```Bash npm install -g @anthropic-ai/claude-code ``` 安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。 ```Bash claude --version ``` ## 配置工具 ### 配置语言模型完成Claude Code安装后，配置以下信息。 * **ANTHROPIC_BASE_URL**：`https://ark.cn-beijing.volces.com/api/coding` * **ANTHROPIC_AUTH_TOKEN**：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentPlan) * **ANTHROPIC_MODEL**: 支持配置 Model Name （实时切换模型）、配置`ark-code-latest`（控制台切换模型）两种方式，具体见[语言模型](/docs/82379/2373738#373744b3)。配置步骤如下： 1. 创建并打开 `settings.json` 配置文件。文件路径因系统而异，具体操作如下： ```mixin-react return ( \\.claude\\settings.json\`。以 CMD 命令行方式为例，操作如下。 1. 如果当前用户目录下没有\`.claude\`目录，执行以下命令创建目录。 \`\`\`Bash if not exist "%USERPROFILE%\\.claude" mkdir "%USERPROFILE%\\.claude" \`\`\` 2. 创建并打开配置文件。 \`\`\`Bash notepad "%USERPROFILE%\\.claude\\settings.json" \`\`\` `}>); ``` 2. 编辑配置文件，需要修改的配置信息如下： * ``：替换为您自己的 [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentPlan) * ``：更新为需要使用的模型信息，如 `ark-code-latest`。支持的模型信息参见[语言模型](/docs/82379/2373738#373744b3)。 ```JSON { "env": { "ANTHROPIC_AUTH_TOKEN": "", "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/plan", "ANTHROPIC_MODEL": "" } } ``` 3. 编辑或新增 `.claude.json` 文件，修改或新增 `hasCompletedOnboarding` 字段值为 true。 1. 不同系统`.claude.json`配置文件路径如下： * macOS/Linux：`~/.claude.json` * Windows：`C:\Users\<用户名>\.claude.json` 2. 修改或新增的字段信息如下： ```JSON { "hasCompletedOnboarding": true } ``` 保存配置文件后，在新的终端窗口执行后续命令。 ### 配置视觉模型方舟 Agent Plan 提供生图、生视频模型，支持通过 AI 工具的 Skill 接入并使用。具体配置方法请参见[配置视觉模型](/docs/82379/2375486)。 :::warning * 不同的套餐支持的视觉模型有所不同，具体参见[支持模型及Harness](/docs/82379/2366394#197e422c)。 * 视觉模型不支持通过 Auto 及控制台切换使用。 ::: ## 使用 Claude Code 1. 启动 Claude Code：进入项目目录，执行`claude`命令，即可开始使用 Claude Code。 ```Bash cd my-project claude ``` 启动后，选择信任此文件夹，允许 Claude Code 访问该文件夹中的文件。 2. 模型状态验证：输入`/status`确认模型状态。 3. 在 Claude Code 中对话。 ## 切换模型请根据模型配置方式，选择对应的模型切换方案。 |配置方式 |配置`ark-code-latest` |配置 Model Name | |---|---|---| |切换模型操作 |1. 在[开通管理页面](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan)选择要使用的模型，切换后3\-5分钟即可生效。|* 启动时：执行`claude --model `，可指定对应的模型。|\ | |2. 在命令行窗口，启动 Claude Code 后，输入`/status`确认模型状态。 |* 对话期间：执行`/model `切换模型。 |