甘剑平2. 环境准备：先把Windows 10这台机器收拾利索
2.1 确认系统与终端状态
Claude Code本质是一个运行在终端里的命令行程序，在Windows 10上装它之前，先确认你本机的基础状态是否到位。我见过不少朋友一上来就敲 npm install -g @anthropic-ai/claude-code，结果卡在各种环境报错上，浪费大量时间。其实只要先把下面三样东西确认好，后面几乎是一路绿灯。
第一，操作系统版本。Windows 10的20H2及以上版本都能正常跑Claude Code，老版本（比如1809之前的）虽然理论上也能装，但终端组件和内置的OpenSSH版本可能比较旧，容易在连接远程仓库或执行某些命令时出幺蛾子。我的建议是尽量保持系统更新到最新补丁，尤其要确认PowerShell版本在5.1以上。你可以在PowerShell里输入 $PSVersionTable.PSVersion 查看，如果版本太低，建议直接装Windows Terminal并把默认Shell设为PowerShell 7，后面用起来会顺手很多。
第二，包管理器。Claude Code官方推荐用npm安装，但Windows 10自带的Node.js是缺位的，需要自己去装。这里有一个选择：装Node.js官方安装包（LTS版本）还是用winget？我个人的习惯是直接用Node.js官网的LTS安装包，因为安装过程会自动帮你配好PATH，省去后面手动设环境变量的步骤。如果你电脑上已经有Chocolatey或Scoop，也可以直接 choco install nodejs-lts 或 scoop install nodejs-lts，但新手我更推荐官网安装包，可视化界面点几下就完事，不容易出错。
第三，Git。Claude Code虽然不是一个Git工具，但它经常需要读取项目里的Git信息（比如当前分支、最近提交记录）来辅助理解代码上下文。Windows 10不自带Git，你需要去git官网下载安装。安装时注意选"Git from the command line and also from 3rd-party software"这个选项，确保Git能被命令行直接调用。装完可以在PowerShell里输入 git --version 验证。
2.2 安装Node.js并验证环境变量
Node.js的版本选择很有讲究。Claude Code官方要求Node.js版本不低于18.0.0，但实测我建议直接用20.x LTS版本，因为18在某些老版本上跑过一些依赖兼容问题，而20是当前稳定主流。你可以在官网下载页面找到"LTS"字样的版本下载，不要选"Current"版（那个是新特性试用版，稳定性差点）。
安装过程中有一个关键勾选项：在安装向导中，一定要把"Add to PATH"勾上。默认是勾选的，但有些朋友手滑取消了，装完发现 node 命令没法用，还得手动去补环境变量。安装完成后，重新打开一个PowerShell窗口（注意要重新打开，否则环境变量不会刷新），输入：
powershell复制node -v
npm -v
如果分别输出了类似 v20.x.x 和 10.x.x 的数字，说明Node环境和npm包管理器都已就绪。这一步极其重要，因为后面所有Claude Code的安装和升级都依赖npm。如果这里报错"node不是内部或外部命令"，多半是PATH没有配置好，需要手动去系统环境变量里把Node.js的安装目录（比如 C:\Program Files\nodejs\）加进去。
2.3 模型接入方案选型：官方API、第三方API还是本地模型
环境准备好之后，还有一个更重要的选择题：你到底要让Claude Code调用哪个模型？这个问题很多人装完了才想，结果发现卡在API Key配置上。我建议在安装之前就想清楚，因为不同的接入方式决定了你要做哪些环境变量配置。
第一种是官方API方式。直接在Anthropic控制台创建API Key，然后设置 ANTHROPIC_API_KEY 环境变量。官方API的模型能力最完整、最稳定，对新功能的跟进也最快，但需要海外网络环境，而且按使用量计费，价格不算便宜。
第二种是第三方兼容API方式。现在国内外不少模型服务商提供了Anthropic兼容接口，你只需要把 ANTHROPIC_BASE_URL 指向它们的地址，设置对应的API Key和模型名，就能让Claude Code跑在DeepSeek、混元、MiniMax等模型上。这个方案对国内用户特别友好，网络稳定、价格更低，而且模型能力也不弱。我身边很多同事就是这么接的，成本控制得很好。
第三种是本地模型方式。通过Ollama等工具在本地运行开源模型（比如Qwen2.5、DeepSeek-R1蒸馏版），然后把Claude Code指向本地的 http://localhost:11434 地址。这种方式完全免费、数据不外泄，但受限于本机硬件，模型参数量不能太大，代码理解能力比云端模型要差一些，适合简单任务或者对隐私要求极高的场景。
这三种方案怎么选？我给的参考标准很简单：如果你是按量付费、追求最强代码能力，选官方API；如果你在国内网络环境下想要稳定、便宜的方案，首选第三方兼容API；如果你要处理敏感代码、不能出内网，那只能选本地模型。下面这篇博文会重点讲官方API和第三方兼容API的配置，本地模型作为备选方案也会简单提一下。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。