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

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

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

1. 安装 Ark CLI。

   Bash

   1
   2
   3
   4
   5# 1. 通过 NPM 安装
   npm install -g @volcengine/ark-cli@latest
   
   # 2. 验证安装
   arkcli --version
   

2. 登录 Ark CLI。

   Bash

   1arkcli auth login
   

   

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

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

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

      

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

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

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

   3. 选择默认 model：按需选择。

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

      

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

方式 2：手动配置#

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

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

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

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

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

   JSON

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

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

三、启动并使用 Claude Code#

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

   Bash

   1
   2cd my-project
   claude
   

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

2. 模型状态验证：输入/status确认模型状态。
3. 在 Claude Code 中对话。

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

其他操作#

使用 Claude Code 的 Web Search 功能#

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

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

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

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

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

切换模型#

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

扩展上下文#

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

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

使用 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 官方文档。

添加供应商#

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

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

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

安装使用 Claude Code IDE 插件#

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

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

2. 安装并使用 IDE 插件。

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

Claude Code VSCode 插件Claude Code JetBrains 插件

安装插件#

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

配置环境变量#

1. 打开 VS Code 左下角打开设置，打开Etensions - Claude Code。
   
2. 在 Claude Code: Environment Variables 区域单击 Edit in settings.json，修改claudeCode.environmentVariables、claudeCode.selectedModel。

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17...
"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。

安装插件#

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

开始使用#

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