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

🚀 使用方法

基本使用

1. 在项目目录中启动 Claude Code:

   cd 你的项目目录
   claude
   

2. 查看版本信息:

   claude --version
   

3. 查看帮助信息:

   claude --help
   

配置 API（如果需要）

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

# 设置 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)

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

🔧 网络问题解决方案

如果遇到网络连接问题：

1. 检查 npm 镜像源:

   npm config get registry
   

   应该显示: https://registry.npmmirror.com

2. 如果镜像源不正确，重新设置:

   npm config set registry https://registry.npmmirror.com
   

3. 清除 npm 缓存:

   npm cache clean --force
   

4. 使用代理（如果有）:

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

5. 验证网络连接:

   npm ping
   

📝 常见问题

Q1: 命令 ‘claude’ 无法识别

解决方案:

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

Q2: 安装失败或网络超时

解决方案:

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

Q3: 权限错误

解决方案:

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

🎯 下一步

1. 在项目目录中运行 claude 启动 Claude Code
2. 根据提示配置 API 密钥（如果需要）
3. 开始使用 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
网络环境: 中国（已配置国内镜像源）