Windows上使用配置Claude Code教程
1️⃣ 安装 Node.js
一、💻 安装 Node.js
1. 下载安装包
首先,访问 Node.js 官方网站。
- 推荐版本:建议下载 LTS (Long-Term Support) 版本,因为它具有长期支持,更稳定。
- 选择系统:根据您的操作系统(Windows / macOS / Linux)下载对应的安装包。
2. 运行安装程序
对于 Windows 用户:
- 双击下载的
.msi
文件。 - 遵循安装向导的指引进行安装。
- 关键步骤:请务必勾选 “Add to PATH” 选项,这将自动为您配置环境变量。
对于 macOS 用户:
- 双击下载的
.pkg
文件。 - 根据屏幕提示完成安装步骤。
对于 Linux 用户 (以 Ubuntu/Debian 为例):
您可以通过包管理器进行安装,打开终端并执行以下命令:
# 更新包列表
sudo apt update# 安装 Node.js 和 npm
sudo apt install nodejs npm
二、✅ 验证安装
安装完成后,打开您的终端(在 Windows 上是 命令提示符 或 PowerShell),执行以下命令来验证 Node.js 和 npm 是否安装成功。
# 查看 Node.js 版本
node -v# 查看 npm 版本
npm -v
如果终端成功返回了版本号(例如 v20.11.0
和 10.2.4
),则证明安装已成功!
三、🔧 环境变量配置 (手动)
如果在安装过程中忘记勾选 “Add to PATH”,或者自动配置失败,您需要手动进行配置。
Windows 系统配置
- 右键点击 “此电脑” → “属性” → “高级系统设置” → “环境变量”。
- 在 “系统变量” 区域找到名为
Path
的变量,选中后点击 “编辑”。 - 点击 “新建”,并添加以下两个路径(请根据您的实际安装位置进行调整):
C:\Program Files\nodejs\
C:\Users\<你的用户名>\AppData\Roaming\npm
macOS / Linux 系统配置
-
编辑您的 shell 配置文件,通常是
~/.bashrc
(Bash) 或~/.zshrc
(Zsh)。 -
在文件末尾添加以下内容:
# Node.js 和 npm 的全局路径 export PATH="/usr/local/bin:$PATH" export PATH="$HOME/.npm-global/bin:$PATH"
-
保存文件后,执行以下命令使配置立即生效:
# 如果您使用的是 Bash source ~/.bashrc# 如果您使用的是 Zsh source ~/.zshrc
四、💡 常见问题与解决方案
1. node
或 npm
命令未被识别
- 原因:环境变量没有在当前的终端会话中生效。
- 解决方案:
- 重启终端:最简单直接的方法是关闭所有已打开的终端窗口,然后重新打开一个。
- 刷新环境变量 (Windows):在某些版本的 Windows 上可以尝试
refreshenv
命令,但重启终端更通用。 - 刷新配置 (macOS/Linux):执行
source ~/.bashrc
或source ~/.zshrc
。
2. 全局安装模块时的权限问题 (EACCES)
-
原因:在 Linux 或 macOS 上,直接使用
npm install -g
命令可能会因为没有系统目录的写入权限而失败。 -
解决方案:建议配置一个用户专属的全局安装目录,避免使用
sudo
。# 1. 创建一个用于存放全局包的目录 mkdir ~/.npm-global# 2. 配置 npm 使用该目录作为新的全局安装路径 npm config set prefix '~/.npm-global'
完成后,请确保已将
$HOME/.npm-global/bin
添加到您的PATH
环境变量中(如步骤三所示)。
3. 需要配置网络代理
如果您的网络环境需要通过代理服务器访问互联网,请为 npm 配置代理。
# 设置 HTTP 和 HTTPS 代理
npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080
五、🚀 运行第一个 Node.js 程序
一切就绪后,让我们来运行一个简单的脚本以最终确认环境配置无误。
1. 创建测试文件
创建一个名为 test.js
的文件,并输入以下内容:
console.log("Node.js 运行成功!欢迎进入 Node.js 的世界。");
2. 运行脚本
在终端中,切换到 test.js
文件所在的目录,并执行以下命令:
node test.js
✅ 如果您的终端上成功输出了 “Node.js 运行成功!欢迎进入 Node.js 的世界。”,那么恭喜您,整个环境已全部配置完成!
2️⃣ 安装 Claude Code
npm install -g @anthropic-ai/claude-code
claude --version
3️⃣ 配置claude的API
1、获取API
通过下面链接获取claude code中转站的api:Any Router, 通过这个链接可以获得100$的额度。
注册后在 API令牌 页面点击 添加令牌 获得(以 sk- 开头),名称随意,额度建议设为无限额度,其他保持默认设置即可。
2、更改claude code 的api和代理URL
2.1. 先打开Windows环境变量
2.2 在下面的系统变量中,新建
2.3 设置变量名为:
ANTHROPIC_AUTH_TOKEN
设置密码为刚才申请的api
填入后
2.4 设置代理的URL
再新建一个系统变量
设置变量名为:
ANTHROPIC_BASE_URL
变量值为:
https://anyrouter.top
3、把当前打开的cmd或者powershell或者vscode都关闭再重新打开(刷新设置)
3.1 查看环境变量是否生效:
在 Windows 系统中,在 cmd (命令提示符) 中使用 echo 命令来查看特定系统环境变量的值。
要查看 ANTHROPIC_BASE_URL 变量的值,请打开 cmd 并输入以下命令:
echo %ANTHROPIC_BASE_URL%
要查看 ANTHROPIC_AUTH_TOKEN 变量的值,请打开 cmd 并输入以下命令:
echo %ANTHROPIC_AUTH_TOKEN%
可以打印出刚才设置的值,就设置成功了,即可使用claude code了
4️⃣ 在cmd或者powershell中使用claude code
输入claude命令打开claude code
claude
可以使用了!