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

前提条件#

安装 Claude Code#

前提条件：

安装 Node.js 18 或更新版本环境。
Windows 用户需安装 Git for Windows。

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

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

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

1claude --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
2unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

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

手动配置#

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

macOS/Linux 系统 Claude Code 配置文件路径：~/.claude/settings.json。

如果在主目录下没有.claude目录，执行以下命令创建目录。
Bash
```
1mkdir -p ~/.claude
```
创建并打开配置文件。
Bash
```
1nano ~/.claude/settings.json
```

Windows 系统 Claude Code 配置文件路径：%USERPROFILE%\.claude\settings.json。以 CMD 命令行方式为例，操作如下。

如果当前用户目录下没有.claude目录，执行以下命令创建目录。
Bash
```
1if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"
```

创建并打开配置文件。

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

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

<ARK_API_KEY>：替换为您的 API Key。
<Model_ID>：替换为要使用的 Model ID。

1
2
3
4
5
6
7
8
9
10
11
12{
    "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"
    }
}

编辑或新增 .claude.json 文件，修改或新增 hasCompletedOnboarding 字段值为 true。

创建并打开配置文件。
Bash
```
1nano ~/.claude.json
```

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

1
2
3{
  "hasCompletedOnboarding": true
}

创建并打开配置文件。
Bash
```
1notepad "%USERPROFILE%\.claude.json"
```

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

1
2
3{
  "hasCompletedOnboarding": true
}

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

使用 Claude Code#

进入项目目录，执行 claude 命令，启动 Claude Code。
Bash
```
1
2cd my-project
claude
```
启动后，选择信任此文件夹，允许 Claude Code 访问该文件夹中的文件。
输入 /status 确认模型状态。
在 Claude Code 中对话。

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

其他操作#

使用 Claude Code 的 Web Search 功能#

完成配置后，按以下步骤在 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 官方文档。

Homebrew（推荐）：

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

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

Arch 发行版：
Bash
```
1paru -S cc-switch-bin
```
其他发行版：根据架构（Debian / Ubuntu）从 Releases 页面下载 .deb / .rpm，或者下载 .AppImage（通用）。

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

添加供应商#

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

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

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

安装使用 Claude Code IDE 插件#

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

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

安装插件#

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

配置环境变量#

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

接入 MCP Server：执行以下命令添加（以 stdio 类型为例）。
Bash
```
1claude mcp add <MCP名称> -- <启动命令> <启动参数>
```
添加完成后，可执行 claude mcp list 查看已接入的 MCP Server。更多说明（如 HTTP/SSE 类型、作用域管理）参考 Claude Code 官方文档。
接入 Skill：将 Skill 目录放入 ~/.claude/skills/（个人全局）或项目下的 .claude/skills/ 目录即可。更多说明参考 Claude Code Skills 说明。