Claude Code 安装指南
跟着这个教程，你可以轻松在自己的电脑上安装并使用 Claude Code。
📍 选择您的操作系统
🪟 Windows 安装教程
1 安装 Node.js 环境
Claude Code 需要 Node.js 环境才能运行。
方法一：官方下载（推荐）
- 访问 Node.js 官网
- 点击 "LTS" 版本进行下载
- 双击
.msi文件，按向导安装 - 验证安装：
node --version && npm --version方法二：使用包管理器
# 使用 Chocolatey
choco install nodejs
# 使用 Scoop
scoop install nodejs验证安装是否成功
- 装完成后，打开 PowerShell 或 CMD，输入以下命令：
node --version
npm --version如果显示版本号，说明安装成功了！
2 安装 Claude Code
方法一：PowerShell 一键安装（推荐）
# 管理员权限运行 PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://anthropic.com/claude-code/install.ps1 | iex方法二：npm 安装
npm install -g @anthropic/claude-code3 设置环境变量
配置 Claude Code 环境变量
为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：
方法一：PowerShell 临时设置（当前会话）
在 PowerShell 中运行以下命令：
$env:ANTHROPIC_BASE_URL = "你的url"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
方法二：PowerShell 永久设置（用户级）
在 PowerShell 中运行以下命令设置用户级环境变量：
# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "你的url", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)查看已设置的环境变量：
# 查看用户级环境变量
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)💡 设置后需要重新打开 PowerShell 窗口才能生效。
验证环境变量设置
设置完环境变量后，可以通过以下命令验证是否设置成功：
在 PowerShell 中验证：
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN在 CMD 中验证：
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%预期输出示例：
你的url
cr_xxxxxxxxxxxxxxxxxx💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。
4 开始使用 Claude Code
现在你可以开始使用 Claude Code 了！
启动 Claude Code
claude在特定项目中使用
# 进入你的项目目录
cd C:\path\to\your\project
# 启动 Claude Code
claude5 常见问题解决
问题：安装时提示 "permission denied" 错误
- 这通常是权限问题，尝试以下解决方法：
- 以管理员身份运行 PowerShell
- 或者配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm
问题：找不到 claude-code 命令
- 重新启动 PowerShell
- 检查是否以管理员身份安装
问题：PowerShell 执行策略错误
- 如果遇到执行策略限制，运行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser🍎 macOS 安装教程
1 安装 Node.js 环境
Claude Code 需要 Node.js 环境才能运行。
macOS 安装方法
方法一：使用 Homebrew（推荐）
如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：
# 更新 Homebrew
brew update
# 安装 Node.js
brew install node方法二：官网下载
- 访问 https://nodejs.org/
- 下载适合 macOS 的 LTS 版本
- 打开下载的
.pkg文件 - 按照安装程序指引完成安装
macOS 注意事项
- 如果遇到权限问题，可能需要使用 sudo
- 首次运行可能需要在系统偏好设置中允许
- 建议使用 Terminal 或 iTerm2
验证安装是否成功
安装完成后，打开 Terminal，输入以下命令：
node --version
npm --version如果显示版本号，说明安装成功了！
2 安装 Claude Code
安装 Claude Code
打开 Terminal，运行以下命令：
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code如果遇到权限问题，可以使用 sudo：
sudo npm install -g @anthropic-ai/claude-code验证 Claude Code 安装
安装完成后，输入以下命令检查是否安装成功：
claude --version如果显示版本号，恭喜你！Claude Code 已经成功安装了。
3 设置环境变量
配置 Claude Code 环境变量
为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：
方法一：临时设置（当前会话）
在 Terminal 中运行以下命令：
export ANTHROPIC_BASE_URL="你的url"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
方法二：永久设置
编辑你的 shell 配置文件（根据你使用的 shell）：
# 对于 zsh (默认)
echo 'export ANTHROPIC_BASE_URL="你的url"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc# 对于 bash
echo 'export ANTHROPIC_BASE_URL="你的url"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile4 开始使用 Claude Code
现在你可以开始使用 Claude Code 了！
启动 Claude Code
claude在特定项目中使用
# 进入你的项目目录
cd C:\path\to\your\project
# 启动 Claude Code
claude5 常见问题解决
问题：权限错误
# 配置 npm 权限
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc问题：macOS 安全设置阻止运行
- 如果系统阻止运行 Claude Code：
- 打开"系统偏好设置" → "安全性与隐私"
- 点击"仍要打开"或"允许"
- 或者在 Terminal 中运行：sudo spctl --master-disable
问题：环境变量不生效
- 检查以下几点：
- 确认修改了正确的配置文件（.zshrc 或 .bash_profile）
- 点重新启动 Terminal
- 验证设置：echo $ANTHROPIC_BASE_URL
🐧 Linux/WSL2 安装教程
1 安装 Node.js 环境
Claude Code 需要 Node.js 环境才能运行。
Linux 安装方法
方法一：使用官方仓库（推荐）
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs方法二：使用系统包管理器
虽然版本可能不是最新的，但对于基本使用已经足够：
# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm
# CentOS/RHEL/Fedora
sudo dnf install nodejs npmLinux 注意事项
- 某些发行版可能需要安装额外的依赖
- 如果遇到权限问题，使用 sudo
- 确保你的用户在 npm 的全局目录有写权限
验证安装是否成功
安装完成后，打开终端，输入以下命令：
node --version
npm --version如果显示版本号，说明安装成功了！
2 安装 Claude Code
安装 Claude Code
打开终端，运行以下命令：
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code如果遇到权限问题，可以使用 sudo：
sudo npm install -g @anthropic-ai/claude-code验证 Claude Code 安装
安装完成后，输入以下命令检查是否安装成功：
claude --version如果显示版本号，恭喜你！Claude Code 已经成功安装了。
3 设置环境变量
配置 Claude Code 环境变量
为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：
方法一：临时设置（当前会话）
在终端中运行以下命令：
export ANTHROPIC_BASE_URL="你的url"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
方法二：永久设置
编辑你的 shell 配置文件：
# 对于 bash (默认)
echo 'export ANTHROPIC_BASE_URL="你的url"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc# 对于 zsh
echo 'export ANTHROPIC_BASE_URL="你的url"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc4 开始使用 Claude Code
现在你可以开始使用 Claude Code 了！
启动 Claude Code
claude在特定项目中使用
# 进入你的项目目录
cd C:\path\to\your\project
# 启动 Claude Code
claude5 常见问题解决
问题：安装时提示权限错误
- 尝试以下解决方法：
- 使用 sudo 安装：sudo npm install -g @anthropic-ai/claude-code
- 或者配置 npm 使用用户目录：npm config set prefix ~/.npm-global
- 然后添加到 PATH：export PATH=~/.npm-global/bin:$PATH
问题：缺少依赖库
- 某些 Linux 发行版需要安装额外依赖：
# Ubuntu/Debian
sudo apt install build-essential
# CentOS/RHEL
sudo dnf groupinstall "Development Tools"问题：环境变量不生效
- 检查以下几点：
- 确认修改了正确的配置文件（.bashrc 或 .zshrc）
- 重新启动终端或运行 source ~/.bashrc
- 验证设置：echo $ANTHROPIC_BASE_URL
💡 更多帮助
开始您的 AI 编程之旅吧！ 🎉