将 Claude Code 预置模型替换为火山方舟 Kimi-K2 指南

本指南面向在国内因网络策略限制而无法正常使用 Claude Code 的用户。文档将详细介绍如何通过开源工具 claude-code-router，将 Claude Code 的 API 请求路由至火山引擎方舟平台（以下简称“火山方舟”）上托管的 Kimi-K2 大语言模型。

完成本指南中的所有步骤后，你将能够恢复 Claude Code 的正常使用，并由性能优良的 Kimi-K2 模型提供代码生成与交互服务。

方案概述

本方案的核心是利用开源工具 Claude Code Router 实现 API 请求的转发。该工具作为一个轻量级的本地路由层，能够拦截 Claude Code 客户端发出的 API 请求，并根据预设的路由规则，将其转发到你指定的替代模型服务商。

通过配置该工具，你不仅可以接入火山方舟，同样也适用于接入其他兼容的服务平台（如 OpenRouter、Ollama 等）。

如果你希望探索与火山引擎生态结合更紧密的原生工具，可以考虑尝试 veCLI，这是一款由火山引擎官方推出的智能体编程工具。前提条件在开始操作之前，请确保你已完成以下准备工作。

前提条件

本地环境要求

• 你的个人计算机上已成功安装 Claude Code。有关安装详情，请参阅 Claude Code 官方文档。

火山方舟账户准备

• 获取 API Key：你需要在火山方舟控制台创建并获取用于程序调用的 API Key。具体步骤请参见获取 API Key。

• 创建模型推理接入点：在火山方舟平台上，为 Kimi-K2 模型创建一个推理接入点（Endpoint），并记录其 Endpoint ID。操作详情请参见获取 Endpoint ID。

操作步骤 (macOS)

本章节以 macOS 操作系统为例，介绍详细的配置步骤。

1. 安装 claude-code-router。

打开终端应用程序，执行以下命令以全局安装 claude-code-router。

# 使用 npm (Node.js 包管理器) 全局安装路由工具npm install -g @musistudio/claude-code-router		

2. 配置路由策略。

该工具提供了一个可视化的 Web 界面来简化配置过程。

1. 在终端执行以下命令，启动配置界面。

# 启动 claude-code-router 的用户界面ccr ui

浏览器将自动打开配置页面。在页面中，添加并配置火山方舟作为模型供应商。

1. 单击 添加供应商。

2. 从模板导入：选择 volcengine。

3. API 密钥：填入你在前提条件中获取的火山方舟 API 密钥。若已将密钥配置为环境变量，请直接填入环境变量的名称（例如 $VOLC_API_KEY）。

4. 模型：填入你在火山方舟上为 Kimi-K2 模型创建的模型推理接入点 ID（以 ep- 开头）。

5. 单击 保存。

   

6. 在界面右侧的 路由 区域，将 默认 路由的目标模型设置为你刚刚配置的火山方舟 Kimi-K2 模型。

   

7. 单击界面右上角的 保存并重启 以应用所有配置。

验证配置

完成上述步骤后，你需要验证配置是否已成功生效。

1. 通过路由工具启动 Claude Code。

请注意，为使路由规则生效，你必须通过 claude-code-router 来启动 Claude Code。

# 通过路由工具启动 Claude Codeccr code

2. 执行测试任务。

尝试向 Claude Code 发出一个简单的编程指令，例如：“请用 Python 写一个 hello world 程序”。观察其是否能正常返回代码。

3. 在火山方舟后台确认调用。

为最终确认请求确实由 Kimi-K2 模型处理，你可以登录火山方舟控制台，查看对应模型推理接入点的“监控”页面。如果看到“接口 RPM”、“Token 速率”等指标在你测试后出现增长，则证明配置成功。