文档中心

火山方舟

接入 AI 工具

Claude Code

本文介绍如何配置方舟 Agent Plan 到 Claude Code 中使用。

一、前提条件

您已按需订阅 Agent Plan 套餐。如未，请访问开通管理-Agent Plan 页面订阅套餐。

您已正确安装 Claude Code，如未，请参考官方文档的安装章节完成软件安装。

二、配置 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 等方式完成配置。

注意

配置前注意清除以下环境变量，避免与旧配置冲突：

unset ANTHROPIC_AUTH_TOKEN​
unset ANTHROPIC_BASE_URL​

若变量在 ~/.bashrc / ~/.zshrc 中，可以备份并同步删除对应变量。

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

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

注意

ArkCLI Helper 是基于 Ark Helper 升级演进的工具配置服务，相关能力将持续在 ArkCLI Helper 上迭代更新。建议优先使用 ArkCLI Helper 完成工具配置。

ArkCLI Helper 支持 macOS、Linux、Windows 系统。

安装 Ark CLI。

# 1. 通过 NPM 安装
npm install -g @volcengine/ark-cli@latest

# 2. 验证安装
arkcli --version

arkcli auth login

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

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

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

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

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

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

选择默认 model：按需选择。

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

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

完成上述操作后，将自动完成 Claude Code 的基础配置；若选择了相关 Harness 能力，也会自动完成对应工具安装。

方式 2：手动配置

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

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

macOS/Linux
Windows
macOS/Linux 系统 Claude Code 配置文件路径：~/.claude/settings.json。
如果在主目录下没有.claude目录，执行以下命令创建目录。

mkdir -p ~/.claude

创建并打开配置文件。

nano ~/.claude/settings.json
Windows 系统 Claude Code 配置文件路径：C:\Users\<用户名>\.claude\settings.json。以 CMD 命令行方式为例，操作如下。
如果当前用户目录下没有.claude目录，执行以下命令创建目录。

if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"

创建并打开配置文件。

notepad "%USERPROFILE%\.claude\settings.json"

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

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

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

{
"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"
}
}

说明

要开启 1M 上下文窗口，配置参见扩展上下文。

推荐使用完整模型配置，并按任务复杂度选择模型：Haiku（轻量）、Sonnet（日常）、Opus（复杂）。

CLAUDE_CODE_SUBAGENT_MODEL 建议与主模型保持一致。

ANTHROPIC_DEFAULT_HAIKU_MODEL 建议设置为小尺寸模型，通常不会影响整体使用效果。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 用于关闭 Claude Code 后台匿名遥测请求。遥测请求默认会走 ANTHROPIC_BASE_URL 并占用 Agent Plan 配额，设为 "1" 可避免额度被静默消耗（方式 1 的 ArkCLI Helper 会自动配置此项）。

如需关闭思考（thinking）模式，需要在 env 中添加 "CLAUDE_CODE_EXTRA_BODY": "{\"thinking\":{\"type\":\"disabled\"}}"。

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

macOS/Linux
Windows
创建并打开配置文件。

nano ~/.claude.json

修改或新增的字段信息如下：

{
"hasCompletedOnboarding": true
}
创建并打开配置文件。

notepad "%USERPROFILE%\.claude.json"

修改或新增的字段信息如下：

{
"hasCompletedOnboarding": true
}

三、启动并使用 Claude Code

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

cd my-project
claude

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

模型状态验证：输入/status确认模型状态。

在 Claude Code 中对话。

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

其他操作

使用 Claude Code 的 Web Search 功能

说明

除了通过配置 MCP 或 Skill 使用豆包搜索能力外，在 Agent Plan 场景下，通过 Messages API 接入的 Claude Code 也可原生使用 Web Search 功能。

使用豆包搜索承接的 Web Search 会额外发起大模型 API 请求，对搜索结果进行总结。使用前需前往控制台开启豆包搜索抵扣，否则将按后付费计费。

更多说明参见豆包搜索。

完成配置后，可按以下顺序验证 Claude Code 联网搜索能力：

在控制台开启豆包搜索抵扣。

在 Claude Code 中直接提问，例如“GitHub 最近有哪些热门开源项目”。

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

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

注意

不同的套餐支持的视觉模型有所不同，具体参见支持模型及 Harness。

视觉模型不支持通过 Auto 及控制台切换使用。

切换模型

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

配置方式	通过控制台	通过命令参数	修改配置文件
切换模型操作	参考二、配置 Claude Code配置模型名称为ark-code-latest。在开通管理页面选择要使用的模型，切换后3-5分钟即可生效。在命令行窗口，启动 Claude Code 后，输入/status确认模型状态。	启动时：执行claude --model <MODEL_NAME>，可指定本次对话使用的文本生成模型。对话期间：执行/model <MODEL_NAME>切换模型。	参考二、配置 Claude Code配置模型名称为您需要的模型。

扩展上下文

glm-5.3、deepseek-v4.1-flash、deepseek-v4-flash、deepseek-v4-pro 支持 1M 上下文窗口，可用于包含大型代码库的长会话。以 glm-5.3 模型为例，配置信息如下：

{​
    "env": {​
        "ANTHROPIC_AUTH_TOKEN": "<ARK_API_KEY>",​
        "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/plan",​
        "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",​
        "ANTHROPIC_MODEL": "glm-5.3[1m]",​
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3[1m]",​
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3[1m]",​
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3[1m]"​
    }​
}​

注意

开启 1M 上下文时，需要在模型名称后增加 [1m] 后缀，如 glm-5.3[1m]，同时配置压缩窗口大小参数 "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"。

若模型参数加上 [1m] 后缀后，Claude Code 识别模型不存在，需升级 Claude Code 到最新版本后重试。

使用 CC Switch

CC Switch 是一款跨平台桌面应用，专为使用 AI 编程工具的开发者设计。它帮助你统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes 等受管应用的配置。

支持的平台

Windows 10 及以上

macOS 12 (Monterey) 及以上

Linux Ubuntu 22.04+ / Debian 11+ / Fedora 34+（x64 / ARM64）

安装

更多安装方式和详细说明请参考 CC Switch 官方文档。

macOS

Linux

Windows

Homebrew（推荐）：

brew tap farion1231/ccswitch
brew install --cask cc-switch

手动下载：从 Releases 页面下载 .dmg。

添加供应商

在 CC Switch 中添加供应商：

在主界面顶部图标栏选中 Claude Code 图标，点击右上角 + 进入添加新供应商。

选择火山 Agentplan 供应商，填写以下信息：

API Key：替换为您的 ARK Agent Plan API Key

请求地址：已自动填写为 https://ark.cn-beijing.volces.com/api/plan

展开高级选项，根据当前套餐支持的模型范围，分别配置 Sonnet、Opus、Fable、Haiku 模型，可配置的模型见支持模型及 Harness。

注意

建议 Haiku 设置为小尺寸模型。

选择右下角添加，完成供应商配置。

回到首页，点击右侧启用按钮，新开一个 Claude Code 会话使配置生效。

安装使用 Claude Code IDE 插件

安装 Claude Code 并配置好环境变量，具体参考Claude Code。

Claude Code IDE 插件依赖 Claude Code CLI 工具，需先完成 Claude Code的安装及配置。

安装并使用 IDE 插件。

因 IDE 插件会迭代演进，以下内容仅供参考，具体的安装及使用可参考 Visual Studio Code、JetBrains IDEs。

Claude Code VSCode 插件

Claude Code JetBrains 插件

说明

Claude Code VSCode 插件支持在 VSCode 及基于 VSCode 的 IDE（如 Cursor、TraeCode 等）中使用。

安装插件

打开 VSCode，在扩展市场搜索claude code进行安装。

配置环境变量

打开 VS Code 左下角打开设置，打开Etensions - Claude Code。

在 Claude Code: Environment Variables 区域单击 Edit in settings.json，修改claudeCode.environmentVariables、claudeCode.selectedModel。

说明

需要修改的配置信息如下：

<ARK_API_KEY>：替换为您自己的 Agent Plan API Key

<Model_Name>：更新为需要使用的模型信息，如ark-code-latest。支持的模型信息参见支持模型及Harness中文本生成模型。

若在 Claude Code 对话框中输入 /config，插件仅返回可配置项的用法说明，不提供交互式编辑界面，请走步骤 2 的设置入口。

...​
"claudeCode.environmentVariables": [​
    {​
        "name": "ANTHROPIC_BASE_URL",​
        "value": "https://ark.cn-beijing.volces.com/api/plan"​
    },​
    {​
        "name": "ANTHROPIC_AUTH_TOKEN",​
        "value": "<ARK_API_KEY>"​
    },​
    {​
        "name": "ANTHROPIC_MODEL",​
        "value": "<MODEL_NAME>"​
    }​
],​
"claudeCode.selectedModel": "<MODEL_NAME>",​
...​

保存配置后，新开一个窗口开始使用 Claude Code。

最近更新时间：2026.09.15 00:31:05

这个页面对您有帮助吗？

有用

无用