一、安装 Node.js(必装前置依赖)
访问 Node.js 官网:https://nodejs.org/,下载安装包并运行,保持默认设置完成安装
✅ 验证 Node.js 安装成功
打开 PowerShell,输入以下两条命令,能正常显示版本号即安装完成:
bash
node --version
npm --version
二、全局安装 Claude Code
打开 PowerShell执行全局安装命令:
bash
npm install -g @anthropic-ai/claude-code
✅ 验证 Claude Code 安装成功
安装完成后,在PowerShell中输入以下命令,显示版本号即为安装成功:
bash
claude --version
三、配置 Claude Code 环境变量(核心步骤)
配置环境变量的目的是让 Claude Code 正常连接中转服务,提供临时生效 和永久生效两种方式,按需选择即可。
方式1:PowerShell 临时配置(仅当前会话生效)
打开PowerShell,直接执行两条命令即可,关闭窗口后失效,适合临时使用:
bash
$env:ANTHROPIC_BASE_URL = "API地址"
$env:ANTHROPIC_AUTH_TOKEN = "API密钥"
方式2:PowerShell 永久配置
配置后永久生效,所有新建的PowerShell窗口均可使用,命令如下:
bash
# 写入用户级环境变量,永久生效
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "API地址", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "API密钥", [System.EnvironmentVariableTarget]::User)
查看已配置的环境变量(可选)
如需确认配置是否成功,执行以下命令即可查看对应变量值:
bash
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)
温馨提示:永久配置完成后,重启一次PowerShell,环境变量才能生效。
文末小提示
所有操作全程使用 PowerShell 即可,避免CMD的各类兼容问题;权限报错的核心解决办法就是「管理员身份运行PowerShell」,这两个小细节能避开90%的安装问题。