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

Claude Code

本文介绍如何配置方舟 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：获取专属 API Key，为专属 API Key，其他方舟 API Key 如Coding Plan API Key 无法在 Agent Plan 企业版中使用。

agent-plan-enterprise-api-key.png

  • ANTHROPIC_MODEL：见 支持模型及Harness，不同 Agent Plan 企业版套餐支持的模型不同。请先配置文本生成模型，后续图片生成模型、视频生成模型等可在 Claude Code 中使用自然语言/Skill 等方式完成配置。

手动配置#

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

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

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

  1. 如果在主目录下没有.claude目录，执行以下命令创建目录。

    Bash
    mkdir -p ~/.claude

  2. 创建并打开配置文件。

    Bash
    nano ~/.claude/settings.json

Windows 系统 Claude Code 配置文件路径：C:\Users\<用户名>\.claude\settings.json。以 CMD 命令行方式为例，操作如下。

  1. 如果当前用户目录下没有.claude目录，执行以下命令创建目录。

    Bash
    if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"

  2. 创建并打开配置文件。

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

  1. 编辑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 文件，修改或新增 hasCompletedOnboarding 字段值为 true，设置状态为完成入门引导。

  1. 创建并打开配置文件。

    Bash
    nano ~/.claude.json

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

    JSON
    {
  "hasCompletedOnboarding": true
}

  1. 创建并打开配置文件。

    Bash
    notepad "%USERPROFILE%\.claude.json"

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

    JSON
    {
  "hasCompletedOnboarding": true
}

三、启动并使用 Claude Code#

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

    Bash
    cd my-project
claude

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

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

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

其他操作#

使用 Claude Code 的 Web Search 功能#

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

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

agent-plan-enterprise-search-enable.png

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

claude-web-search.png

配置视觉模型#

方舟 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配置模型名称为您需要的模型。

扩展上下文#

glm-5.3、glm-5.3-flash、deepseek-v4.1-flash、deepseek-v4-flash、deepseek-v4-pro 支持 1M 上下文窗口，可用于包含大型代码库的长会话。以 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（通用）。

添加供应商#

  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 插件#

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

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

  2. 安装并使用 IDE 插件。

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

安装插件#

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

配置环境变量#

  1. 打开 VS Code 左下角打开设置，打开Etensions - Claude Code。
    claude-code-setings-json.png
  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 页面开始使用。