Claude Code 安装与配置完整指南(Windows)
从零部署 · 国内镜像加速 · 图形化多 API 切换一、任务描述在 Windows 10/11 系统上从零部署Claude CodeAnthropic 官方命令行 AI 编程助手并通过CC Switch实现多 API 服务商的图形化切换管理。本教程采用国内镜像源完成全部下载无需任何加速工具。适用系统Windows 10 (1809) / Windows 11预计耗时10 – 15 分钟操作难度低图形化安装 复制粘贴命令最终效果在任意目录输入claude即可进入 AI 对话编程二、环境组件说明组件角色必要性Git for Windows版本控制工具用于读取 / 管理代码改动必装Node.js v20 LTSJavaScript 运行时Claude Code 的执行环境必装Claude CodeAI 编程助手主程序 (CLI)必装CC SwitchAPI 配置图形化管理工具推荐三、安装运行环境1) 安装 Git进入华为云镜像目录选择稳定版子目录v2.54.0.windows.1/下载Git-2.54.0-64-bit.exe。下载地址https://mirrors.huaweicloud.com/git-for-windows/双击安装包全程使用默认选项Next 至完成。验证安装新开一个 cmd 窗口执行git --version预期输出git version 2.54.0.windows.12) 安装 Node.js进入华为云 Node.js 镜像下载文件node-v20.19.x-x64.msi20.x 为长期支持版Claude Code 要求 ≥ 18。下载地址https://mirrors.huaweicloud.com/nodejs/latest-v20.x/双击安装包全程 Next。中间一项Automatically install the necessary tools...取消勾选普通使用无需 Python 编译工具链。验证安装新开 cmd 窗口分别执行node -vnpm -v两条命令均输出版本号即成功。3) 切换 npm 国内源仅需配置一次npm config set registry https://registry.npmmirror.com此配置写入用户级 npm 配置文件永久生效后续所有 npm 操作自动走国内镜像。四、安装 Claude Code1) 通过 winget 一键安装推荐打开 cmd 或 PowerShell执行winget install Anthropic.ClaudeCode首次执行会提示同意源协议输入Y回车即可。winget 通过微软官方 CDN 拉取安装包国内可直接访问。包信息ID 为Anthropic.ClaudeCode当前稳定版本2.1.195已实测。备用方式无 winget 时使用npm install -g anthropic-ai/claude-code2) 验证安装与环境claude --version输出版本号即代表二进制安装成功。继续执行体检命令claude doctordoctor会检测 Node 版本、网络连通性、配置文件路径等环境项所有项目显示绿色 ✓表示环境就绪。五、配置 API 服务1) 安装 CC Switch进入官方网站下载 Windows 版安装包CC-Switch-Setup-x.x.x.exe。下载地址https://ccswitch.io/zh/双击安装全程默认下一步默认安装路径为C:\Users\用户名\AppData\Local\Programs\cc-switch\。2) 添加 API 配置启动 CC Switch在Claude Code板块点击添加配置填写以下字段字段填写内容配置名称自定义标识例如官方/中转-AAPI URL官方填https://api.anthropic.com第三方填服务商提供地址API Key粘贴 API 密钥模型 (可选)例如claude-sonnet-4-6填写完成后选中该配置 → 点击应用。CC Switch 会自动将配置写入C:\Users\用户名\.claude\settings.json3) 启动 Claude Code新开一个 cmd 窗口进入任意目录执行claude进入对话界面后输入你好测试AI 正常回复即表示全部部署完成。六、配置文件位置参考内容路径Claude Code 用户配置C:\Users\用户名\.claude\settings.jsonClaude Code 全局缓存C:\Users\用户名\.claude\npm 用户配置C:\Users\用户名\.npmrcCC Switch 安装目录C:\Users\用户名\AppData\Local\Programs\cc-switch\