Windows10安装Claude Code 国内使用最新教程（完全免费）
Windows10安装Claude Code 国内使用最新教程（完全免费）
一、前置必备环境（所有方案必做）
1. 系统要求确认
Windows 10 必须升级至 22H2 及以上版本（设置→系统→关于，查看系统版本号）
全程必须以管理员身份运行 PowerShell / Windows终端（右键开始菜单，选择「终端管理员」/「Windows PowerShell(管理员)」）
2. 安装Node.js（v18+ LTS版本）
CLI工具必备，桌面客户端可选安装，解决后续依赖问题。
- 方式一：一键安装（推荐）
管理员PowerShell执行命令：
winget install OpenJS.NodeJS.LTS- 方式二：官网手动安装
访问 Node.js官网，下载Windows LTS版本.msi安装包，全程默认下一步即可。
验证安装：新开管理员PowerShell，执行以下命令，正常输出版本号即成功
node -v
npm -v
3. 配置NPM国内镜像（解决安装慢/失败问题）
npm config set registry https://registry.npmmirror.com二、方案A 国内零成本合规方案（强烈推荐，完全免费、无魔法、直连可用）
核心原理
通过兼容Anthropic官方API协议的国产大模型，替换Claude Code的默认服务接口，实现国内网络直连、无风控、零成本使用，全程无需海外账号和特殊网络环境，新用户可领取永久免费额度，日常编程使用完全足够。
本方案以**智谱AI（新用户免费额度最高、长期可用、兼容性最好）**为例，步骤如下：
步骤1：安装Claude Code Windows客户端（二选一）
安装完成后，先不要打开客户端，先完成后续配置！（方式一本地安装失败、方式二安装成功。）
方式一：PowerShell一键安装（官方原生，推荐）
管理员PowerShell执行以下命令，等待1-3分钟，提示安装完成即可：
irm https://claude.ai/install.ps1 | iex
方式二：Winget安装（适合已配置Winget的用户）
winget install Anthropic.ClaudeCode
步骤2：注册免费账号，获取API密钥（零成本，国内直连）
访问 智谱AI开放平台官网
用手机号完成注册与实名（国家合规要求，全程免费，无任何付费门槛）
注册成功后，进入「API密钥管理」页面，点击「创建新的API密钥」
复制生成的以sk.开头的完整密钥，妥善保存（请勿泄露）
新用户福利：注册自动赠送海量免费tokens，glm-4-flash模型永久免费无额度限制，日常编程完全够用，签到可持续领取免费额度，实现永久免费使用。
步骤3：修改配置，实现国内直连免魔法
打开Windows文件资源管理器，在地址栏输入 %USERPROFILE%.claude ，回车进入Claude Code配置文件夹
找到 settings.json 文件，用记事本/VS Code打开
清空原有内容，完整替换为以下配置，将你的智谱API密钥替换为步骤2中复制的密钥：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的智谱API密钥","ANTHROPIC_BASE_URL":"https://open.bigmodel.cn/api/anthropic","API_TIMEOUT_MS":"300000","ANTHROPIC_MODEL":"glm-4-flash"}}
可选优化：如需更高精度模型，可将glm-4-flash替换为glm-5，使用注册赠送的免费额度。
- 保存文件，关闭编辑器。
步骤4：验证与启动使用
从开始菜单打开「Claude Code」客户端，或在项目文件夹右键打开终端，执行 claude 命令启动CLI工具
无需登录海外账号，直接进入主界面，输入编程指令即可正常使用
功能测试：输入「帮我写一个Python冒泡排序算法，并添加详细注释」，正常返回结果即配置成功
备选兼容方案（DeepSeek，新用户赠送1000万免费tokens）
注册地址：DeepSeek开放平台
settings.json 配置替换为：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的DeepSeek API密钥","ANTHROPIC_BASE_URL":"https://api.deepseek.com/v1/anthropic","API_TIMEOUT_MS":"300000","ANTHROPIC_MODEL":"deepseek-chat-v2"}}
三、方案B 官方原生免费方案（适合拥有合规海外网络环境的用户）
核心说明：使用Anthropic官方免费账号+原生服务，需要合规的海外网络环境，免费版有固定使用额度限制，Pro版需付费订阅。
步骤1：前置环境与网络准备
完成第一部分的前置环境安装，确保网络环境可正常访问claude.ai。
步骤2：注册Claude官方免费账号
访问 Claude官网
使用海外邮箱（Gmail/Outlook等）完成注册，支持Google账号一键登录
完成海外手机号验证（国内手机号无法注册官方账号）
注册成功后，即可获得免费版使用额度，支持Claude 3.5 Sonnet核心模型。
步骤3：安装与登录使用
管理员PowerShell执行官方一键安装命令：
irm https://claude.ai/install.ps1 | iex
打开Claude Code客户端，点击「登录」，自动跳转浏览器打开Claude官网登录页
用注册好的官方账号完成登录，授权客户端访问权限
授权成功后，自动跳转回客户端，即可正常使用全部官方功能
四、CLI命令行工具补充安装（可选，适合终端用户）
完成前置环境配置后，管理员PowerShell执行以下命令，即可全局安装Claude Code CLI工具：
npm install -g @anthropic-ai/claude-code验证安装：
claude --version配置完成后，在任意项目文件夹的终端中执行 claude 命令，即可快速启动编程助手。
五、常见问题排查与避坑指南
- 安装时提示「权限不足」
解决：必须以管理员身份运行PowerShell/终端，右键开始菜单选择对应管理员选项，重新执行安装命令。
- 安装命令执行后无反应/下载失败
解决：方案A无需特殊网络，可重试命令；方案B需确保网络环境可正常访问claude.ai，更换合规节点重试。
- 启动后提示「认证失败/API错误」
解决：检查settings.json中的API密钥是否正确，BASE_URL是否完整，无多余空格和换行；确认API账号有可用免费额度。
- 国内网络连接超时/无法访问
解决：优先使用方案A，完全国内直连，无需特殊网络；方案B必须使用合规的海外网络环境，否则无法正常访问官方服务。
- Windows10版本过低无法安装
解决：打开设置→Windows更新，升级系统至22H2及以上版本，旧版本系统不支持Claude Code原生客户端。