跳至主要内容

系統要求與安裝

今天聊聊Claude Code的安裝。看起來簡單，但有些坑需要注意。

系統要求​

先確認你的機器滿足這些條件：

作業系統​

  • macOS：10.15 (Catalina) 或更高版本
  • Linux：Ubuntu 20.04+、Debian 10+ 或其他主流發行版
  • Windows：透過WSL 2 支援

硬體​

  • 記憶體：至少 4GB RAM（推薦 8GB+）
  • 磁碟空間：至少 500MB
  • 處理器：現代多核處理器

軟體依賴​

  • Node.js：版本 18 或更高（推薦 LTS 版本）
  • npm：隨 Node.js 自動安裝
  • git：版本 2.23 或更高（可選，但推薦）

檢查版本：

node --version
npm --version
git --version

網路要求​

  • 穩定的網際網路連線
  • 能訪問 Anthropic API 服務
  • 國內使用需要配置代理

安裝 Node.js​

還沒裝Node.js？按下面步驟來。

macOS​

# 使用 Homebrew 安装
brew install node

# 或从官网下载安装包
# https://nodejs.org/

Linux​

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 或使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts

Windows (WSL)​

# 在 WSL 中使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts

驗證安裝：

node --version  # 应显示 v18.x.x 或更高
npm --version

安裝 Claude Code​

全域性安裝​

最簡單的方式，全域性安裝後任何目錄都能用：

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

等幾分鐘就好。

驗證安裝​

claude --version

顯示版本號就說明成功了。

檢視幫助​

claude --help

國內網路環境配置​

國內使用者需要注意。

使用 npm 映象源​

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

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

# 恢复默认源（可选）
npm config set registry https://registry.npmjs.org

配置代理​

有代理的話：

# 设置代理
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

# Windows (PowerShell)
$env:HTTP_PROXY="http://your-proxy:port"
$env:HTTPS_PROXY="http://your-proxy:port"

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

常見問題​

許可權錯誤​

# macOS/Linux
sudo npm install -g @anthropic-ai/claude-code

# 或修改 npm 全局安装目录（推荐）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

網路超時​

# 增加超时时间
npm install -g @anthropic-ai/claude-code --timeout=60000

# 或使用代理/镜像源

Node.js 版本過低​

# 检查版本
node --version

# 升级
# macOS
brew upgrade node

# 使用 nvm
nvm install --lts
nvm use --lts

找不到 claude 命令​

# 检查全局安装路径
npm config get prefix

# 添加到 PATH
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

更新與解除安裝​

更新​

# 检查当前版本
claude --version

# 更新
npm update -g @anthropic-ai/claude-code

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

解除安裝​

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

下一步​

安裝完成後：

  1. 註冊 Anthropic 賬號並認證
  2. 瞭解基本使用方法
  3. 探索核心功能

參考資源​