检查系统要求

  • 操作系统:macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或通过 WSL 使用 Windows
  • 硬件:最低 4GB RAM
  • 软件
    • Node.js 18+
    • git 2.23+ (可选)
    • GitHubGitLab CLI 用于 PR 工作流 (可选)
    • ripgrep (rg) 用于增强文件搜索 (可选)
  • 网络:需要互联网连接进行认证和 AI 处理
  • 地区:仅在支持的国家可用

WSL 安装故障排除

目前,Claude Code 不能直接在 Windows 上运行,而是需要 WSL。如果您在 WSL 中遇到问题:

  1. 操作系统/平台检测问题:如果您在安装过程中收到错误,WSL 可能正在使用 Windows 的 npm。尝试:

    • 在安装前运行 npm config set os linux
    • 使用 npm install -g @anthropic-ai/claude-code --force --no-os-check 安装(不要使用 sudo
  2. 找不到 Node 错误:如果在运行 claude 时看到 exec: node: not found,您的 WSL 环境可能正在使用 Windows 安装的 Node.js。您可以通过 which npmwhich node 确认这一点,它们应该指向以 /usr/ 开头的 Linux 路径,而不是 /mnt/c/。要解决此问题,请尝试通过 Linux 发行版的包管理器或通过 nvm 安装 Node。

安装和认证

1

安装 Claude Code

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

导航到您的项目

cd your-project-directory 
3

启动 Claude Code

claude
4

完成认证

Claude Code 提供多种认证选项:

  1. Anthropic 控制台:默认选项。通过 Anthropic 控制台连接并完成 OAuth 流程。需要在 console.anthropic.com 有活跃的计费账户。
  2. Claude 应用(带 Pro 或 Max 计划):订阅 Claude 的 Pro 或 Max 计划,获得包含 Claude Code 和网页界面的统一订阅。以相同的价格获得更多价值,同时在一个地方管理您的账户。使用您的 Claude.ai 账户登录。在启动期间,选择与您的订阅类型匹配的选项。
  3. 企业平台:配置 Claude Code 使用 Amazon Bedrock 或 Google Vertex AI 进行企业部署,利用您现有的云基础设施。

初始化您的项目

对于首次使用的用户,我们建议:

1

启动 Claude Code

claude
2

运行一个简单的命令

summarize this project
3

生成 CLAUDE.md 项目指南

/init 
4

提交生成的 CLAUDE.md 文件

请 Claude 将生成的 CLAUDE.md 文件提交到您的仓库。