前言最近想用本地claude命令行工具读写项目代码搭配 CC Switch 做模型调度踩了 npm 全局命令丢失、模型映射、1M 长文本标记、余额查询一整套坑把完整可复现流程整理出来新手照着做不会出错。一、环境准备修复 claude 命令找不到报错1. 报错现象PowerShell 输入claude提示无法识别 claude.exeCommandNotFound 异常。 原因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-code3. 配置系统 PATH 永久生效查看 npm 全局安装路径powershellnpm config get prefix # 输出C:\Users\Lenovo\.npm-globalWinR 输入sysdm.cpl→ 高级 → 环境变量在用户变量找到Path→ 编辑 → 新建填入路径C:\Users\Lenovo\.npm-global全部弹窗点确定保存关闭所有终端重新打开。4. 验证工具是否正常powershell# 输出版本号即安装成功 claude --version # 查看全部命令功能 claude --help二、CC Switch 配置 Moonshot Kimi 兼容 Claude 接口1. 新增供应商基础信息请求地址https://api.moonshot.cn/anthropic末尾不要加斜杠API 格式Anthropic Messages (原生)认证字段ANTHROPIC_AUTH_TOKEN2. 模型映射区分标准版 / 1M 超长上下文关键知识点DeepSeek 客户端标记写法xxx[1m]仅前端展示接口真实模型名不变Moonshot Kimi 长文本是真实独立模型 ID必须用-1m后缀不能写[1m]否则调用失败。两种配置方案方案 A日常短对话省钱、速度快四个输入框统一填写kimi-k2.6方案 B读取完整项目 / 百万字文档1M 长上下文四个框全部统一kimi-k2.6主模型kimi-k2.6Haiku 默认模型kimi-k2.6Sonnet 默认模型kimi-k2.6Opus 默认模型kimi-k2.6 保存供应商后模型列表页会自动勾选「声明支持 1M」。3. 用量余额查询配置开启「启用量查询」开关自动定时拉取账户余额API Key、请求地址留空自动复用供应商配置超时默认 10s自动查询间隔 5 分钟内置通用模板无需修改提取器代码直接保存即可实时查看剩余余额避免余额耗尽断调用。三、claude CLI 对接 Moonshot Kimi 兼容接口使用1. 临时配置 API 密钥与转发地址当前终端生效powershell# 填入你的Moonshot Key $env:ANTHROPIC_API_KEYsk-xxxx # 指定兼容接口地址 $env:ANTHROPIC_BASE_URLhttps://api.moonshot.cn/anthropic2. 功能测试powershell# 基础对话测试连通性 claude chat 用一句话介绍嵌入式开发 # 代码生成核心功能测试 claude code 写STM32标准库LED流水灯完整代码四、踩坑总结避坑清单claude命令找不到重装包 配置 npm 全局 PATH必须重启终端Kimi 模型 1M 上下文不要照搬 DeepSeek[1m]写法必须用kimi-k2.6CC Switch 模型映射四个框建议统一填写避免切换角色时上下文截断PATH 路径无需置顶只要存在即可正常调用启用量查询建议常开实时监控 token 消耗控制成本。结尾整套方案实现本地 Claude 命令行工具调用 Kimi 大模型兼顾百万长文本读取、代码工程分析、余额监控适合嵌入式 / 后端开发者本地快速写代码、读项目源码。