设置 Claude Code

在您的开发机器上安装、认证和开始使用 Claude Code。

系统要求

操作系统：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 中。如果搜索功能失败，请安装 ripgrep。

标准安装

原生安装（推荐）

Homebrew (macOS, Linux):

brew install --cask claude-code

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

NPM 安装

如果您有 Node.js 18 或更新版本：

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

某些用户可能会自动迁移到改进的安装方法。

安装过程完成后，导航到您的项目并启动 Claude Code：

cd your-awesome-project
claude

认证选项

Claude Code 提供以下认证选项：

Claude Console：默认选项。通过 Claude Console 连接并完成 OAuth 过程。需要在 console.anthropic.com 处有活跃的账单。将自动为使用跟踪和成本管理创建”Claude Code”工作区。
Claude App（Pro 或 Max 计划）：订阅 Claude 的 Pro 或 Max 计划，获得包括 Claude Code 和网络界面的统一订阅。使用您的 Claude.ai 账户登录。
企业平台：配置 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 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`。

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`，因为这可能导致权限问题和安全风险。如果您遇到权限错误，请参阅推荐的解决方案。

本地安装

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

在 AWS 或 GCP 上运行

默认情况下，Claude Code 使用 Claude API。

有关在 AWS 或 GCP 上运行 Claude Code 的详细信息，请参阅第三方集成文档。

更新 Claude Code

自动更新

Claude Code 自动保持自身最新状态，以确保您拥有最新的功能和安全修复。

更新检查：在启动时和运行时定期执行
更新过程：在后台自动下载和安装
通知：安装更新时您会看到通知
应用更新：更新在您下次启动 Claude Code 时生效

禁用自动更新：

在您的 shell 中设置 DISABLE_AUTOUPDATER 环境变量：

export DISABLE_AUTOUPDATER=1

手动更新

claude update

技术支持

安装过程中如遇问题：

联系客服微信：iweico

相关文章