安装与更新

系统要求

Node.js 18 或更高版本
操作系统：macOS、Linux、Windows（通过 WSL 或原生）
Anthropic API Key 或 Claude Max/Team/Enterprise 订阅

安装方式

npm（推荐）

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

验证安装

claude --version

首次使用

# 进入项目目录
cd your-project

# 启动 Claude Code
claude

# 首次运行会提示登录或输入 API Key

认证方式

API Key

# 设置环境变量
export ANTHROPIC_API_KEY="sk-ant-..."

# 或在首次运行时交互式输入
claude

OAuth 登录

如果你有 Claude Max、Team 或 Enterprise 订阅：

claude
# 首次运行时选择 OAuth 登录，会打开浏览器授权

更新

# 更新到最新版本
npm update -g @anthropic-ai/claude-code

# 检查当前版本
claude --version

代理设置

如果你在代理网络环境下：

# HTTP 代理
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

# 然后正常使用
claude

常见问题

权限不足

# macOS/Linux：使用 sudo 或修复 npm 权限
sudo npm install -g @anthropic-ai/claude-code

# 或更好的方式：修复 npm 全局目录权限
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Node.js 版本过低

# 使用 nvm 安装最新 Node.js
nvm install 20
nvm use 20

Windows 用户注意

Claude Code 在 Windows 上原生支持 Git Bash。确保：

# 检查 Git Bash 是否可用
where git-bash

# 推荐通过 Git for Windows 安装
# https://git-scm.com/download/win

安装与更新

On this page