Claude Code 目前支持以下操作系统平台,建议优先使用 macOS 或 Linux 以获得最佳体验。
macOS
- 支持版本:macOS 12 (Monterey) 及以上版本,推荐 macOS 14 (Sonoma) 或更高
- 芯片架构:同时支持 Intel 芯片和 Apple Silicon (M1/M2/M3)
- 注意事项:系统需安装 Command Line Tools (
xcode-select --install),这是运行终端命令的基础依赖
Linux
- 支持发行版:Ubuntu 20.04/22.04/24.04、Debian 11/12、Fedora 38+、CentOS Stream 9 等主流发行版
- 内核要求:建议内核版本 5.10 以上,确保容器和进程管理功能正常
- 必需组件:需预装
curl、git和nodejs(18.x 或 20.x 版本)
Windows
- 支持方式:仅通过 WSL2 (Windows Subsystem for Linux) 运行,不支持原生 Windows 命令行
- 系统要求:Windows 10 版本 2004 及以上(内部版本 19041+),或 Windows 11
- WSL2 发行版:建议在 WSL2 中安装 Ubuntu 22.04 或 Debian 12
- 重要提示:请勿在 PowerShell 或 CMD 中直接安装,必须先在 WSL2 Linux 环境中操作
不支持的系统
- 原生 Windows (不含 WSL2)
- iOS / Android 移动端
- 轻量级容器环境(如 Alpine Linux 需额外配置 glibc)
建议:如果你使用 Windows,请确保 WSL2 已正确配置并能正常访问 Windows 文件系统(通过 /mnt/c/ 等路径),这将影响后续项目目录的访问权限。