跳转到主要内容

​
系统要求

  • 操作系统：macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或 Windows 10+（带 WSL 1、WSL 2 或 Git for Windows）
  • 硬件：4GB+ RAM
  • 软件：Node.js 18+（仅 NPM 安装需要）
  • 网络：认证和 AI 处理需要互联网连接
  • Shell：在 Bash、Zsh 或 Fish 中效果最佳
  • 位置：Anthropic 支持的国家/地区

​
其他依赖项

  • ripgrep：通常包含在 Claude Code 中。如果搜索功能失败，请参阅搜索故障排除。

​
标准安装

To install Claude Code, use one of the following methods:
某些用户可能会自动迁移到改进的安装方法。
安装过程完成后，导航到您的项目并启动 Claude Code： 
cd your-awesome-project
claude
Claude Code 提供以下认证选项：
  1. Claude Console：默认选项。通过 Claude Console 连接并完成 OAuth 过程。需要在 console.anthropic.com 处有活跃的账单。将自动为使用跟踪和成本管理创建”Claude Code”工作区。请注意，您无法为 Claude Code 工作区创建 API 密钥 - 它专门用于 Claude Code 使用。
  2. Claude App（Pro 或 Max 计划）：订阅 Claude 的 Pro 或 Max 计划，获得包括 Claude Code 和网络界面的统一订阅。以相同价格获得更多价值，同时在一个地方管理您的账户。使用您的 Claude.ai 账户登录。在启动期间，选择与您的订阅类型匹配的选项。
  3. 企业平台：配置 Claude Code 以使用 Amazon Bedrock 或 Google Vertex AI 进行企业部署，使用您现有的云基础设施。
Claude Code 安全地存储您的凭据。有关详细信息，请参阅凭据管理。

​
Windows 设置

选项 1：WSL 中的 Claude Code
  • 支持 WSL 1 和 WSL 2
选项 2：使用 Git Bash 在原生 Windows 上的 Claude Code
  • 需要 Git for Windows
  • 对于便携式 Git 安装，指定您的 bash.exe 的路径： 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

​
替代安装方法

Claude Code 提供多种安装方法以适应不同的环境。 如果您在安装过程中遇到任何问题，请查阅故障排除指南。
安装后运行 claude doctor 以检查您的安装类型和版本。

​
原生安装选项

原生安装是推荐的方法，并提供多个优势：
  • 一个自包含的可执行文件
  • 无 Node.js 依赖
  • 改进的自动更新程序稳定性
如果您已有 Claude Code 的现有安装，请使用 claude install 迁移到原生二进制安装。 对于原生安装程序的高级安装选项： macOS、Linux、WSL： 
# 安装稳定版本（默认）
curl -fsSL https://claude.ai/install.sh | bash

# 安装最新版本
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 安装特定版本号
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
Alpine Linux 和其他 musl/uClibc 基础发行版：原生构建需要您安装 libgcc、libstdc++ 和 ripgrep。安装（Alpine：apk add libgcc libstdc++ ripgrep）并设置 USE_BUILTIN_RIPGREP=0。
通过 Homebrew 安装的 Claude Code 将在 brew 目录外自动更新，除非使用 DISABLE_AUTOUPDATER 环境变量明确禁用（请参阅自动更新部分）。
Windows PowerShell： 
# 安装稳定版本（默认）
irm https://claude.ai/install.ps1 | iex

# 安装最新版本
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# 安装特定版本号
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
Windows CMD： 
REM 安装稳定版本（默认）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM 安装最新版本
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM 安装特定版本号
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
确保在安装前删除任何过时的别名或符号链接。

​
NPM 安装

对于首选或需要 NPM 的环境： 
npm install -g @anthropic-ai/claude-code
不要使用 sudo npm install -g，因为这可能导致权限问题和安全风险。 如果您遇到权限错误，请参阅配置 Claude Code 以获取推荐的解决方案。

​
本地安装

  • 通过 npm 全局安装后，使用 claude migrate-installer 移动到本地
  • 避免自动更新程序 npm 权限问题
  • 某些用户可能会自动迁移到此方法

​
在 AWS 或 GCP 上运行

默认情况下，Claude Code 使用 Claude API。 有关在 AWS 或 GCP 上运行 Claude Code 的详细信息，请参阅第三方集成。

​
更新 Claude Code

​
自动更新

Claude Code 自动保持自身最新状态，以确保您拥有最新的功能和安全修复。
  • 更新检查：在启动时和运行时定期执行
  • 更新过程：在后台自动下载和安装
  • 通知：安装更新时您会看到通知
  • 应用更新：更新在您下次启动 Claude Code 时生效
禁用自动更新： 在您的 shell 或 settings.json 文件中设置 DISABLE_AUTOUPDATER 环境变量： 
export DISABLE_AUTOUPDATER=1

​
手动更新

claude update