Claude Code 是一款终端内 AI 编程助手，旨在通过自然语言交互帮助开发者更快地编写、调试和管理代码。方舟 Coding Plan 支持在 Claude Code 中使用，可参考本文进行配置及使用。 :::tip 需要先访问[方舟 Coding Plan活动](https://www.volcengine.com/activity/codingplan)，按需订阅套餐后再配置使用编程工具。 ::: # 核心配置接入工具的核心参数如下： ## **模型配置** 支持以下两种方式配置模型： \`\`\`mixin-react return ( ); \`\`\` ## **Base URL** 不同的工具配置的 Base URL 根据兼容的协议会有不同： * 兼容 Anthropic 接口协议工具：\`https://ark.cn-beijing.volces.com/api/coding\` * 兼容 OpenAI 接口协议工具：\`https://ark.cn-beijing.volces.com/api/coding/v3\`（目前还不支持 Responses API，建议使用 Chat API。） :::warning 请勿使用 \`https://ark.cn-beijing.volces.com/api/v3\` ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。 ::: ## **API Key** [获取 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) # 安装步骤前提条件： * 安装 [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 ``` # 配置工具 ## 方式一：自动化助手（推荐） Ark Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。 :::warning * Ark Helper 仅支持 MacOS、Linux 系统，暂不支持 Windows 系统。 * 以下配置步骤及截图为 Ark Helper 首次使用指引；非首次使用请按界面提示完成套餐配置和工具配置。 ::: 1. 执行以下命令安装 Ark Helper。 ```Bash curl -fsSL https://lf3-static.bytednsdoc.com/obj/eden-cn/ylwslo-yrh/ljhwZthlaukjlkulzlp/install.sh | sh ``` 安装完成后，执行以下命令查看安装的版本号。 ```Bash ark-helper --version ``` 2. 在命令行界面输入`ark-helper`命令，启动 Ark Helper。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/802e66e79f864ceeaba2d05250f1c743~tplv-goo7wpa0wc-image.image =399x) 3. 根据界面提示完成套餐配置。 1. 选择要配置的套餐：`[Volcano] Volcano Engine（国内）`。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6a68961ee782408ca485dff07b2fcfb5~tplv-goo7wpa0wc-image.image =235x) 2. 配置 API Key： [获取 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0f327801346548e49580aff3fbfe9c0f~tplv-goo7wpa0wc-image.image =379x) ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0d49b2af47294daba8a5e2c86f2c706c~tplv-goo7wpa0wc-image.image =363x) 3. 选择默认模型。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a9a13add5808465bb8c27d6518623916~tplv-goo7wpa0wc-image.image =245x) 4. 根据界面提示完成 Claude Code 工具配置。 1. 选择要配置的编码工具：`Claude Code`。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/265d432ab0a549c38eacb7be53891a8a~tplv-goo7wpa0wc-image.image =208x) 2. 选择`设置 Volcano 配置到 Claude Code`，配置完成后，选择`退出`。如果需要重新配置工具，可先选择`卸载 Claude Code 配置`，再重新执行配置流程。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b00e2ee6cb444876b2ff705dac04a7e0~tplv-goo7wpa0wc-image.image =277x) ## 方式二：手动配置完成Claude Code安装后，配置以下信息。 * **ANTHROPIC_BASE_URL**：`https://ark.cn-beijing.volces.com/api/coding` * **ANTHROPIC_AUTH_TOKEN**：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * **ANTHROPIC_MODEL**: 支持配置 Model Name （实时切换模型）、配置`ark-code-latest`（控制台切换模型）两种方式，具体见[模型配置](/docs/82379/1928262#3a775131)。配置步骤如下： 1. 创建并打开 `settings.json` 配置文件。文件路径因系统而异，具体操作如下： ```mixin-react return ( \\.claude\\settings.json\`。以 CMD 命令行方式为例，操作如下。 1. 如果当前用户目录下没有\`.claude\`目录，执行以下命令创建目录。 \`\`\`Bash if not exist "%USERPROFILE%\\.claude" mkdir "%USERPROFILE%\\.claude" \`\`\` 2. 创建并打开配置文件。 \`\`\`Bash notepad "%USERPROFILE%\\.claude\\settings.json" \`\`\` `}>); ``` 2. 编辑配置文件，需要修改的配置信息如下： * ``：替换为您自己的 [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 * ``：更新为需要使用的模型信息，如`ark-code-latest`。支持的模型信息参见[模型配置](/docs/82379/1928262#3a775131)。 ```JSON { "env": { "ANTHROPIC_AUTH_TOKEN": "", "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding", "ANTHROPIC_MODEL": "" } } ``` 3. 编辑或新增 `.claude.json` 文件，修改或新增 `hasCompletedOnboarding` 字段值为 true。 1. 不同系统`.claude.json`配置文件路径如下： * macOS/Linux：`~/.claude.json` * Windows：`C:\Users\<用户名>\.claude.json` 2. 修改或新增的字段信息如下： ```JSON { "hasCompletedOnboarding": true } ``` 保存配置文件后，在新的终端窗口执行后续命令。 # 使用 Claude Code 1. 启动Claude Code：进入项目目录，执行`claude`命令，即可开始使用 Claude Code。 ```Bash cd my-project claude ``` 启动后，选择信任此文件夹，允许 Claude Code 访问该文件夹中的文件。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f621624ffa07485ea37f49ea96c8e8f4~tplv-goo7wpa0wc-image.image =584x) 2. 模型状态验证：输入`/status`确认模型状态。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4382021492134eee946601bf53514b48~tplv-goo7wpa0wc-image.image =2006x) 3. 在 Claude Code 中对话。 :::warning [Claude Code 如何开启深度思考模式？](/docs/82379/2165245#1c6446b6) ::: ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/631742d8a5814d68a5cbc62988ba8cab~tplv-goo7wpa0wc-image.image =1862x) # 切换模型请根据模型配置方式，选择对应的模型切换方案。 |配置方式 |配置`ark-code-latest` |配置 Model Name | |---|---|---| |切换模型操作 |1. 在[开通管理页面](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe)选择要使用的模型，切换后3\-5分钟即可生效。|* 启动时：执行`claude --model `，可指定对应的模型。|\ | |2. 在命令行窗口，启动 Claude Code 后，输入`/status`确认模型状态。 |* 对话期间：执行`/model `切换模型。 | # 安装使用 Claude Code IDE 插件 1. 安装 Claude Code 并配置好环境变量，具体参考[接入Claude Code](/docs/82379/1928262#7432bab1)。 Claude Code IDE 插件依赖 Claude Code CLI 工具，需先完成 Claude Code的安装及配置。 2. 安装并使用 IDE 插件。 > 因 IDE 插件会迭代演进，以下内容仅供参考，具体的安装及使用可参考 [Visual Studio Code](https://code.claude.com/docs/en/vs-code)、[JetBrains IDEs](https://code.claude.com/docs/en/jetbrains)。 ```mixin-react return ( ## 安装插件打开 VSCode，在扩展市场搜索\`claude code\`进行安装。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6c39c8cb4ec84f03bb0ca2444804eac7~tplv-goo7wpa0wc-image.image =1202x) ## 配置环境变量 1. 安装完成后，点击 VSCode 右上角的 Claude Code 图标，进入 Claude Code 页面。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/388665c0f9ed47379faa5291e180a6b2~tplv-goo7wpa0wc-image.image =1738x) 2. 在对话框中输入 \`/config\`回车进入 settings 配置页面。 3. 在 **Claude Code: Environment Variables** 区域单击 **Edit in settings.json**，修改\`claudeCode.environmentVariables\`、\`claudeCode.selectedModel\`。 :::tip 需要修改的配置信息如下： * \`\`：替换为您自己的 [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * \`\`：更新为需要使用的模型信息，如 \`kimi-k2.5\`。支持的模型信息参见[模型配置](/docs/82379/1928262#JDa1Zt24Gs)。 ::: \`\`\`JSON ... "claudeCode.environmentVariables": [ \{ "name": "ANTHROPIC_BASE_URL", "value": "https://ark.cn-beijing.volces.com/api/coding" \}, \{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "" \}, \{ "name": "ANTHROPIC_MODEL", "value": "" \} ], "claudeCode.selectedModel": "", ... \`\`\` 保存配置后，新开一个窗口开始使用 Claude Code。 `}> ## 安装插件打开 JetBrains IDE，在插件市场搜索\`claude code\`进行安装。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5859916985a34036bb41f5097ba58f6c~tplv-goo7wpa0wc-image.image =2334x) ## 开始使用安装完成后，重启IDE后，单击Claude Code 图标，进入 Claude Code 页面开始使用。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/78fae54038524ffbbb0f9d0e677de393~tplv-goo7wpa0wc-image.image =505x) `}>); ``` # 常见问题 * [Claude Code 如何开启深度思考模式？](/docs/82379/2165245#1c6446b6) * [如何升级 Ark Helper？](/docs/82379/2165245#7bdd6584) * [如何卸载 Ark Helper？](/docs/82379/2165245#e2f455fc) # 错误码在编程工具中使用 Coding Plan 套餐时可能会遇到报错，您可以根据错误信息查看对应的报错场景并定位问题，具体可参考[错误码](/docs/82379/1299023)。

火山方舟