如何在windows本地使用Claude Code?

AI 总结

本教程介绍在Windows本地使用Claude Code的方法。先安装Node.js,再通过npm全局安装Claude Code。启动后因未配置模型会报错,需使用CC-Switch工具进行可视化配置。CC-Switch是跨平台桌面软件,支持管理API供应商、模型映射和本地路由。用户可添加Kimi等第三方模型,填入API Key并获取模型列表,启用后即可正常使用Claude Code。

本教程使用cc‑switch 配合 Claude‑Code CLI

前置步骤

安装node.js

要求:Node.js ≥ 20 环境,npm/npx 可用

安装node.js參考链接:https://blog.csdn.net/weixin_44156305/article/details/156448495

安装Claude‑Code

同时按 win + R 键,输入 cmd ,按回车,将打开 CMD 终端

输入以下命令开始安装 Claude Code

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

输入claude。进入claude后台,选择yes 回车

此时未配置 Claude 模型,也没有配置国产模型,因此启动 Claude Code 会报错:

那么就需要用一款工具来直观的修改 Claude Code 的配置,那就是 CC-Switch。

cc-switch是什么?

CC-Switch是基于Tauri2(Rust+React)开发的轻量化开源桌面软件,支持Windows/macOS/Linux全平台,主打AI编程类CLI工具配置可视化统一管控。

cc‑switch 核心概念

  • Provider(供应商):一组 API 配置,包含 BaseURL、API‑Key、模型映射;可以是 Anthropic 官方、第三方中转、本地 Ollama/LM‑Studio/vLLM 服务。
  • 启用供应商:cc‑switch 将配置写入 Claude Code 的环境配置,新开终端才生效,旧终端不会自动更新。
  • 本地路由:内置代理,用于做协议转换(OpenAI 格式 ↔ Anthropic 协议),本地模型必须开启本地路由才能正常工作

系统环境变量优先级高于 cc‑switch,如果手动设置过ANTHROPIC_*环境变量,需要删除,否则 cc‑switch 配置不生效

怎么安装?

1.github地址:https://github.com/farion1231/cc-switch/releases 选择最新版本下载即可

2.双击安装即可



怎么使用cc-switch


左侧框说明我们配置的是 Claude Code 是命令行程序,所以在上方选中 Claude Code 命令行那个图标,点击右边的 + 号

添加模型,比如使用kimi,那么就去kimi官网创建apikey


复制上方的密钥,填入下图的APIkey的地方

往下滑,点击获取模型列表,成功后点击添加

回到首页,点击启用我们新添加的模型

接下来就完成初始化了,进入了使用界面:

问个问题,看一下能不能正常使用了

安装遇到的坑

安装以后运行报错

这是因为postinstall 脚本被 npm 的安全策略阻止了,导致 install.cjs 没有执行,所以 claude.exe 没有被正确生成/配置,系统误报为"不兼容"。

结局方案:安装时通过参数--allow-scripts=@anthropic-ai/claude-code允许执行

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

npm install -g @anthropic-ai/claude-code --allow-scripts=@anthropic-ai/claude-code

然后我们发现可以正常使用了

评论 (0)