# 快速开始

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

购买 Coding Plan 企业版套餐、分配席位、配置编程工具并使用，帮助您快速开启 AI 编程之旅。

<span id="d450d315"></span>
# 核心配置

需要获取 Coding Plan 企业版支持的模型、Base URL和专属的 API Key，才能正常使用并抵扣套餐额度。
<span id="2e9b1559"></span>
## **模型配置**

支持以下两种方式配置模型：

**选项：配置 Model Name (配置文件指定)**

在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：

> **注意**
>
> 配置 Model Name 时，支持使用全小写格式，同时也支持直接复制 [Coding Plan 企业版页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=enterprise) 中的模型名称。

* `doubao-seed-evolving`
* `doubao-seed-2.1-pro`
* `doubao-seed-2.1-lite`
* `doubao-seed-2.0-mini`
* `glm-5.3` (`glm-latest`)
* `glm-5.3-flash`
* `deepseek-v4.1-flash`
* `deepseek-v4.1-flash-economy`
* `deepseek-v4-flash`
* `deepseek-v4-pro`
* `kimi-k2.8-preview`
* `kimi-k3.1-pro`

> **说明**
>
> Model Name 不支持配置为 `Auto`，如需使用，请通过控制台切换该模式。

**选项：配置 ark-code-latest (控制台管理)**

1. 在配置文件中指定模型为`ark-code-latest`。
2. 通过 [Coding Plan 企业版页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=enterprise) 选择或切换目标模型，切换模型后 3-5 分钟即可生效。
     支持 Auto 模式，通过「效果 + 速度」双维度智能算法自动选择模型。

<span id="d9073615"></span>
## **专属 Base URL**

不同的工具配置的 Base URL 根据兼容的协议会有不同：
* 兼容 Anthropic 接口协议工具：`https://ark.cn-beijing.volces.com/api/coding`
* 兼容 OpenAI 接口协议工具：`https://ark.cn-beijing.volces.com/api/coding/v3`

> **注意**
>
> 请勿使用 `https://ark.cn-beijing.volces.com/api/v3` ，接入会产生额外费用。

<span id="0c1c1bc6"></span>
## **专属 API Key**

[获取专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/coding-plan-enterprise/mine)

> **注意**
>
> Coding Plan 企业版专属 API Key 与火山方舟平台的 API Key 不同，请勿混用。

![coding-plan-enterprise-api-key.png](https://arkdocs.tos-cn-beijing.volces.com/images/agent-plan/coding-plan-enterprise-api-key.png)

<span id="d061dee7"></span>
# 一、购买 Coding Plan 企业版

企业账号管理员通过 IAM 用户登录控制台，进入 [Coding Plan 企业版](https://ark.volcengine.com/region:cn-beijing/subscription/coding-plan-enterprise?agentMode=close)，按需购买套餐。套餐介绍参见[套餐概览](/docs/coding-plan-enterprise-plan-overview)。

![](https://arkdocs.tos-cn-beijing.volces.com/images/agent-plan/coding-plan-enterprise-buy.png)

<span id="163f6c67"></span>
# 二、分配席位

若您使用的账号还未获取席位，需要联系企业账号管理员分配席位。以下为账号管理员操作步骤：
1. 点击进入 [Coding Plan 企业版](https://ark.volcengine.com/region:cn-beijing/subscription/coding-plan-enterprise?agentMode=close)，选择**席位管理**页签。
2. 根据界面提示，为账号绑定席位。需要关注席位对应的套餐信息。

    完成绑定后，该账号即可获取相应的使用席位，完成编程工具配置后即可正常使用 Coding Plan 企业版套餐。 

|选择绑定方式 |选择绑定用户 |
|---|---|
|![选择绑定方式](https://arkdocs.tos-cn-beijing.volces.com/images/agent-plan/coding-plan-enterprise-bind-mode.png?v=20261016)|![3-user.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/3-user.png) |

<span id="731850e1"></span>
# 三、选择编程工具

Coding Plan 企业版支持主流的编程工具，席位用户可按需选择。

**[Claude Code](/docs/coding-plan-enterprise-ai-claude-code)**
AI 终端编程助手，自然语言编程

**[TraeCode](/docs/coding-plan-enterprise-ai-trae)**
智能 IDE，构建新一代编程工作流

**[Roo Code](/docs/coding-plan-enterprise-ai-other-tools)**
轻量级编程助手

**[Codex CLI](/docs/coding-plan-enterprise-ai-codex)**
OpenAI 推出的命令行编程工具

**[OpenCode](/docs/coding-plan-enterprise-ai-opencode)**
开源 AI 编程代理工具

**[Cline](/docs/coding-plan-enterprise-ai-other-tools)**
VSCode 扩展，代码补全和调试

**[Kilo Code](/docs/coding-plan-enterprise-ai-other-tools)**
轻量高性能编程工具

**[OpenClaw](/docs/coding-plan-enterprise-ai-openclaw)**
开源、自托管个人 AI 助手 

**[Cursor](/docs/coding-plan-enterprise-ai-other-tools)**
AI 原生代码编辑器

**[Hermes Agent](/docs/coding-plan-enterprise-ai-hermes-agent)**
开源自主 AI 智能体

<span id="61c63a83"></span>
# 四、配置编程工具

下面以 Claude Code 为例介绍如何使用 Coding Plan 企业版。

<span id="a71cd564"></span>
## 安装 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
```

<span id="40b4240d"></span>
## 配置工具

完成Claude Code安装后，配置以下信息。
* **ANTHROPIC_BASE_URL**：`https://ark.cn-beijing.volces.com/api/coding`
* **ANTHROPIC_AUTH_TOKEN**：[获取专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/coding-plan-enterprise/mine)
* **ANTHROPIC_MODEL**: 支持配置 Model Name （实时切换模型）、配置`ark-code-latest`（控制台切换模型）两种方式，具体见 [模型配置](/docs/coding-plan-enterprise-get-started#2e9b1559)。

配置步骤如下：
1. 编辑或新增 `settings.json` 文件，需要修改的配置信息如下：

    * `<ARK_API_KEY>`：替换为您自己的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/apikey)

    * `<Model_Name>`：更新为需要使用的模型信息，支持的模型信息参见 [模型配置](/docs/coding-plan-enterprise-get-started#2e9b1559)。

> **说明**
>
> 不同系统配置文件路径不同，具体如下：
> * macOS & Linux：`~/.claude/settings.json`
> * Windows：`C:\Users\<用户名>\.claude\settings.json`

```JSON
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "<ARK_API_KEY>",
        "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
        "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"
    }
}
```

> **说明**
>
> * 要开启 1M 上下文窗口，配置参见[扩展上下文](/docs/coding-plan-enterprise-ai-claude-code#4c8d2a7f)。
> * 推荐使用完整模型配置，并按任务复杂度选择模型：Haiku（轻量）、Sonnet（日常）、Opus（复杂）。
> * `CLAUDE_CODE_SUBAGENT_MODEL` 建议与主模型保持一致。
> * `ANTHROPIC_DEFAULT_HAIKU_MODEL` 建议设置为小尺寸模型，通常不会影响整体使用效果。
> * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 用于关闭 Claude Code 后台匿名遥测请求。遥测请求默认会走 `ANTHROPIC_BASE_URL` 并占用 Coding Plan 配额，设为 `"1"` 可避免额度被静默消耗（方式 1 的 ArkCLI Helper 会自动配置此项）。

2. 编辑或新增 `.claude.json` 文件，修改或新增 `hasCompletedOnboarding` 字段值为 true。

> **说明**
>
> 不同系统配置文件路径不同，具体如下：
> * macOS & Linux：`~/.claude.json`
> * Windows：`C:\Users\<用户名>\.claude.json`

```JSON
{
  "hasCompletedOnboarding": true
}
```

保存配置文件后，在新的终端窗口执行后续命令。

<span id="645b3d8a"></span>
## 使用 Claude Code

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

    ```Bash
    cd my-project
    claude
    ```

    启动后，选择信任此文件夹，允许 Claude Code 访问该文件夹中的文件。
2. 模型状态验证：输入`/status`确认模型状态。

    ![](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4382021492134eee946601bf53514b48~tplv-goo7wpa0wc-image.image)

3. 在 Claude Code 中对话。

    ![](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/631742d8a5814d68a5cbc62988ba8cab~tplv-goo7wpa0wc-image.image)

<span id="7d120d12"></span>
## 切换模型

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

|配置方式 |配置`ark-code-latest` |配置 Model Name |
|---|---|---|
|切换模型操作 |1. 在 [订阅页面](https://ark.volcengine.com/region:cn-beijing/subscription/coding-plan-enterprise?agentMode=close)，选择**我的** - **使用配置**，选择要使用的模型，切换后3-5分钟即可生效。 |* 启动时：执行`claude --model <Model_Name>`，可指定对应的模型。 | \
| |2. 在命令行窗口，启动 Claude Code 后，输入`/status`确认模型状态。 |* 对话期间：执行`/model <Model_Name>`切换模型。 |
