设置 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+
- 网络: 需要互联网连接进行认证和 AI 处理
- Shell: 在 Bash、Zsh 或 Fish 中效果最佳
- 位置: Anthropic 支持的国家
标准安装
To install Claude Code, run the following command:
请勿使用 sudo npm install -g
,因为这可能导致权限问题和安全风险。
如果遇到权限错误,请参阅配置 Claude Code获取推荐解决方案。
某些用户可能会自动迁移到改进的安装方法。
安装后运行 claude doctor
检查您的安装类型。
安装过程完成后,导航到您的项目并启动 Claude Code:
Claude Code 提供以下认证选项:
- Anthropic Console: 默认选项。通过 Anthropic Console 连接并完成 OAuth 流程。需要在 console.anthropic.com 激活计费。
- Claude App(Pro 或 Max 计划): 订阅 Claude 的 Pro 或 Max 计划,获得包含 Claude Code 和 Web 界面的统一订阅。以相同价格获得更多价值,同时在一个地方管理您的账户。使用您的 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
的路径:
替代安装方法
Claude Code 提供多种安装方法以适应不同环境。
如果在安装过程中遇到任何问题,请查阅故障排除指南。
安装后运行 claude doctor
检查您的安装类型和版本。
全局 npm 安装
上述安装步骤中显示的传统方法
原生二进制安装(Beta)
如果您已有 Claude Code 安装,请使用 claude install
开始原生二进制安装。
对于全新安装,运行以下命令:
macOS、Linux、WSL:
Windows PowerShell:
原生 Claude Code 安装程序支持 macOS、Linux 和 Windows。
确保删除任何过时的别名或符号链接。
安装完成后,运行 claude doctor
验证安装。
本地安装
- 通过 npm 全局安装后,使用
claude migrate-installer
迁移到本地 - 避免自动更新程序的 npm 权限问题
- 某些用户可能会自动迁移到此方法
在 AWS 或 GCP 上运行
默认情况下,Claude Code 使用 Anthropic 的 API。
有关在 AWS 或 GCP 上运行 Claude Code 的详细信息,请参阅第三方集成。
更新 Claude Code
自动更新
Claude Code 自动保持最新状态,确保您拥有最新功能和安全修复。
- 更新检查: 在启动时和运行期间定期执行
- 更新过程: 在后台自动下载和安装
- 通知: 安装更新时您会看到通知
- 应用更新: 更新在下次启动 Claude Code 时生效
禁用自动更新: