Claude Code 多种安装方式介绍

发表于 更新于 阅读次数： 评论数： 本文字数： 799 阅读时长 ≈ 1 分钟

通用平台

NodeJs 安装方式

Claude Code 的本质是一个基于 Node.js 运行的命令行程序（CLI），它通过 npm 包管理器进行分发，兼容 Windows / Linux /macOS 平台。因此，在安装之前，必须确保系统中已经正确安装了 Node.js。

  • NPM 设置镜像源
1
2
3
4
5
# 通过 NPM 设置淘宝镜像源（解决 NPM 下载慢的问题）
npm config set registry https://registry.npmmirror.com

# 通过 NPM 查看镜像源地址
npm config get registry
  • NPM 安装 Claude Code
1
2
3
4
5
# 通过 NPM 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证 Claude Code 安装
claude --version

扩展阅读

Linux 平台

Linux、WSL 安装方式

2026 年 Claude Code 有重大更新，支持在 Linux 平台原生安装，可以省去手动安装 Node.js。原生安装器自带所有依赖，一条命令就可以搞定 Claude Code 安装。

  • 设置网络代理（避免网络请求被墙和触发 Cloudflare 的人机验证）
1
2
3
4
5
6
7
8
9
10
11
# 在终端中设置 HTTP 代理
export HTTP_PROXY="http://127.0.0.1:8080"

# 在终端中设置 HTTPS 代理
export HTTPS_PROXY="http://127.0.0.1:8080"

# 如果 HTTP 代理需要用户名和密码验证
export HTTP_PROXY="http://用户名:密码@127.0.0.1:8080"

# 如果 HTTPS 代理需要用户名和密码验证
export HTTPS_PROXY="http://用户名:密码@127.0.0.1:8080"
  • 验证网络代理是否可用
1
2
3
4
5
# 检查终端能否访问 Claude
ping claude.ai

# 检查终端能否访问 Anthropic API
ping api.anthropic.com
  • 原生安装 Claude Code
1
2
# 在终端中原生安装 Claude Code（耗时较长）
curl -fsSL https://claude.ai/install.sh | bash
1
2
3
4
5
6
[终端显示]
Downloading Claude Code...
Installing to C:\Users\你的用户名\.local\bin\
✓ Installation complete!

Run 'claude --version' to verify.
  • 验证 Claude Code 安装
1
2
# 查看 Claude Code 版本号
claude --version

扩展阅读

Windows 平台

PowerShell 安装方式

2026 年 Claude Code 有重大更新，支持在 Windows 平台原生安装，可以省去手动安装 Node.js。原生安装器自带所有依赖，一条命令就可以搞定 Claude Code 安装。

  • 设置网络代理（避免网络请求被墙和触发 Cloudflare 的人机验证）
1
2
3
4
5
6
7
8
9
10
11
# 在 PowerShell 中设置 HTTP 代理
$env:HTTP_PROXY="http://127.0.0.1:8080"

# 在 PowerShell 中设置 HTTPS 代理
$env:HTTPS_PROXY="http://127.0.0.1:8080"

# 如果 HTTP 代理需要用户名和密码验证
$env:HTTP_PROXY="http://用户名:密码@127.0.0.1:8080"

# 如果 HTTPS 代理需要用户名和密码验证
$env:HTTPS_PROXY="http://用户名:密码@127.0.0.1:8080"
  • 验证网络代理是否可用
1
2
3
4
5
# 检查 PowerShell 能否访问 Claude
ping claude.ai

# 检查 PowerShell 能否访问 Anthropic API
ping api.anthropic.com
  • 临时绕过执行策略（允许 PowerShell 执行脚本）
1
2
# 在 PowerShell 中临时绕过执行策略，请确保命令中包含 -Scope Process，然后根据提示信息选择 Y；这个命令只对当前 PowerShell 窗口生效，关闭窗口后就失效了，不会有任何提示，直接执行完毕
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
  • 原生安装 Claude Code
1
2
# 在 PowerShell 中原生安装 Claude Code（耗时较长）
irm https://claude.ai/install.ps1 | iex
1
2
3
4
5
6
[PowerShell显示]
Downloading Claude Code...
Installing to C:\Users\你的用户名\.local\bin\
✓ Installation complete!

Run 'claude --version' to verify.
  • 验证 Claude Code 安装
1
2
3
4
# 查看 Claude Code 版本号
claude --version

# 如果提示找不到 claude 命令，则需要添加 C:\Users\用户名\.local\bin 到 PATH 环境变量

扩展阅读

常见问题

原生安装方式下载很慢

推荐使用 cc-download 这个开源项目，在 Windows / Linux /macOS 上安装和更新 Claude Code，支持设置代理、显示下载进度，并支持下载离线安装包到本地机器。

参考资料