Windows 安装 claude code 教程

Claude Code 安装教程

✅ 安装状态

Node.js: 已安装 (v24.12.0)
npm: 已配置淘宝镜像源 (https://registry.npmmirror.com)
Claude Code: 已安装 (v2.0.76)

📋 安装信息

Node.js

版本: v24.12.0 (LTS)
安装方式: 使用 winget 自动安装
安装路径: C:\Program Files\nodejs\

npm 配置

镜像源: https://registry.npmmirror.com (淘宝镜像)
全局包路径: C:\Users\Administrator\AppData\Roaming\npm

Claude Code

版本: 2.0.76
安装位置: C:\Users\Administrator\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code
命令: claude

🚀 使用方法

基本使用

在项目目录中启动 Claude Code:
powershell 复制代码
```
cd 你的项目目录
claude
```
查看版本信息:
powershell 复制代码
```
claude --version
```
查看帮助信息:
powershell 复制代码
```
claude --help
```

配置 API（如果需要）

如果在中国网络环境下需要配置代理或 API，可以设置以下环境变量：

powershell 复制代码

# 设置 API 基础 URL（如果需要代理）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://your-proxy-service.com/api", [System.EnvironmentVariableTarget]::User)

# 设置 API 密钥
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your_api_key", [System.EnvironmentVariableTarget]::User)

设置后需要重启终端才能生效。

🔧 网络问题解决方案

如果遇到网络连接问题：

检查 npm 镜像源:
powershell 复制代码
```
npm config get registry
```
应该显示: https://registry.npmmirror.com
如果镜像源不正确，重新设置:
powershell 复制代码
```
npm config set registry https://registry.npmmirror.com
```
清除 npm 缓存:
powershell 复制代码
```
npm cache clean --force
```

使用代理（如果有）:

powershell 复制代码

npm config set proxy http://your-proxy:port
npm config set https-proxy http://your-proxy:port

验证网络连接:
powershell 复制代码
```
npm ping
```

📝 常见问题

Q1: 命令 'claude' 无法识别

解决方案:

重启终端或 PowerShell
检查环境变量 PATH 是否包含 npm 全局路径
手动添加到 PATH: C:\Users\Administrator\AppData\Roaming\npm

Q2: 安装失败或网络超时

解决方案:

确保 npm 镜像源已设置为淘宝镜像
检查网络连接
尝试使用 VPN 或代理
清除缓存后重试

Q3: 权限错误

解决方案:

确保以管理员身份运行 PowerShell（如果需要）
或使用用户目录安装（已自动配置）

🎯 下一步

在项目目录中运行 claude 启动 Claude Code
根据提示配置 API 密钥（如果需要）
开始使用 Claude Code 进行代码开发

📚 相关资源

Claude Code 官方文档: https://docs.anthropic.com/zh-CN/docs/claude-code/setup
npm 淘宝镜像: https://npmmirror.com/
Node.js 官方文档: https://nodejs.org/zh-cn/docs/

安装方式 : 自动化脚本 + winget
网络环境: 中国（已配置国内镜像源）