# 快速开始
> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。
本文介绍如何在 AI 工具中快速配置和使用 Agent Plan 企业版。
# 一、购买 Agent Plan 企业版
企业账号管理员通过 IAM 用户登录控制台，进入 [Agent Plan 企业版](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise?agentMode=close)，按需购买套餐。套餐介绍参见[套餐概览](/docs/agent-plan-enterprise-plan-overview)。
# 二、分配席位
若您使用的账号还未获取席位，需要联系企业账号管理员分配席位。以下为账号管理员操作步骤：
1. 点击进入 [Agent Plan 企业版](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise?agentMode=close)，选择**席位管理**页签。
2. 根据界面提示，为账号绑定席位。需要关注席位对应的套餐信息。
完成绑定后，该账号即可获取相应的使用席位，完成 AI 工具配置后即可正常使用 Agent Plan 企业版套餐。
# 三、选择 AI 工具
Agent Plan 企业版支持主流的 AI 工具，席位用户可按需选择。
**[Claude Code](/docs/agent-plan-enterprise-claude-code)**
AI 终端编程助手，自然语言编程
**[TraeCode](/docs/agent-plan-enterprise-trae)**
智能 IDE，构建新一代编程工作流
**[Roo Code](/docs/agent-plan-enterprise-other-tools)**
轻量级编程助手
**[Codex CLI](/docs/agent-plan-enterprise-codex)**
OpenAI 推出的命令行编程工具
**[Pi](/docs/agent-plan-enterprise-pi)**
开源终端编程 Agent
**[OpenCode](/docs/agent-plan-enterprise-opencode)**
开源 AI 编程代理工具
**[Cline](/docs/agent-plan-enterprise-other-tools)**
VSCode 扩展，代码补全和调试
**[Kilo Code](/docs/agent-plan-enterprise-other-tools)**
轻量高性能编程工具
**[WorkBuddy](/docs/agent-plan-enterprise-workbuddy)**
腾讯桌面 AI 智能体客户端
**[ZCode](/docs/agent-plan-enterprise-zcode)**
智谱推出的 AI 编程助手
**[OpenClaw](/docs/agent-plan-enterprise-openclaw)**
开源、自托管个人 AI 助手
**[Cursor](/docs/agent-plan-enterprise-other-tools)**
AI 原生代码编辑器
**[Hermes Agent](/docs/agent-plan-enterprise-hermes-agent)**
开源自主 AI 智能体
**[DeepSeek Harness](/docs/agent-plan-enterprise-deepseek-harness)**
一切皆插件的智能体框架
**[OpenAI4S](/docs/agent-plan-enterprise-openai4s)**
开源科学研究 Agent
# 四、配置 AI 工具
下面以 Claude Code 为例介绍如何使用 Agent Plan 企业版。
## 1. 安装 Claude Code
请参考 [官方文档的安装章节](https://code.claude.com/docs/zh-CN/quickstart#步骤-1：安装-claude-code) 完成 Claude Code 安装 。
## 2.配置 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](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise?agentMode=close)，为专属 API Key，其他方舟 API Key 如Coding Plan API Key 无法在 Agent Plan 企业版中使用。
* **ANTHROPIC_MODEL**：见 [支持模型及Harness](/docs/agent-plan-enterprise-plan-overview#3a2d43d5)，不同 Agent Plan 企业版套餐支持的模型不同。请先配置文本生成模型，后续图片生成模型、视频生成模型等可在 Claude Code 中使用自然语言/Skill 等方式完成配置。
### 手动配置
下面详细介绍如何手动完成上述信息配置。
1. 创建并打开 `settings.json` 配置文件。文件路径因系统而异，具体操作如下：
**选项：macOS/Linux**
macOS/Linux 系统 Claude Code 配置文件路径：`~/.claude/settings.json`。
1. 如果在主目录下没有`.claude`目录，执行以下命令创建目录。
```Bash
mkdir -p ~/.claude
```
2. 创建并打开配置文件。
```Bash
nano ~/.claude/settings.json
```
**选项：Windows**
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"
```
2. 编辑`settings.json`，需修改的配置信息如下：
* ``：替换为您的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise?agentMode=close)
* ``：结合套餐及您的需求，更新**文本生成模型**的名称，如 `ark-code-latest`，详细模型名称参见 [支持模型及Harness](/docs/agent-plan-enterprise-plan-overview#3a2d43d5)。
```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#6c9f2a1b)。
> * 推荐使用完整模型配置，并按任务复杂度选择模型：Haiku（轻量）、Sonnet（日常）、Opus（复杂）。
> * `CLAUDE_CODE_SUBAGENT_MODEL` 建议与主模型保持一致。
> * `ANTHROPIC_DEFAULT_HAIKU_MODEL` 建议设置为小尺寸模型，通常不会影响整体使用效果。
> * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 用于关闭 Claude Code 后台匿名遥测请求。遥测请求默认会走 `ANTHROPIC_BASE_URL` 并占用 Agent Plan 配额，设为 `"1"` 可避免额度被静默消耗（方式 1 的 ArkCLI Helper 会自动配置此项）。
3. 编辑或新增 `.claude.json` 文件，修改或新增 **hasCompletedOnboarding** 字段值为 `true`，设置状态为完成入门引导。
**选项：macOS/Linux**
1. 创建并打开配置文件。
```Bash
nano ~/.claude.json
```
2. 修改或新增的字段信息如下：
```JSON
{
"hasCompletedOnboarding": true
}
```
**选项：Windows**
1. 创建并打开配置文件。
```Bash
notepad "%USERPROFILE%\.claude.json"
```
2. 修改或新增的字段信息如下：
```JSON
{
"hasCompletedOnboarding": true
}
```
## 3.启动并使用 Claude Code
1. 启动 Claude Code：进入项目目录，执行`claude`命令，即可开始使用 Claude Code。
```Bash
cd my-project
claude
```
启动后，选择信任此文件夹，允许 Claude Code 访问该文件夹中的文件。
2. 模型状态验证：输入`/status`确认模型状态。
3. 在 Claude Code 中对话。
> 更多使用教程请参见 [Claude Code 官网](https://code.claude.com/docs/zh-CN/quickstart#%E6%AD%A5%E9%AA%A4-4%EF%BC%9A%E6%8F%90%E5%87%BA%E6%82%A8%E7%9A%84%E7%AC%AC%E4%B8%80%E4%B8%AA%E9%97%AE%E9%A2%98)。
## 其他操作
### 配置视觉模型
方舟 Agent Plan Medium 及以上套餐提供图片生成模型配额，Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见：[配置视觉模型](/docs/agent-plan-enterprise-visual-models)。
> **注意**
>
> * 不同的套餐支持的视觉模型有所不同，具体参见[支持模型及Harness](/docs/agent-plan-enterprise-plan-overview#3a2d43d5)。
> * 视觉模型不支持通过 Auto 及控制台切换使用。
### 切换模型
你可以随时根据需求切换**文本生成模型**。方舟支持多种方式切换模型。
|配置方式 |通过控制台 |通过命令参数 |修改配置文件 |
|---|---|---|---|
|切换模型操作 |1. 参考[2.配置 Claude Code](/docs/agent-plan-enterprise-get-started#40b4240d)配置模型名称为`ark-code-latest`。 |* 启动时：执行`claude --model `，可指定对应的模型。 |参考[2.配置 Claude Code](/docs/agent-plan-enterprise-get-started#40b4240d)配置模型名称为您需要的模型。 | \
| |2. 在 [订阅页面](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise?agentMode=close)，选择**我的** - **使用配置**，选择要使用的模型，切换后3-5分钟即可生效。 |* 对话期间：执行`/model `切换模型。 | | \
| |3. 在命令行窗口，启动 Claude Code 后，输入`/status`确认模型状态。 | | |