前言

最近想试试Claude Code，但搜了一圈教程，不是步骤零散就是默认海外环境，对国内用户不太友好。

所以特意整理了这篇Windows下的 Claude Code 完整实操，从环境准备到模型调用，每一步都尽量写清楚，希望能帮大家少踩坑。

正文

一、准备工作：安装Node.js环境

Claude Code运行依赖Node.js，最低要求Node.js ≥18（建议LTS版本，稳定性更好）。

方法一：官网下载（推荐新手）

1. 访问 Node.js官网，选择Windows LTS版本下载
2. 双击安装包，按向导默认安装即可（安装时建议勾选“Add to PATH”，自动配置环境变量）

方法二：包管理器安装（适合熟悉命令行用户）

如果已安装Chocolatey或Scoop，可直接用命令安装：

# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs

验证安装是否成功

打开PowerShell（建议管理员模式，避免权限问题），输入以下命令：

node--version# 输出示例：v20.11.0（版本号≥18即可）npm--version# 输出示例：10.2.4

⚠️ 提示：如果命令提示“不是内部或外部命令”，检查Node.js是否已添加到系统环境变量，或重启终端再试。

二、安装Claude Code

环境准备好后，用npm全局安装Claude Code：

npminstall-g@anthropic-ai/claude-code

安装完成后验证：

claude--version# 输出版本号即成功（如：1.0.0）

三、配置API连接：获取并设置API Key

Claude Code需要API Key才能调用模型，我最近用的是88api中转（网址：https://api.88api.shop），推荐大家可以试试，或者大家也可以用自己的。

获取API Key步骤：

1.注册登录后，点击 “API 令牌”

2.点击添加令牌

3. 创建令牌

名称随便写，没有含义，直接点击提交即可。

4. 获取 API KEY

获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。

5. 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
   

四、解决登录问题：用CC Switch配置模型

Claude Code默认需要登录官方账号，对国内用户不太方便。这里用开源工具CC Switch快速管理API配置和模型切换，无需手动改配置文件。

具体下载版本链接：https://github.com/farion1231/cc-switch/releases

1. 一直往下拉，拉到下面这个位置下载
   
2. 根据你的操作系统，下载对应的安装包。Linux、MacOS、Windows看文件名能区分。或点击 “show all 18 assets” 往下拉找更多的版本。

3. 在CC Switch主界面，点击「Claude code」图标，再点击「+」号添加配置

4. 选择「自定义配置」，填写：

• 供应商名称：随意填写
• API KEY：粘贴前面复制的 api密钥
• API请求地址：https://api.88api.shop/v1

5. 继续点击「高级选项」，配置模型，支持多模型切换。

在「模型」栏填写具体模型名称（比如我最近在用claude-sonnet-4-6），最后点击添加就可以了。

这里也是之后你切换模型的地方，可以选择你想要使用的模型。

💡 如果不知道模型名称，可以进入首页「模型广场」，查看所有模型，点击左下角复制即可。
然后直接在 cc Switch 里修改模型名称即可切换模型。

6. 最后点击启用，重启 claude code

保存好以后，点击启用。启用完毕之后，需要重启claude code，使得配置生效。

⚠️ ⚠️ 注意：若启动后因为连接问题无法使用，尝试修改API请求地址为https://api.88api.shop（去除/v1），重启后再试。（我实操时遇到过这个问题，改地址后解决）。

五、开始使用Claude Code

启动Claude Code

打开终端，输入命令：

claude

测试是否正常工作

输入“你好”，若能收到回复，说明配置成功：

常用命令速查表

总结

到这里，Windows下Claude Code的安装、API配置和模型切换就全部完成了。核心步骤是Node.js环境准备、API Key获取，以及用CC Switch简化配置——这三个环节走通，基本就能顺畅使用了。如果过程中遇到问题，欢迎在评论区留言，我们一起排查解决。