# Claude Code
> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。
本文介绍如何在 Claude Code 中配置并使用方舟Agent Plan 企业版。
# 前提条件
需由管理员账号完成以下前置操作后，子账号方可配置并使用 Claude Code：
1. 购买方舟 Agent Plan 企业版套餐：[一、购买 Agent Plan 企业版](/docs/agent-plan-enterprise-get-started#purchase-plan)。
2. 为子账号分配席位：[二、分配席位](/docs/agent-plan-enterprise-get-started#assign-seats)。
# 安装 Claude Code
前提条件：
* 安装 [Node.js 18 或更新版本环境](https://nodejs.org/en/download/)。
* Windows 用户需安装 [Git for Windows](https://git-scm.com/download/win)。
在命令行界面，执行以下命令安装 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](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise/mine)。
* **ANTHROPIC_MODEL**：配置文本生成模型。可配置 `ark-code-latest` 或 Model Name，模型信息参见[支持模型及 Harness](/docs/agent-plan-enterprise-plan-overview#supported-models-harness)。
> **注意**
>
> 配置前注意清除以下环境变量，避免与旧配置冲突：
>
> ```Bash
> unset ANTHROPIC_AUTH_TOKEN
> unset ANTHROPIC_BASE_URL
> ```
>
> 若变量在 `~/.bashrc` / `~/.zshrc` 中，可以备份并同步删除对应变量。
## 方式 1：一键配置（推荐）
Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。
1. 安装 Ark CLI
环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。
```Bash
npm install -g @volcengine/ark-cli@latest
arkcli --version
```
2. 登录 Ark CLI
根据界面提示选择登录方式，推荐选择 **火山 SSO (浏览器登录)**，在浏览器中完成授权即可。
```Bash
arkcli auth login
```
3. 一键配置 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`），配置信息如下：
* ``：替换为您的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise/mine)。
* ``：结合套餐及您的需求，更新文本生成模型名称，如 `ark-code-latest`。模型信息参见[支持模型及 Harness](/docs/agent-plan-enterprise-plan-overview#supported-models-harness)。
```JSON
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "",
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/plan",
"ANTHROPIC_MODEL": "",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "",
"CLAUDE_CODE_SUBAGENT_MODEL": "",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
```
> **说明**
>
> * 要开启 1M 上下文窗口，配置参见[扩展上下文](/docs/agent-plan-enterprise-claude-code#extended-context)。
> * 推荐使用完整模型配置，并按任务复杂度选择模型：Haiku（轻量）、Sonnet（日常）、Opus（复杂）。
> * `CLAUDE_CODE_SUBAGENT_MODEL` 建议与主模型保持一致。
> * `ANTHROPIC_DEFAULT_HAIKU_MODEL` 建议设置为小尺寸模型，通常不会影响整体使用效果。
> * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 用于关闭 Claude Code 后台匿名遥测请求，设为 `"1"` 可避免额度被静默消耗。
2. 编辑或新建 `~/.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 官网](https://code.claude.com/docs/zh-CN/quickstart)。
# 其他操作
## 使用 Claude Code 的 Web Search 功能
> **说明**
>
> * 除了通过配置 MCP 或 Skill 使用豆包搜索能力外，在 Agent Plan 企业版场景下，通过 Messages API 接入的 Claude Code 也可原生使用 Web Search 功能。
> * 使用豆包搜索承接的 Web Search 会额外发起大模型 API 请求，对搜索结果进行总结。使用前需前往控制台开启豆包搜索抵扣，否则将无法使用 Web Search 功能。
> * 更多说明参见 [豆包搜索](/docs/agent-plan-enterprise-search)。
完成配置后，按以下步骤在 Claude Code 使用 Web Search 功能。
1. 在控制台开启豆包搜索抵扣。
2. 在 Claude Code 中直接提问，例如"GitHub 最近有哪些热门开源项目"。
## 添加图片生成/视频生成能力
方舟 Agent Plan 企业版 Team Medium 及以上套餐提供图片生成模型配额，Team Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见 [配置视觉模型](/docs/agent-plan-enterprise-visual-models)。
> **注意**
>
> * 不同的套餐支持的视觉模型有所不同，具体参见[支持模型及 Harness](/docs/agent-plan-enterprise-plan-overview#supported-models-harness)。
> * 视觉模型不支持通过 Auto 及控制台切换使用。
## 切换模型
请根据模型配置方式，选择对应的模型切换方案。
|配置方式 |通过控制台 |通过命令参数 |修改配置文件 |
|---|---|---|---|
|切换模型操作 |1. 参考[配置 Claude Code](/docs/agent-plan-enterprise-claude-code#configure-claude-code)配置模型名称为`ark-code-latest`。 |* 启动时：执行`claude --model `，可指定本次对话使用的文本生成模型。 |参考[配置 Claude Code](/docs/agent-plan-enterprise-claude-code#configure-claude-code)配置模型名称为您需要的模型。 | \
| |2. 在 [订阅页面](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise?agentMode=close)，选择**我的** - **使用配置**，选择要使用的模型，切换后 3-5 分钟即可生效。 |* 对话期间：执行`/model `切换模型。 | | \
| |3. 在命令行窗口，启动 Claude Code 后，输入`/status`确认模型状态。 | | |
## 扩展上下文
Agent Plan 企业版支持部分模型开启 1M 上下文窗口，可用于包含大型代码库的长会话。支持模型范围参见[支持模型及 Harness](/docs/agent-plan-enterprise-plan-overview#supported-models-harness)。以 `glm-5.3` 模型为例，配置信息如下：
```JSON
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "",
"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]"
}
}
```
> **注意**
>
> * 开启 1M 上下文时，需要在模型名称后增加 `[1m]` 后缀，如 `glm-5.3[1m]`，同时配置压缩窗口大小参数 `"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"`。
> * 若模型参数加上 `[1m]` 后缀后，Claude Code 识别模型不存在，需升级 Claude Code 到最新版本后重试。
## 使用 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 官方文档](https://github.com/farion1231/cc-switch)。
**选项：macOS**
* Homebrew（推荐）：
```Bash
brew tap farion1231/ccswitch
brew install --cask cc-switch
```
* 手动下载：从 [Releases 页面](https://github.com/farion1231/cc-switch/releases) 下载 `.dmg`。
**选项：Linux**
* Arch 发行版：
```Bash
paru -S cc-switch-bin
```
* 其他发行版：根据架构（Debian / Ubuntu）从 [Releases 页面](https://github.com/farion1231/cc-switch/releases) 下载 `.deb` / `.rpm`，或者下载 `.AppImage`（通用）。
**选项：Windows**
从 [Releases 页面](https://github.com/farion1231/cc-switch/releases) 下载 `.msi` 安装包或 `.zip` 绿色版。
### 添加供应商
1. 在 CC Switch 中添加供应商：
1. 在主界面顶部图标栏选中 Claude Code 图标，点击右上角 **+** 进入添加新供应商。
2. 选择 **火山 Agentplan** 供应商，填写以下信息：
* **API Key**：替换为您的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise/mine)。
* **请求地址**：`https://ark.cn-beijing.volces.com/api/plan`。
3. 展开高级选项，根据当前套餐支持的模型范围，分别配置 Sonnet、Opus、Fable、Haiku 模型，可配置的模型见[支持模型及 Harness](/docs/agent-plan-enterprise-plan-overview#supported-models-harness)。
> **注意**
>
> 建议 Haiku 设置为小尺寸模型。
4. 选择右下角**添加**，完成供应商配置。
2. 回到首页，点击右侧**启用**按钮，新开一个 Claude Code 会话使配置生效。
## 安装使用 Claude Code IDE 插件
Claude Code IDE 插件依赖 Claude Code CLI 工具，需先完成 Claude Code 的安装及配置。
> 因 IDE 插件会迭代演进，以下内容仅供参考，具体的安装及使用可参考 [Visual Studio Code](https://code.claude.com/docs/en/vs-code)、[JetBrains IDEs](https://code.claude.com/docs/en/jetbrains)。
**选项：Claude Code VSCode 插件**
> **说明**
>
> Claude Code VSCode 插件支持在 VSCode 及基于 VSCode 的 IDE（如 Cursor、TraeCode 等）中使用。
### 安装插件
打开 VSCode，在扩展市场搜索 `claude code` 进行安装。
### 配置环境变量
1. 打开 VS Code 左下角设置，打开 **Extensions** - **Claude Code**。
2. 在 **Claude Code: Environment Variables** 区域单击 **Edit in settings.json**，修改 `claudeCode.environmentVariables`、`claudeCode.selectedModel`。
> **说明**
>
> * ``：替换为您的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise/mine)。
> * ``：替换为要使用的模型。
> * 若在 Claude Code 对话框中输入 `/config`，插件仅返回可配置项的用法说明，不提供交互式编辑界面，请走设置入口。
```JSON
...
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://ark.cn-beijing.volces.com/api/plan"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": ""
},
{
"name": "ANTHROPIC_MODEL",
"value": ""
}
],
"claudeCode.selectedModel": "",
...
```
保存配置后，新开一个窗口开始使用 Claude Code。
**选项：Claude Code JetBrains 插件**
> **说明**
>
> Claude Code JetBrains 插件支持 JetBrains 的系列 IDE，如 IntelliJ IDEA、PyCharm、WebStorm 等。
### 安装插件
打开 JetBrains IDE，在插件市场搜索 `claude code` 进行安装。
### 开始使用
安装完成后，重启 IDE 后，单击 Claude Code 图标，进入 Claude Code 页面开始使用。
