快速开始

本文介绍如何在编程工具中快速使用 Coding Plan 套餐所支持的模型进行代码开发。

步骤一：订阅方舟 Coding Plan#

访问 方舟 Coding Plan 活动，按需订阅套餐。套餐介绍请参见套餐概览。

步骤二：配置编程工具#

Coding Plan 支持主流的编程工具，可按需选择。

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

安装 Claude Code#

前提条件：

• 安装 Node.js 18 或更新版本环境。
• Windows 用户需安装 Git for Windows。

在命令行界面，执行以下命令安装 Claude Code。

1npm install -g @anthropic-ai/claude-code

安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。

1claude --version

配置工具#

方式一：自动化助手（推荐）#

ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。

1. 安装 Ark CLI。

   Bash

   1
   2
   3
   4
   5# 1. 通过 NPM 安装
   npm install -g @volcengine/ark-cli@latest
   
   # 2. 验证安装
   arkcli --version
   

2. 登录 Ark CLI。

   Bash

   1arkcli auth login
   

   

   根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：

   1. 选择项目（Project）：可按需选择，或默认选择账号全部资源。

   2. 选择消费模式（Type）：选择 coding-plan。

      

3. 运行 ArkCLI Helper，根据界面提示完成 Claude Code 的配置。

   1. 在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。

   2. 选择要配置的 Plan profile：选择 coding-plan_cn-beijing_personal (Coding Plan)。

      

   3. 选择默认 model：按需选择。

   4. 选择要配置的 AI Agent：Claude Code。

      

完成上述操作后，将自动完成 Claude Code 的基础配置，无需手动安装。

方式二：手动配置#

完成Claude Code安装后，配置以下信息。

• ANTHROPIC_BASE_URL：https://ark.cn-beijing.volces.com/api/coding
• ANTHROPIC_AUTH_TOKEN：获取 API Key
• ANTHROPIC_MODEL: 支持配置 Model Name （实时切换模型）、配置ark-code-latest（控制台切换模型）两种方式，具体见 模型配置。

配置步骤如下：

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

2. 编辑配置文件，需要修改的配置信息如下：

   • <ARK_API_KEY>：替换为您自己的 API Key。

   • <Model_Name>：更新为需要使用的模型信息，如ark-code-latest。支持的模型信息参见 模型配置。

   JSON

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12{
       "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"
       }
   }
   

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

   1. 不同系统.claude.json配置文件路径如下：

      • macOS/Linux：~/.claude.json

      • Windows：C:\Users\<用户名>\.claude.json

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

      JSON

      1
      2
      3{
        "hasCompletedOnboarding": true
      }
      

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

使用 Claude Code#

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

   Bash

   1
   2cd my-project
   claude
   

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

2. 模型状态验证：输入/status确认模型状态。

3. 在 Claude Code 中对话。

切换模型#

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

常见问题#

常见问题

错误码#

如遇报错，可根据错误信息查看错误码说明，定位&解决问题。详细信息请参见错误码。