文档中心

火山方舟

接入 AI 工具

Claude Code

本文介绍如何在 Claude Code 中配置并使用方舟按量计费模型服务。

前提条件

在配置工具前，需要开通所需的模型服务。

安装 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/compatible。

ANTHROPIC_AUTH_TOKEN：获取API Key。

ANTHROPIC_MODEL：按需选择模型并获取 Model ID。可用模型参见模型列表。

注意

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

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

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

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

安装 Ark CLI

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

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

一键配置 Claude Code

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

选择 Profile：platform_cn-beijing_accountwide。

选择 Endpoint：按需选择要使用的推理接入点。

选择 AI Agent：Claude Code。

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

方式 2：手动配置

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

<ARK_API_KEY>：替换为您的 API Key。

<MODEL_ID>：替换为要使用的 Model ID。

{
"env": {
"ANTHROPIC_AUTH_TOKEN": "<ARK_API_KEY>",
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/compatible",
"ANTHROPIC_MODEL": "<MODEL_ID>",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "<MODEL_ID>",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "<MODEL_ID>",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "<MODEL_ID>",
"CLAUDE_CODE_SUBAGENT_MODEL": "<MODEL_ID>",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}

说明

推荐使用完整模型配置，并按任务复杂度选择模型：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 功能

说明

Claude Code 通过兼容 Anthropic Messages 接口协议的服务调用豆包搜索能力。

调用 Web Search 工具时，大模型可能会发起额外的 API 请求来总结搜索结果，因此会消耗额外的 token。

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

登录控制台，打开应用组件库 > 豆包搜索标签页。

在豆包搜索 Custom 版的操作列中点击开通服务。

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

使用 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 图标，点击右上角 + 进入添加新供应商。

选择自定义配置，填写以下信息：

API Key：替换为您的 API Key。

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

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

注意

建议 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/apikey)。 * ``：替换为要使用的模型。 * 若在 Claude Code 对话框中输入 `/config`，插件仅返回可配置项的用法说明，不提供交互式编辑界面，请走设置入口。

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

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

接入 MCP Server 与 Skill

若内置工具未覆盖您的使用场景，可在 Claude Code 中接入二方、三方 MCP Server 与 Skill，扩展模型可用的能力。

获取 MCP Server

二方：访问智能体工具商店，获取火山引擎生态内的 MCP 工具（如巨量千川、知识库等），在 MCP 详情页获取服务地址与鉴权信息。

三方：接入其他 MCP 市场提供的 MCP Server，或自行部署开源 MCP Server。

注意

请从可信来源获取 MCP Server，其安全性与稳定性由提供方负责，接入前请确认其权限范围符合您的预期。

配置 MCP Server 与 Skill

接入 MCP Server：执行以下命令添加（以 stdio 类型为例）。

claude mcp add <MCP名称> -- <启动命令> <启动参数>

添加完成后，可执行 claude mcp list 查看已接入的 MCP Server。更多说明（如 HTTP/SSE 类型、作用域管理）参考 Claude Code 官方文档。

接入 Skill：将 Skill 目录放入 ~/.claude/skills/（个人全局）或项目下的 .claude/skills/ 目录即可。更多说明参考 Claude Code Skills 说明。

最近更新时间：2026.11.03 21:11:08

这个页面对您有帮助吗？

有用

无用