news 2026/5/1 11:13:16

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/4/30 18:55:26

AI应用架构师晋升路径:技术专家 vs 管理路线,该怎么选?

AI应用架构师晋升路径:技术专家 vs 管理路线,该怎么选? 摘要/引言 在人工智能(AI)蓬勃发展的当下,AI应用架构师凭借其在设计和构建AI驱动系统方面的关键作用,成为了行业中的热门职业。然而&…

作者头像 李华
网站建设 2026/4/8 5:10:36

维卡软化点与热变形试验设备:技术解析与操作指南

维卡软化点与热变形试验设备:技术解析与操作指南 维卡软化点与热变形试验设备:技术解析与操作指南 在材料科学与工程领域,非金属材料的热性能测试对于产品质量控制与研发创新具有至关重要的意义。维卡软化点测试仪与热变形试验设备作为实验…

作者头像 李华
网站建设 2026/4/10 19:51:39

CANN算子引擎解密:ops-nn如何重塑AIGC推理流水线

cann组织链接:https://atomgit.com/cann ops-nn仓库链接:https://atomgit.com/cann/ops-nn 当Stable Diffusion在3秒内生成高清图像,当LLaMA-3实现毫秒级文本续写——背后驱动这一切的,正是CANN算子引擎与ops-nn仓库构建的高性能推…

作者头像 李华
网站建设 2026/4/29 1:06:10

CANN赋能AIGC:深度剖析与实践,解锁智能生成新范式

个人首页: 永远都不秃头的程序员(互关)C语言专栏:从零开始学习C语言C专栏:C的学习之路K-Means专栏:K-Means深度探索系列本章所属专栏:CANN系列 文章目录一、CANN:AIGC模型的坚实基石二、深度实践:AIGC定制算子的开发与优化1. 算子原型定义&am…

作者头像 李华
网站建设 2026/5/1 9:24:56

机器学习--分类模型、特征工程与评估指标的深度复盘

在机器学习的世界里,从预测连续数值(线性回归)跨越到预测离散类别(分类模型),是一次思维方式的重大转变。 最近,我们通过网约车订单分析、客户流失预测等实战案例,深入探讨了朴素贝叶…

作者头像 李华