1.2 硬件与环境最低要求

Claude Code 作为终端级 AI 助手，对硬件要求相对亲民，但处理大型代码库时仍需预留足够资源。

硬件配置

最低配置（可流畅运行基础对话与小型项目）：

• CPU：64 位双核处理器，2.0 GHz 及以上（ARM 或 x86_64 均可）
• 内存：4 GB RAM（实际占用约 200-500 MB，但需预留系统余量）
• 磁盘空间：安装包约 100-200 MB，建议预留 2 GB 以上用于项目文件与缓存
• 显示器：标准终端即可，无图形界面要求

推荐配置（处理大型项目或多文件批量操作）：

• 内存：8 GB 及以上（分析大型代码库时，Claude Code 需读取并缓存多个文件内容）
• SSD 存储：加快项目索引与文件读写速度，特别是处理 node_modules 等庞大目录时

网络环境

• 必需：稳定的互联网连接（Claude Code 需实时调用 Anthropic API）
• 带宽：建议下行 2 Mbps 以上，主要用于传输代码上下文与模型响应
• 延迟：国内用户建议配置网络代理，否则可能出现响应延迟或连接超时

软件依赖（安装前必须准备）

1. Node.js：版本 18.x 或 20.x LTS（运行 node -v 检查，不支持 16.x 及以下）
2. Git：版本 2.30 以上（用于项目版本控制集成，运行 git --version 检查）
3. 终端环境：

• macOS/Linux：Bash 5.0+ 或 Zsh 5.8+
• Windows：WSL2 内 Ubuntu/Debian（见 1.1 节）

账号与权限

• Anthropic 账号：需提前注册并开通 API 访问权限
• API 额度：确保账户有可用额度（新用户有免费试用额度，之后需绑定付费方式）
• 终端权限：安装时需要写入 /usr/local/bin 或用户目录的权限，企业电脑可能需要管理员授权

实用检查清单

安装前在终端运行以下命令验证环境：

node -v    # 应显示 v18.x.x 或 v20.x.x
git --version    # 应显示 2.30+
curl --version   # 用于下载安装脚本
echo $SHELL      # 确认使用 bash/zsh/fish 等支持的 shell

注意：如果你主要在包含上万文件的大型单体仓库（Monorepo）中工作，建议将内存升级至 16 GB，并配合 .claudeignore 文件排除无关目录（如 node_modules、build），避免上下文过载。