文档中心

火山方舟

接入 AI 工具

Claude Code

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

前提条件

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

安装 Claude Code

前提条件：

安装 Node.js 18 或更新版本环境。

Windows 用户需安装 Git for Windows。

在命令行界面，执行以下命令安装 Claude Code。

安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。

配置 Claude Code

需配置的信息

如您对 Claude Code 熟悉、使用 CC Switch 等配置工具，或本地已有配置，可获取以下信息直接配置。

ANTHROPIC_BASE_URL：https://ark.cn-beijing.volces.com/api/plan。

ANTHROPIC_AUTH_TOKEN：获取专属 API Key。

ANTHROPIC_MODEL：配置文本生成模型。可配置 ark-code-latest 或 Model Name，模型信息参见支持模型及 Harness。

注意

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

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

方式 1：一键配置（推荐）

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

安装 Ark CLI

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

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

一键配置 Claude Code

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

选择 Profile：agent-plan_cn-beijing_personal。

选择默认 model：按需选择。

选择 AI Agent：Claude Code。

支持配置 Harness 能力，根据界面提示按需选择配置或者跳过。

配置完成后，Claude Code 会自动识别配置的模型。启动 Claude Code 即可使用。

方式 2：手动配置

新建 ~/.claude/settings.json（Windows 路径：%USERPROFILE%\.claude\settings.json），配置信息如下：

<ARK_API_KEY>：替换为您的专属 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 后台匿名遥测请求，设为 "1" 可避免额度被静默消耗。

编辑或新建 ~/.claude.json（Windows 路径：%USERPROFILE%\.claude.json），将 hasCompletedOnboarding 设置为 true，跳过官方登录验证。

{
"hasCompletedOnboarding": true
}

保存配置文件后，在新的终端窗口执行后续命令。

使用 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 请求，对搜索结果进行总结。使用前需前往控制台开启豆包搜索抵扣，否则将无法使用 Web Search 功能。

更多说明参见豆包搜索。

完成配置后，按以下步骤在 Claude Code 使用 Web Search 功能。

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

在 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配置模型名称为您需要的模型。

扩展上下文

Agent Plan 支持部分模型开启 1M 上下文窗口，可用于包含大型代码库的长会话。支持模型范围参见支持模型及 Harness。以 glm-5.3 模型为例，配置信息如下：

注意

开启 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：替换为您的专属 API Key。

请求地址：https://ark.cn-beijing.volces.com/api/plan。

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

注意

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

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

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

安装使用 Claude Code IDE 插件

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

因 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 左下角设置，打开 Extensions - Claude Code。

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

* ``：替换为您的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentPlan)。 * ``：替换为要使用的模型。 * 若在 Claude Code 对话框中输入 `/config`，插件仅返回可配置项的用法说明，不提供交互式编辑界面，请走设置入口。

...
"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.11.04 17:47:42

这个页面对您有帮助吗？

有用

无用