Claude Code

本文介绍如何在 Claude Code 中使用 方舟 Coding Plan 。

一、安装 Claude Code#

前提条件：

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

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

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

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

1claude --version

二、配置 Claude Code#

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

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 的基础配置，无需手动安装。

方式 2：手动配置#

完成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 中对话。

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

切换模型#

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

扩展上下文#

glm-5.3、deepseek-v4-flash、deepseek-v4-pro 支持 1M 上下文窗口，可用于包含大型代码库的长会话。以 glm-5.3 模型为例，配置信息如下：

1
2
3
4
5
6
7
8
9
10
11{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "<ARK_API_KEY>",
        "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
        "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 官方文档。

添加供应商#

1. 在 CC Switch 中添加供应商：
   1. 在主界面顶部图标栏选中 Claude Code 图标，点击右上角 + 进入添加新供应商。
   2. 选择 自定义配置，填写以下信息：
      • API Key：替换为您自己的 API Key
      • 请求地址：https://ark.cn-beijing.volces.com/api/coding
   3. 展开高级选项，根据当前套餐支持的模型范围，分别配置 Sonnet、Opus、Fable、Haiku 模型，可配置的模型见 模型配置。

4. 选择右下角 **添加**，完成供应商配置。

3. 回到首页，点击右侧 启用 按钮，新开一个 Claude Code 会话使配置生效。

使用 Claude Code 的 Web Search 功能#

完成配置后，按以下步骤在 Claude Code 使用 Web Search 功能。

1. 登录方舟控制台，打开 应用组件库 > 豆包搜索 标签页。
2. 在豆包搜索 Custom 版的操作列中点击开通服务。

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

安装使用 Claude Code IDE 插件#

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

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

2. 安装并使用 IDE 插件。

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

Claude Code VSCode 插件Claude Code JetBrains 插件

安装插件#

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

配置环境变量#

1. 打开 VS Code 左下角打开设置，打开Etensions - Claude Code。
   
2. 在 Claude Code: Environment Variables 区域单击 Edit in settings.json，修改claudeCode.environmentVariables、claudeCode.selectedModel。

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17...
"claudeCode.environmentVariables": [
    {
        "name": "ANTHROPIC_BASE_URL",
        "value": "https://ark.cn-beijing.volces.com/api/coding"
    },
    {
        "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 页面开始使用。

常见问题#

• Claude Code 如何开启深度思考模式？
• 如何升级 Ark Helper？
• 如何卸载 Ark Helper？

错误码#

在编程工具中使用 Coding Plan 套餐时可能会遇到报错，您可以根据错误信息查看对应的报错场景并定位问题，具体可参考错误码。