Claude Code 全平台安装教程

前置要求

• Node.js 18+（推荐 20+）
• Git
• 有效的 Anthropic API Key（或第三方中转站 API）

Windows 安装

第一步：打开 PowerShell（管理员模式）

有以下几种方式打开管理员 PowerShell：

方式一：开始菜单搜索

1. 点击屏幕左下角的 开始按钮（或按 Win 键）
2. 输入 PowerShell
3. 在搜索结果中找到 Windows PowerShell
4. 右键点击 → 选择 以管理员身份运行
5. 在弹出的用户账户控制窗口点击 是

方式二：Win + X 快捷键

1. 按下 Win + X 组合键
2. 选择 Windows PowerShell（管理员） 或 终端（管理员）

方式三：右键开始菜单

1. 右键点击 屏幕左下角的开始按钮
2. 选择 Windows PowerShell（管理员） 或 终端（管理员）

⚠️ 确保窗口标题显示「管理员」字样，否则安装可能失败

第二步：运行一键安装脚本

在 PowerShell 窗口中复制粘贴以下命令，然后按回车：

Set-ExecutionPolicy Bypass -Scope Process -Force; irm https://llmhu.me/scripts/install-claude-code-windows.ps1 | iex

脚本会自动安装：

• Chocolatey（Windows 包管理器）
• Git
• Node.js 20.x
• Claude Code

第三步：配置 API

安装过程中会提示配置 API：

使用中转站（推荐国内用户）：

• 输入 y 选择使用中转站
• 输入中转站地址（如 https://api.example.com/v1）
• 输入 API Key

使用官方 API：

• 直接按回车
• 输入 Anthropic API Key

手动安装方法

如果一键脚本失败，可以手动安装：

# 1. 安装 Node.js（访问 https://nodejs.org 下载）

# 2. 安装 Git（访问 https://git-scm.com 下载）

# 3. 打开新的 PowerShell，安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 4. 验证安装
claude --version

配置环境变量

# 设置 API Key（中转站）
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-api-key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://your-proxy-url.com/v1", "User")

设置后需要重新打开 PowerShell 窗口才能生效。

macOS 安装

打开终端

1. 按 Cmd + 空格 打开 Spotlight
2. 输入 Terminal 或 终端
3. 按回车打开

一键安装

curl -fsSL https://llmhu.me/scripts/install-claude-code-macos.sh | bash

手动安装

# 1. 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装 Node.js 和 Git
brew install node git

# 3. 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 4. 验证
claude --version

配置 API

编辑 ~/.zshrc 文件，添加：

export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_BASE_URL="https://your-proxy-url.com/v1"

然后运行 source ~/.zshrc 使配置生效。

Linux 安装

一键安装（推荐）

curl -fsSL https://llmhu.me/scripts/install-claude-code-linux.sh | bash

Ubuntu/Debian 手动安装

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

# 安装 Claude Code
sudo npm install -g @anthropic-ai/claude-code

CentOS/RHEL 手动安装

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

配置 API

编辑 ~/.bashrc，添加：

export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_BASE_URL="https://your-proxy-url.com/v1"

运行 source ~/.bashrc 生效。

启动 Claude Code

# 进入项目目录
cd /path/to/your/project

# 启动
claude

常见问题

Q: 提示 "command not found: claude"

• 重新打开终端窗口
• 确保 Node.js 全局安装路径已添加到系统 PATH

Q: 连接超时

• 建议使用第三方中转站
• 检查 ANTHROPIC_BASE_URL 是否正确配置

Q: Windows 脚本显示乱码

• 使用最新版脚本（已改为英文）

Q: 权限不足

• Windows：确保以管理员身份运行 PowerShell
• Linux/macOS：使用 sudo 运行

下一步

• 配置常用 MCP 服务器
• 一键安装脚本使用说明