CC Switch + Claude Code 本地 CLI 完整踩坑配置指南（Kimi Moonshot 兼容 Claude 接口）

前言

最近想用本地claude命令行工具读写项目代码，搭配 CC Switch 做模型调度，踩了 npm 全局命令丢失、模型映射、1M 长文本标记、余额查询一整套坑，把完整可复现流程整理出来，新手照着做不会出错。

一、环境准备：修复 claude 命令找不到报错

1. 报错现象

PowerShell 输入claude提示：无法识别 claude.exe，CommandNotFound 异常。 原因：npm 全局包文件损坏，且 npm 全局路径未写入系统 PATH。

2. 修复重装流程

powershell

# 卸载损坏旧包 npm uninstall -g @anthropic-ai/claude-code # 强制清理npm缓存 npm cache clean --force # 重新全局安装Claude Code CLI npm install -g @anthropic-ai/claude-code

3. 配置系统 PATH 永久生效

• 查看 npm 全局安装路径

powershell

npm config get prefix # 输出：C:\Users\Lenovo\.npm-global

1. Win+R 输入sysdm.cpl→ 高级 → 环境变量
2. 在用户变量找到Path→ 编辑 → 新建，填入路径：C:\Users\Lenovo\.npm-global
3. 全部弹窗点确定保存，关闭所有终端重新打开。

4. 验证工具是否正常

powershell

# 输出版本号即安装成功 claude --version # 查看全部命令功能 claude --help

二、CC Switch 配置 Moonshot Kimi 兼容 Claude 接口

1. 新增供应商基础信息

• 请求地址：https://api.moonshot.cn/anthropic（末尾不要加斜杠）
• API 格式：Anthropic Messages (原生)
• 认证字段：ANTHROPIC_AUTH_TOKEN

2. 模型映射区分标准版 / 1M 超长上下文

关键知识点

1. DeepSeek 客户端标记写法xxx[1m]仅前端展示，接口真实模型名不变；
2. Moonshot Kimi 长文本是真实独立模型 ID，必须用-1m后缀，不能写[1m]，否则调用失败。

两种配置方案

方案 A：日常短对话（省钱、速度快）

四个输入框统一填写：kimi-k2.6

方案 B：读取完整项目 / 百万字文档（1M 长上下文）

四个框全部统一：kimi-k2.6

• 主模型：kimi-k2.6
• Haiku 默认模型：kimi-k2.6
• Sonnet 默认模型：kimi-k2.6
• Opus 默认模型：kimi-k2.6 保存供应商后，模型列表页会自动勾选「声明支持 1M」。

3. 用量余额查询配置

1. 开启「启用量查询」开关，自动定时拉取账户余额；
2. API Key、请求地址留空，自动复用供应商配置；
3. 超时默认 10s，自动查询间隔 5 分钟；
4. 内置通用模板无需修改提取器代码，直接保存即可实时查看剩余余额，避免余额耗尽断调用。

三、claude CLI 对接 Moonshot Kimi 兼容接口使用

1. 临时配置 API 密钥与转发地址（当前终端生效）

powershell

# 填入你的Moonshot Key $env:ANTHROPIC_API_KEY="sk-xxxx" # 指定兼容接口地址 $env:ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"

2. 功能测试

powershell

# 基础对话测试连通性 claude chat "用一句话介绍嵌入式开发" # 代码生成核心功能测试 claude code "写STM32标准库LED流水灯完整代码"

四、踩坑总结避坑清单

1. claude命令找不到：重装包 + 配置 npm 全局 PATH，必须重启终端；
2. Kimi 模型 1M 上下文不要照搬 DeepSeek[1m]写法，必须用kimi-k2.6；
3. CC Switch 模型映射四个框建议统一填写，避免切换角色时上下文截断；
4. PATH 路径无需置顶，只要存在即可正常调用；
5. 启用量查询建议常开，实时监控 token 消耗，控制成本。

结尾

整套方案实现本地 Claude 命令行工具调用 Kimi 大模型，兼顾百万长文本读取、代码工程分析、余额监控，适合嵌入式 / 后端开发者本地快速写代码、读项目源码。