下载 Claude Code

在您的终端中直接体验 Claude 的强大力量。支持 macOS、Linux 和 Windows (WSL)。

安装步骤

只需几分钟即可开始使用 Claude Code

1

检查系统要求

Node.js 18+

需要 Node.js 18 或更高版本

下载 Node.js

操作系统

macOS, Linux, 或 Windows (with WSL)

账户

有效的 控制台账户或 Claude 订阅

2

安装 Claude Code

macOS 安装步骤

方法一:使用 npm(推荐)
Terminal
npm install -g @anthropic-ai/claude-code
方法二:使用 Homebrew
Terminal
brew install claude-code

如果您没有安装 Homebrew,请先运行:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Linux 安装步骤

方法一:使用 npm(推荐)
Terminal
npm install -g @anthropic-ai/claude-code
方法二:手动安装 Node.js

Ubuntu/Debian:

Terminal
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

CentOS/RHEL/Fedora:

Terminal
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs
npm install -g @anthropic-ai/claude-code

Windows 安装步骤

Step 1: 安装 WSL(Windows Subsystem for Linux)

在线安装(推荐):

PowerShell (管理员权限)
wsl --install
⚠️ 网络受限环境的离线安装方法

如果您的网络环境无法直接访问 Microsoft Store 或下载 WSL,请按以下步骤操作:

1. 启用 WSL 功能:

PowerShell (管理员权限)
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

2. 下载并安装 WSL2 Linux 内核更新包:

3. 设置 WSL2 为默认版本:

PowerShell
wsl --set-default-version 2

4. 离线下载 Ubuntu 发行版:

5. 安装下载的发行版:

PowerShell
# 替换为您下载的文件名
Add-AppxPackage .\Ubuntu_2004.2020.424.0_x64.appx
Step 2: 在 WSL 中安装 Node.js 和 Claude Code

重启系统后,打开 Ubuntu 终端并运行:

WSL Terminal
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code
替代方案:使用 Windows Package Manager (winget)
PowerShell
winget install OpenJS.NodeJS
npm install -g @anthropic-ai/claude-code

⚠️ 注意:Windows 原生环境下某些功能可能受限,推荐使用 WSL 环境

注意:全局安装确保您可以在任何目录中使用 claude 命令。

3

身份验证

使用 控制台账户

Terminal
claude auth login

这将在浏览器中打开 控制台进行身份验证。

使用 Claude 账户

Terminal
claude auth login --provider claude

使用您的 Claude Pro 或 Max 订阅账户登录。

4

验证安装

Terminal
claude --version

如果安装成功,您将看到 Claude Code 的版本信息。

开始使用

尝试您的第一个 Claude Code 命令

基本对话

Terminal
claude 你好,请帮我写一个Python函数

代码分析

Terminal
claude 分析这个项目的代码结构

交互模式

Terminal
claude --interactive

常见问题

安装或使用过程中遇到问题?这里有解决方案

权限错误

如果遇到权限错误,请尝试使用 sudo:

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

Node.js 版本过低

请确保您的 Node.js 版本是 18 或更高:

node --version

网络连接问题

如果安装失败,请检查网络连接或尝试使用代理:

npm config set proxy http://proxy.company.com:8080

身份验证失败

确保您有有效的 账户或 Claude 订阅:

claude auth status

需要更多帮助?

如果您在安装或使用过程中遇到其他问题,请查看我们的文档或联系支持团队。