📋 安装前准备

🔧 Node.js 环境

需要 Node.js 18+ 版本

下载 Node.js

🛡️ 安全软件

建议关闭 360 等安全软件

避免安装过程被拦截

🌐 网络环境

确保网络连接正常

无需梯子,国内直连

💻 选择您的操作系统

Windows 安装指南

🎉

重要更新:Claude Code 现已支持 Windows 原生安装!

无需 WSL,可直接在 Windows 上安装使用 Claude Code

1

安装 Node.js

从 Node.js 官网下载并安装 Windows 版本:

下载 Node.js for Windows

推荐下载 LTS(长期支持)版本,安装时保持默认设置即可

2

安装 Git for Windows (Git Bash)

Claude Code 需要 Git Bash 来正常运行。从 Git 官网下载并安装:

下载 Git for Windows

安装时选择默认配置即可,安装完成后可使用 Git Bash 终端

3

安装 Claude Code

打开 Git Bash、命令提示符(CMD)或 PowerShell,运行:

npm install -g @anthropic-ai/claude-code

推荐使用 Git Bash 运行此命令。如遇到权限问题,请以管理员身份运行

4

验证安装

claude --version

显示版本号即安装成功

📌 替代方案:使用 WSL 安装

如果您更喜欢 Linux 环境,或在 Windows 直接安装遇到问题,也可以选择使用 WSL:

查看 WSL 安装教程 →

macOS 安装指南

1

安装 Homebrew(如未安装)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2

安装 Node.js

brew install node

或从官网下载 Node.js 安装包

3

安装 Claude Code

npm install -g @anthropic-ai/claude-code
4

验证安装

claude --version

Linux 安装指南

1

安装 Node.js(Ubuntu/Debian)

# 更新包管理器
sudo apt update

# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
2

安装 Node.js(CentOS/RHEL/Fedora)

# 使用 dnf(Fedora)或 yum(CentOS/RHEL)
sudo dnf install nodejs npm
# 或
sudo yum install nodejs npm
3

安装 Claude Code

npm install -g @anthropic-ai/claude-code
4

验证安装

claude --version

🚀 首次使用

1. 启动 Claude Code

claude

首次运行会跳转到浏览器授权 (如果无法自动跳转请复制终端里的链接到浏览器里打开手动粘贴验证码)

2. 开始编程

登录成功后即可开始使用 Claude Code 进行 AI 辅助编程

claude   请给我写一个俄罗斯方块

💡 使用技巧:

  • 直接用自然语言描述需求
  • 可以要求解释现有代码
  • 支持多种编程语言
  • 可以进行代码优化和重构

🔧 常见问题解决

切换账号

# 删除配置文件
rm ~/.claudecode/config

# 退出 Claude Code 后重新运行
claude

完全卸载重装

# 卸载 Claude Code
npm uninstall -g @anthropic-ai/claude-code

# 清理配置文件
rm -rf ~/.claude*

# 验证卸载
claude --version

# 重新安装
npm install -g @anthropic-ai/claude-code

权限问题(macOS/Linux)

# 如果出现权限错误,使用 sudo
sudo npm install -g @anthropic-ai/claude-code

安装时网络问题

如果安装过程中网络缓慢,可以使用国内镜像源:

# 设置 npm 镜像源
npm config set registry https://registry.npmmirror.com

# 然后重新安装
npm install -g @anthropic-ai/claude-code

使用中网络问题

如果安装过程中网络缓慢,可以使用国内镜像源:


                                 claude --pick-relay