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

Claude Code

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

前提条件#

需由管理员账号完成以下前置操作后，子账号方可配置并使用 Claude Code：

  1. 购买方舟 Agent Plan 企业版套餐：一、购买 Agent Plan 企业版。
  2. 为子账号分配席位：二、分配席位。

安装 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/plan。
  • ANTHROPIC_AUTH_TOKEN：获取专属 API Key。
  • ANTHROPIC_MODEL：配置文本生成模型。可配置 ark-code-latest 或 Model Name，模型信息参见支持模型及 Harness。

方式 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：agent-plan-team_cn-beijing_team。
  • 选择默认 model：按需选择。
  • 选择 AI Agent：Claude Code。
    支持配置 Harness 能力，根据界面提示按需选择配置或者跳过。

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

方式 2：手动配置#

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

    • <ARK_API_KEY>：替换为您的 专属 API Key。
    • <MODEL_NAME>：结合套餐及您的需求，更新文本生成模型名称，如 ark-code-latest。模型信息参见支持模型及 Harness。
    JSON
    {
    "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"
    }
}

  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. 在控制台开启豆包搜索抵扣。
    agent-plan-enterprise-search-enable.png
  2. 在 Claude Code 中直接提问，例如"GitHub 最近有哪些热门开源项目"。

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

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

切换模型#

请根据模型配置方式，选择对应的模型切换方案。

配置方式 通过控制台 通过命令参数 修改配置文件
切换模型操作 1. 参考配置 Claude Code配置模型名称为ark-code-latest。
2. 在 订阅页面，选择我的 - 使用配置，选择要使用的模型，切换后 3-5 分钟即可生效。
3. 在命令行窗口，启动 Claude Code 后，输入/status确认模型状态。
  • 启动时：执行claude --model <Model_Name>，可指定本次对话使用的文本生成模型。
  • 对话期间：执行/model <Model_Name>切换模型。
 参考配置 Claude Code配置模型名称为您需要的模型。

扩展上下文#

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

JSON
{
    "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 官方文档。

  • 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. 选择 火山 Agentplan 供应商，填写以下信息：
      • API Key：替换为您的 专属 API Key。
      • 请求地址：https://ark.cn-beijing.volces.com/api/plan。
    3. 展开高级选项，根据当前套餐支持的模型范围，分别配置 Sonnet、Opus、Fable、Haiku 模型，可配置的模型见支持模型及 Harness。
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/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 页面开始使用。