news 2026/5/29 5:10:56

Claude Code CLI 接入Kimi K2.5模型

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Claude Code CLI 接入Kimi K2.5模型

用 Claude Code 的交互体验 + 国产大模型的低成本与低延迟,打造最佳编程工作流。


目录

安装 Claude Code CLI

1. 安装 Node.js

2. 通过 npm 安装 Claude Code

3. 验证安装

核心原理

方案一:接入 Kimi K2.5(Moonshot)

1. 获取 API Key

2. 配置环境变量与默认模型

3. 启动 Claude Code

方案二:使用 CC-Switch 图形化切换(推荐)

1. 安装

2. 添加 Provider

3. 一键切换

4. 更多特性

持久化配置

方法一:在 Windows 用户环境变量中配置

方法二:使用 Claude Code settings.json

总结


安装 Claude Code CLI

在开始配置之前,你需要先安装 Claude Code 命令行工具。

1. 安装 Node.js

前往 Node.js 官网 下载并安装v18 或更高版本。安装完成后验证:

node -v

2. 通过 npm 安装 Claude Code

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

如果安装速度慢,可使用国内镜像:

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

3. 验证安装

claude -v

如果显示版本号,说明安装成功


核心原理

Claude Code 底层通过Anthropic Messages API格式(/v1/messages)与模型通信。只要第三方服务兼容该 API 格式,就可以通过设置环境变量将请求转发到自定义端点:

Claude Code CLI → 自定义 API 端点(国产模型) → 模型响应

关键的两个环境变量:

ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN

方案一:接入 Kimi K2.5(Moonshot)

1. 获取 API Key

前往 Moonshot AI 开放平台 注册账号并创建 API Key。

2. 配置环境变量与默认模型

在终端中执行:

PowerShell:

# 设置 API 端点指向 Moonshot $env:ANTHROPIC_BASE_URL = "https://api.moonshot.cn/anthropic" # 设置你的 Moonshot API Key $env:ANTHROPIC_AUTH_TOKEN = "your-moonshot-api-key" # 设置默认模型(这样启动时无需 --model 参数) $env:ANTHROPIC_MODEL = "kimi-k2.5"

CMD:

set ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic set ANTHROPIC_AUTH_TOKEN=your-moonshot-api-key set ANTHROPIC_MODEL=kimi-k2.5

也可以通过编辑C:\\Users\\你的用户名\\.claude\\settings.json来持久化配置默认模型:

{ "env": { "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic", "ANTHROPIC_AUTH_TOKEN": "your-moonshot-api-key", "ANTHROPIC_MODEL": "kimi-k2.5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.5" } }

3. 启动 Claude Code

配置完默认模型后,直接运行即可:

claude

也可以通过--model临时指定其他模型:

claude --model kimi-k2.5

提示:如果未设置ANTHROPIC_MODEL且不带--model参数,Claude Code 默认会尝试调用 Claude Sonnet,而 Moonshot 端点不支持该模型名,会导致报错。

方案二:使用 CC-Switch 图形化切换(推荐)

如果你不喜欢每次手动修改环境变量,CC-Switch是一个更优雅的选择。它是一款开源桌面应用,提供图形化界面来管理和切换多个 API Provider 配置,支持 Claude Code、Codex、Gemini CLI 等主流 AI 编程工具。

核心亮点:无需手动改配置文件或设置环境变量,通过 UI 或系统托盘一键切换模型提供商。

1. 安装

前往 GitHub Releases 下载 Windows 安装包(推荐.msi,安装包仅约 6MB),按提示完成安装即可。

2. 添加 Provider

打开 CC-Switch 主界面,点击"Add Provider"按钮:

  • 使用内置预设(推荐):CC-Switch 内置了大量常用 Provider 模板(Moonshot、智谱、DeepSeek 等),选择后填入 API Key 即可
  • 自定义配置:手动填写 API 端点和密钥,适合接入自建代理或小众服务商

3. 一键切换

配置完成后,可通过以下方式切换:

  • 在主界面点击对应 Provider 即可激活
  • 通过系统托盘图标快速切换
  • 支持拖拽排序,将高频使用的配置置顶

4. 更多特性

  • MCP 服务器管理:统一管理 MCP 配置,并可在 Claude Code 和 Codex 之间同步
  • WSL 穿透:Windows 环境下支持 WSL 自动同步配置目录
  • CC 插件同步:支持 Claude Code VS Code 插件的资源站切换(在设置中开启)
  • 云同步:支持通过坚果云等服务同步配置,多设备共享

项目地址:github.com/farion1231/cc-switch

持久化配置

方法一:在 Windows 用户环境变量中配置

通过设置 Windows 用户环境变量,每次打开终端时自动生效,无需重复设置。

方式一:图形界面设置

  1. Win + I打开设置,搜索「编辑系统环境变量」
  2. 点击「环境变量」按钮
  3. 在上方「用户变量」区域,点击「新建」,依次添加以下变量:
变量名变量值(以 Kimi K2 为例)
ANTHROPIC_BASE_URLhttps://api.moonshot.cn/anthropic
ANTHROPIC_AUTH_TOKEN你的 API Key
ANTHROPIC_MODELkimi-k2.5(默认模型)
ANTHROPIC_DEFAULT_HAIKU_MODELkimi-k2.5(替代 Haiku)
ANTHROPIC_DEFAULT_SONNET_MODELkimi-k2.5(替代 Sonnet)
ANTHROPIC_DEFAULT_OPUS_MODELkimi-k2.5(替代 Opus)

方式二:通过 PowerShell 命令设置

# 设置用户环境变量(永久生效) [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.moonshot.cn/anthropic", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-moonshot-api-key", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "kimi-k2.5", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "kimi-k2.5", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "kimi-k2.5", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "kimi-k2.5", "User")

注意:设置完成后需要重新打开终端才能生效。如果需要切换不同模型服务商,修改对应变量值即可。

方法二:使用 Claude Code settings.json

编辑%USERPROFILE%\\.claude\\settings.json(即C:\\Users\\你的用户名\\.claude\\settings.json):

{ "env": { "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic", "ANTHROPIC_AUTH_TOKEN": "your-api-key", "ANTHROPIC_MODEL": "kimi-k2.5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.5" } }

关键字段说明:

字段作用
ANTHROPIC_MODEL默认使用的模型,启动时无需--model参数
ANTHROPIC_DEFAULT_HAIKU_MODEL替代 Haiku 的模型(用于轻量级任务)
ANTHROPIC_DEFAULT_SONNET_MODEL替代 Sonnet 的模型(默认主力模型)
ANTHROPIC_DEFAULT_OPUS_MODEL替代 Opus 的模型(用于复杂推理任务)

总结

Claude Code CLI 的开放架构为国内开发者提供了一个绝佳的入口:既能享受顶级的 AI 编程交互体验,又能灵活选择适合自己的大模型

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/28 22:29:06

数据库容器和 Kubernetes 演进

在容器化环境中运行数据库的旅程是一次变革性的过程,标志着与早期 Kubernetes 主要为无状态应用程序设计的时代相比发生了重大转变。如今,容器化数据库代表了一种成熟的技术堆栈,使组织能够以与应用程序层相同的敏捷性和可扩展性来管理数据工…

作者头像 李华
网站建设 2026/5/28 21:24:23

学考赋能哪家优?泛微青蓝阁、考试星、酷学院、云学堂实力拆解

随着企业数字化人才培育进入“精准化、合规化”深水区,学习培训考试平台已从基础辅助工具,升级为企业搭建学练考闭环、赋能员工成长的核心载体。据《2026年企业学考数字化白皮书》显示,国内该领域市场规模已突破900亿元,AI赋能、合…

作者头像 李华
网站建设 2026/5/28 18:14:25

如何创建一个PR

第一阶段:本地准备 (在终端操作) 这几步是为了确保你的代码在本地是干净、准确地打包好的。 1. 确认身份 git branch 作用:查看当前所在的分支。 检查点:必须看到 * crj_develop(你的名字分支)是绿色的。 为什么&…

作者头像 李华