面向 AI 助手：本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/ai-tools-claude-code.md，全部文档索引见 https://ark.volcengine.com/llms.txt。

Claude Code

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

前提条件#

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

安装 Claude Code#

前提条件：

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

Bash
npm install -g @anthropic-ai/claude-code

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

Bash
claude --version

配置 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。可用模型参见模型列表。

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

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

  1. 安装 Ark CLI

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

Bash
npm install -g @volcengine/ark-cli@latest
arkcli --version

  1. 登录 Ark CLI

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

Bash
arkcli auth login
  1. 一键配置 Claude Code
Bash
arkcli helper

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

  • 选择 Profile：platform_cn-beijing_accountwide。
  • 选择 Endpoint：按需选择要使用的推理接入点。
  • 选择 AI Agent：Claude Code。

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

方式 2：手动配置#

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

    • <ARK_API_KEY>：替换为您的 API Key。
    • <MODEL_ID>：替换为要使用的 Model ID。
    JSON
    {
    "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"
    }
}

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

    JSON
    {
    "hasCompletedOnboarding": true
}

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

使用 Claude Code#

  1. 进入项目目录，执行 claude 命令，启动 Claude Code。

    Bash
    cd my-project
claude

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

  3. 输入 /status 确认模型状态。

  4. 在 Claude Code 中对话。

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

其他操作#

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

  1. 登录控制台，打开 应用组件库 > 豆包搜索 标签页。
  2. 在豆包搜索 Custom 版的操作列中点击开通服务。
    image-20260922-225128-888.png
  3. 在 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 官方文档。

  • Homebrew（推荐）：

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

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

  • Arch 发行版：

    Bash
    paru -S cc-switch-bin

  • 其他发行版：根据架构（Debian / Ubuntu）从 Releases 页面 下载 .deb / .rpm，或者下载 .AppImage（通用）。

从 Releases 页面 下载 .msi 安装包或 .zip 绿色版。

添加供应商#

  1. 在 CC Switch 中添加供应商：
    1. 在主界面顶部图标栏选中 Claude Code 图标，点击右上角 + 进入添加新供应商。
    2. 选择 自定义配置，填写以下信息：
      • API Key：替换为您的 API Key。
      • 请求地址：https://ark.cn-beijing.volces.com/api/compatible。
    3. 展开高级选项，根据当前支持的模型范围，分别配置 Sonnet、Opus、Fable、Haiku 模型，可配置的模型见模型列表。
4. 选择右下角**添加**，完成供应商配置。
  1. 回到首页，点击右侧启用按钮，新开一个 Claude Code 会话使配置生效。

安装使用 Claude Code IDE 插件#

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

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

安装插件#

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

配置环境变量#

  1. 打开 VS Code 左下角设置，打开 Extensions - Claude Code。
  2. 在 Claude Code: Environment Variables 区域单击 Edit in settings.json，修改 claudeCode.environmentVariables、claudeCode.selectedModel。
```JSON
...
"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。

安装插件#

打开 JetBrains IDE，在插件市场搜索 claude code 进行安装。

开始使用#

安装完成后，重启 IDE 后，单击 Claude Code 图标，进入 Claude Code 页面开始使用。

接入 MCP Server 与 Skill#

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

获取 MCP Server#

  • 二方：访问 智能体工具商店，获取火山引擎生态内的 MCP 工具（如巨量千川、知识库等），在 MCP 详情页获取服务地址与鉴权信息。
  • 三方：接入其他 MCP 市场提供的 MCP Server，或自行部署开源 MCP Server。

配置 MCP Server 与 Skill#

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

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

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

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